2023微信小程序v3.1.0、v3.1.1更新内容

v3.1.1 (2023-09-21)

1、新增 API 小游戏支持 TCP 通信接口 

TCPSocket wx.createTCPSocket()

创建一个 TCP Socket 实例。返回值是一个 TCP Socket 实例

其中需要注意的是：

• 允许与局域网内的非本机 IP 通信

• 允许与配置过的服务器域名通信，详见相关说明

• 禁止与以下端口号连接：1024 以下 1099 1433 1521 1719 1720 1723 2049 2375 3128 3306 3389 3659 4045 5060 5061 5432 5984 6379 6000 6566 7001 7002 8000-8100 8443 8888 9200 9300 10051 10080 11211 27017 27018 27019

• 每 5 分钟内最多创建 20 个 TCPSocket

2、更新 框架 部分 IOS 用户切换网络状态后 request 请求超时

问题描述：当wifi环境能正常打开任意小程序后，再切换到5G/4G，打开此任意包括其它小程序，网络是种无法成功，解决办法：

• 等很久让其失败后，重新进入小程序

• 切换网络模式，比如飞行模式，切换成4G，然后再进入小程序

• 最优的办法，是杀掉“微信”后重新进入就好了

目前已解决

3、更新 框架 XR-FRAME ShareSystem 新增了录屏功能，受限于设备性能，录屏时请选择适当的录制帧率和分辨率

分享系统提供了如下方式来录制：

// 录制配置，以下是默认值
// 这里建议根据实际情况，等比缩放`width`和`height`，防止丢帧
const options: XrFrame.IShareRecordOptions = {
  fps: 30,
  width: scene.width,
  height: scene.height,
  videoBitsPerSecond: 1000
};
// 启动录制
await scene.share.recordStart(options);
// 暂停录制
await scene.share.recordPause(options);
// 唤醒录制
await scene.share.recordResume(options);
// 停止录制，并保存到临时文件
const tempFilePath = await scene.share.recordFinishToTempFile(options);
// 停止录制，直接保存到相册
await scene.share.recordFinishToAlbum(options);
// 可以获取录制状态，来做用户提示
if (scene.share.recordState === xrFrameSystem.EShareRecordState.Recording) {
  ......
}

4、更新 框架 Skyline 部分未支持的组件加个错误提示

5、修复 框架 CameraContext.onCameraFrame callback 的报错应为第三方错误

6、修复 框架 touchmove / longtap 导致节点被删除时， touch 事件内部状态错误

问题复现流程：有一个需求，点击左下角按钮出现一个蒙层，里面有相关的操作。滑动蒙层的时候相当于取消操作，关闭蒙层。因此蒙层绑定了touchmove事件来关闭蒙层。但是touchmove关闭后，点击页面的按钮不生效，必须第二次点击按钮才能生效。开发者工具和真机稳定复现。真机我使用安卓和ios两台均能复现

问题已修复

7、修复 组件 iOS scroll-view 组件开启 refresher 滚动区域多出一块

iOS 只需要加上refresher-enabled 属性 滚动就会超一屏 或者开启refresher-enabled 关闭enhanced 属性 即可恢复正常

问题已修复

v3.1.0 (2023-09-14)

1、更新 框架 优化 worklet function 执行耗时

2、更新 框架 优化 transform scale 动画性能

Skyline 下对节点进行 transform: scale() rotate() 动画时，若子节点内容比较复杂，动画性能可能不佳。为解决该问题，可利用 snapshot 组件改变渲染模式。

<snapshot mode="view">
 <view></view>
</snapshot>

以 view 模式渲染时，snapshot 组件与普通的 view 无差别，对子节点设置样式，变化会体现在界面上。 以 picture 模式渲染时，snapshot 组件会对当下渲染的子节点进行截图，后续子节点被替换为图片进行渲染，此时对子节点设置样式，变化不会体现在界面上。

picture 模式下进行 transform: scale() rotate() 动画时，性能较好。此时通过 setData 等对子节点进行的修改，当再次切换为 view 模式时，界面会立刻改变为最终样式。

通常在对大范围节点进行 scale 或 rotate 动画时，可在动画开始设置为 picture 模式，动画结束设置为 view 模式，以提高动画表现。如子节点内容会发生改变，则不适用该模式切换。

示例代码

  <snapshot id="target">
    <view>content</view>
  </snapshot>

Page({
  onReady() {
    this.createSelectorQuery()
      .select("#target")
      .node()
      .exec(res => {
        const node = res[0].node
        node.takeSnapshot({
          type: 'arraybuffer',
          format: 'png',
          success: (res) => {},
          fail(res) {}
        })
  }
})

3、更新 框架 支持 SelectorQuery scrollOffset

添加节点的滚动位置查询请求。以像素为单位。节点必须是 scroll-view 或者 viewport，返回 NodesRef 对应的 SelectorQuery

参数如下：

function callback

回调函数，在执行 SelectorQuery.exec 方法后，节点信息会在 callback 中返回

示例代码

Page({
  getScrollOffset () {
    wx.createSelectorQuery().selectViewport().scrollOffset(function(res){
      res.id      // 节点的ID
      res.dataset // 节点的dataset
      res.scrollLeft // 节点的水平滚动位置
      res.scrollTop  // 节点的竖直滚动位置
    }).exec()
  }
})

4、更新 框架 支持 scroll-into-view-offset

跳转到 scroll-into-view 目标节点时的额外偏移

5、更新 框架 基础库预设自定义路由动画

为降低开发成本，基础库预设了一批常见的路由动画效果

使用方法

仅需在路由跳转时，指定对应的 routeType。

注: 以上路由效果均可通过自定义路由实现，可参考示例代码中的源码文件，自定义所需效果。

wx.navigateTo({
  url: 'xxx',
  routeType: 'wx://modal'
})

6、更新 框架 支持页面配置 rendererOptions

app.json 中的部分配置，也支持对单个页面进行配置，可以在页面对应的 .json 文件来对本页面的表现进行配置。

页面中配置项在当前页面会覆盖 app.json 中相同的配置项（样式相关的配置项属于 app.json 中的 window 属性，但这里不需要额外指定 window 字段），具体的取值和含义可参考全局配置文档中说明。

文件内容为一个 JSON 对象，其中包括rendererOptions，渲染后端选项

7、更新 组件 map 组件新增 polylinetap 事件

bindpolylinetap表示点击地图路线时触发。

8、更新 组件 map 组件新增 moveAlong() 动画插值 interpolatepoint 事件

bindinterpolatepoint，MapContext.moveAlong 插值动画时触发。e.detail = {markerId, longitude, latitude, animationStatus: "interpolating" | "complete"},

9、更新 API CameraContext的takePhoto方法支持返回原图

属性值original返回原图

10、更新 API 优化异步分包组件数量较多时容易引起下载失败的问题

11、修复 组件 skyline switch checkbox 组件选中后 icon 没有居中