微信小程序开发 – 第 46 页 – 微信小程序开发指南

boolean wx.checkIsPictureInPictureActive()

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

微信小程序插件：不支持

微信鸿蒙 OS 版：支持

功能描述

返回当前是否存在小窗播放（小窗在 video/live-player/live-pusher 下可用）

返回值

boolean

当前是否存在小窗播放

wx.offParallelStateChange(function listener)

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

微信小程序插件：不支持

微信 Windows 版：支持

微信 Mac 版：支持

功能描述

移除微信小程序分栏状态变化事件的监听函数

参数

function listener

onParallelStateChange 传入的监听函数。不传此参数则移除所有监听函数。

示例代码

const listener = function (res) { console.log(res) }

wx.onParallelStateChange(listener)
wx.offParallelStateChange(listener) // 需传入与监听时同一个的函数对象

wx.offWindowResize(function listener)

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

微信小程序插件：不支持

微信 Windows 版：支持

微信 Mac 版：支持

微信鸿蒙 OS 版：支持

功能描述

移除窗口尺寸变化事件的监听函数

参数

function listener

onWindowResize 传入的监听函数。不传此参数则移除所有监听函数。

示例代码

const listener = function (res) { console.log(res) }

wx.onWindowResize(listener)
wx.offWindowResize(listener) // 需传入与监听时同一个的函数对象

wx.offWindowStateChange(function listener)

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

微信小程序插件：不支持

微信 Windows 版：支持

微信 Mac 版：支持

功能描述

移除微信小程序窗口状态变化事件的监听函数

参数

function listener

onWindowStateChange 传入的监听函数。不传此参数则移除所有监听函数。

示例代码

const listener = function (res) { console.log(res) }

wx.onWindowStateChange(listener)
wx.offWindowStateChange(listener) // 需传入与监听时同一个的函数对象

wx.onParallelStateChange(function listener)

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

微信小程序插件：不支持

微信 Windows 版：支持

微信 Mac 版：支持

功能描述

监听微信小程序分栏状态变化事件。仅适用于 PC 平台

参数

function listener

微信小程序分栏状态变化事件的监听函数

参数

Object res

属性	类型	说明
isOnParallel	boolean	当前是否分栏
rightPage	Page	分栏右侧页面对象（非分栏状态时返回当前页面）
leftPage	Page	分栏左侧页面对象（非分栏状态时返回当前页面）

wx.onWindowResize(function listener)

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

微信小程序插件：不支持

微信 Windows 版：支持

微信 Mac 版：支持

微信鸿蒙 OS 版：支持

功能描述

监听窗口尺寸变化事件

参数

function listener

窗口尺寸变化事件的监听函数

参数

Object res

属性

类型

说明

size

Object

	结构属性	类型	说明
	windowWidth	number	变化后的窗口宽度，单位 px
	windowHeight	number	变化后的窗口高度，单位 px

wx.openPhotoTopicView(Object object)

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

以 Promise 风格调用：不支持

微信小程序插件：不支持

功能描述

打开微信官方图片话题发布页。

参数

Object object

属性

类型

默认值

必填

说明

queryString

string

否

附加的查询字符串，必须是 key1=val1&key2=val2 的格式。

extraData

Object

否

传递给目标业务微信小程序的业务参数。

envVersion

string

release

否

要打开的微信小程序版本。

合法值	说明
develop	开发版
trial	体验版
release	正式版

success

function

否

接口调用成功的回调函数

fail

function

否

接口调用失败的回调函数

complete

function

否

接口调用结束的回调函数（调用成功、失败都会执行）

object.success 回调函数

参数

Object res

属性	类型	说明
extraData	Object	图片话题发布页返回的业务数据（结构由微信官方业务约定）

object.fail 回调函数

参数

Object err

属性	类型	说明
errMsg	string	错误信息

示例代码

wx.openPhotoTopicView({
  extraData: {
    // 由目标业务约定的字段
    foo: 'bar',
  },
  success(res) {
    console.log(res)
  },
  fail(err) {
    console.error(err)
  },
})

wx.onWindowStateChange(function listener)

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

微信小程序插件：不支持

微信 Windows 版：支持

微信 Mac 版：支持

功能描述

监听微信小程序窗口状态变化事件。仅适用于 PC 平台

参数

function listener

微信小程序窗口状态变化事件的监听函数

参数

Object res

属性	类型	说明
state	string	改变的窗口状态，可能的值为：

‘minimize’：窗口最小化
‘normalize’：窗口恢复正常尺寸
‘maximize’：窗口最大化 |

wx.setWindowSize(Object object)

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

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

以 Promise 风格调用：不支持

微信小程序插件：不支持

微信 Windows 版：支持

微信 Mac 版：支持

功能描述

设置窗口大小，该接口仅适用于 PC 平台，使用细则请参见指南

参数

Object object

属性	类型	必填	说明
width	number	是	窗口宽度，以像素为单位
height	number	是	窗口高度，以像素为单位
success	function	否	接口调用成功的回调函数
fail	function	否	接口调用失败的回调函数
complete	function	否	接口调用结束的回调函数（调用成功、失败都会执行）

Object wx.getMenuButtonBoundingClientRect()

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

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

微信 Windows 版：支持

微信 Mac 版：支持

微信鸿蒙 OS 版：支持

功能描述

获取菜单按钮（右上角胶囊按钮）的布局位置信息。坐标信息以屏幕左上角为原点。

返回值

Object

菜单按钮的布局位置信息

属性	类型	说明
width	number	宽度，单位：px
height	number	高度，单位：px
top	number	上边界坐标，单位：px
right	number	右边界坐标，单位：px
bottom	number	下边界坐标，单位：px
left	number	左边界坐标，单位：px

示例代码

const res = wx.getMenuButtonBoundingClientRect()

console.log(res.width)
console.log(res.height)
console.log(res.top)
console.log(res.right)
console.log(res.bottom)
console.log(res.left)