分类： 微信小程序开发

wx.getWindowInfo()

基础库 2.20.1 开始支持，低版本需做兼容处理。

微信小程序插件：支持，需要微信小程序基础库版本不低于 2.21.3

微信 Windows 版：支持

微信 Mac 版：支持

微信 鸿蒙 OS 版：支持

功能描述

获取窗口信息

返回值

Object

属性 类型 说明
pixelRatio number 设备像素比
screenWidth number 屏幕宽度，单位px
screenHeight number 屏幕高度，单位px
windowWidth number 可使用窗口宽度，单位px
windowHeight number 可使用窗口高度，单位px
statusBarHeight number 状态栏的高度，单位px
safeArea Object 在竖屏正方向下的安全区域。部分机型没有安全区域概念，也不会返回 safeArea 字段，开发者需自行兼容。
结构属性 类型 说明
left number 安全区域左上角横坐标
right number 安全区域右下角横坐标
top number 安全区域左上角纵坐标
bottom number 安全区域右下角纵坐标
width number 安全区域的宽度，单位逻辑像素
height number 安全区域的高度，单位逻辑像素
screenTop number 窗口上边缘的y值

示例代码

const windowInfo = wx.getWindowInfo()

console.log(windowInfo.pixelRatio)
console.log(windowInfo.screenWidth)
console.log(windowInfo.screenHeight)
console.log(windowInfo.windowWidth)
console.log(windowInfo.windowHeight)
console.log(windowInfo.statusBarHeight)
console.log(windowInfo.safeArea)
console.log(windowInfo.screenTop)

wx.openAppAuthorizeSetting(Object object)

基础库 2.20.1 开始支持，低版本需做兼容处理。

以 Promise 风格 调用：支持

需要页面权限：当前是插件页面时，宿主微信小程序不能调用该接口，反之亦然

微信小程序插件：支持，需要微信小程序基础库版本不低于 2.21.3

微信 鸿蒙 OS 版：支持

限制：仅在点击行为时调用

功能描述

跳转到系统的微信授权管理页面

参数

Object object

属性 类型 默认值 必填 说明
success function 否 接口调用成功的回调函数
fail function 否 接口调用失败的回调函数
complete function 否 接口调用结束的回调函数（调用成功、失败都会执行）

示例代码

wx.openAppAuthorizeSetting({
  success (res) {
    console.log(res)
  }
})

wx.openSystemBluetoothSetting(Object object)

基础库 2.20.1 开始支持，低版本需做兼容处理。

以 Promise 风格 调用：支持

需要页面权限：当前是插件页面时，宿主微信小程序不能调用该接口，反之亦然

微信小程序插件：支持，需要微信小程序基础库版本不低于 2.21.3

微信 鸿蒙 OS 版：支持

限制：仅在点击行为时调用

功能描述

跳转系统蓝牙设置页。仅支持安卓。

参数

Object object

属性 类型 默认值 必填 说明
success function 否 接口调用成功的回调函数
fail function 否 接口调用失败的回调函数
complete function 否 接口调用结束的回调函数（调用成功、失败都会执行）

示例代码

wx.openSystemBluetoothSetting({
  success (res) {
    console.log(res)
  }
})

微信小程序 arrayBufferToBase64

从基础库 2.4.0 开始，本接口停止维护

基础库 1.1.0 开始支持，低版本需做兼容处理。

微信小程序插件：支持

微信 Windows 版：支持

微信 Mac 版：支持

微信 鸿蒙 OS 版：支持

功能描述

将 ArrayBuffer 对象转换成 Base64 字符串

参数

ArrayBuffer arrayBuffer

要转换成 Base64 字符串的 ArrayBuffer 对象

返回值

string

Base64 字符串

示例代码


const arrayBuffer = new Uint8Array([11, 22, 33])
const base64 = wx.arrayBufferToBase64(arrayBuffer)

将 base64 字符串转为 ArrayBuffer

从基础库 2.4.0 开始，本接口停止维护

基础库 1.1.0 开始支持，低版本需做兼容处理。

微信小程序插件：支持

微信 Windows 版：支持

微信 Mac 版：支持

微信 鸿蒙 OS 版：支持

功能描述

将 Base64 字符串转换为 ArrayBuffer 对象

参数

string base64

要转换为 ArrayBuffer 对象的 Base64 字符串

返回值

ArrayBuffer

ArrayBuffer 对象

示例代码


const base64 = 'CxYh'
const arrayBuffer = wx.base64ToArrayBuffer(base64)

wx.canIUse(string schema)

基础库 1.1.1 开始支持，低版本需做兼容处理。

微信小程序插件：不支持

微信 Windows 版：支持

微信 Mac 版：支持

微信 鸿蒙 OS 版：支持

相关文档: 低版本兼容

功能描述

判断微信小程序的API，回调，参数，组件等是否在当前版本可用。

参数

string schema

使用 ${API}.${method}.${param}.${option} 或者 ${component}.${attribute}.${option} 方式来调用

返回值

boolean

当前版本是否可用

参数说明

  • ${API} 代表 API 名字
  • ${method} 代表调用方式，有效值为return, success, object, callback
  • ${param} 代表参数或者返回值
  • ${option} 代表参数的可选值或者返回值的属性
  • ${component} 代表组件名字
  • ${attribute} 代表组件属性
  • ${option} 代表组件属性的可选值

示例代码

// 对象的属性或方法
wx.canIUse('console.log')
wx.canIUse('CameraContext.onCameraFrame')
wx.canIUse('CameraFrameListener.start')
wx.canIUse('Image.src')

// wx接口参数、回调或者返回值
wx.canIUse('openBluetoothAdapter')
wx.canIUse('getSystemInfoSync.return.safeArea.left')
wx.canIUse('getSystemInfo.success.screenWidth')
wx.canIUse('showToast.object.image')
wx.canIUse('onCompassChange.callback.direction')
wx.canIUse('request.object.method.GET')

// 组件的属性
wx.canIUse('live-player')
wx.canIUse('text.selectable')
wx.canIUse('button.open-type.contact')

真机调试

要使用真机调试来调试XR-FRAME，需要按照以下几个步骤：

  1. 确保工具是最新的Nightly版本。
  2. 确定至少存在一个分包，空分包也可以。
  3. 在真机调试界面，左下角切换到真机调试2.0（如下图）。


然后便可以正常使用真机调试。

内置后处理资源

此处列出了微信小程序框架内置支持的后处理资源类型、参数和对应效果。

以下标题名即为后处理资源里的type属性。

blur

高斯模糊，效果好但是在radius较大时性能开销较高，快速近似方法见fastblur。

参数 类型 默认值 说明
radius number 5 模糊半径

示例，radius=64：

fastblur

也是高斯模糊，但是更快速的近似版本。

参数 类型 默认值 说明
radius number 5 模糊半径

时间稳定性高，但效果没有blur好，适用于需要不断变更radius的场景。

bloom

泛光，建议开启is-hdr使用。

参数 类型 默认值 说明
threshold number 0.5 阈值
softThreshold number 0 软阈值
radius number 20 半径
intensity number 2 亮度

示例，radius=64，intensity=2，其他默认：

tone

色调映射，ACES曲线，一般配合hdr使用。

示例：

vignette

渐晕。

参数 类型 默认值 说明
center number[] [0.5,0.5] 半径
color number[] [0,0,0,1] 颜色
intensity number 1 亮度
smoothness number 1 边缘柔化
roundness number 1 圆度
rounded number 0/1 强制为圆形

示例，color=[1,0,0,1]，smoothness=2，其他默认：

fxaa

快速抗锯齿。

示例：