发起网络请求,同微信wx.request
将本地资源上传到开发者服务器,同微信wx.uploadFile
下载文件资源到本地,客户端直接发起一个 HTTP GET 请求,返回文件的本地临时路径,同微信wx.downloadFile
创建一个 WebSocket 连接,同微信wx.connectSocket
监听WebSocket连接打开事件,同微信wx.onSocketOpen
监听WebSocket错误,同微信wx.onSocketError
通过 WebSocket 连接发送数据,需要先 wx.connectSocket,并在 wx.onSocketOpen 回调之后才能发送,同微信wx.sendSocketMessage
监听WebSocket接受到服务器的消息事件。微信wx.onSocketMessage
关闭 WebSocket 连接。微信wx.closeSocket
监听WebSocket关闭。微信wx.onSocketClose
从本地相册选择图片或使用相机拍照。微信wx.chooseImage
预览图片。微信wx.previewImage
获取图片信息,微信wx.getImageInfo
保存图片到系统相册,微信wx.saveImageToPhotosAlbum
压缩图片接口,可选压缩质量,微信wx.compressImage
从客户端会话选择文件,微信wx.chooseMessageFile
开始录音。微信wx.startRecord
主动调用停止录音。微信wx.stopRecord
建议使用能力更强的 wx.createInnerAudioContext 接口
建议使用能力更强的 wx.createInnerAudioContext 接口
建议使用能力更强的 wx.createInnerAudioContext 接口
建议使用能力更强的 wx.createInnerAudioContext 接口
虽然支持了本套API,但是与BackgroundAudioManager共用一个音乐播放器,所以同BackgroundAudioManager播放效果,单个小程序只能有一个后台音乐在播放。
获得音乐相关信息,建议使用能力更强的 wx.BackgroundAudioManager 接口
播放音乐,参数同微信。与微信不同的是,在微信中,两次参数相同的调用,第二次会使音乐从头开始播放。而QB中则是从上次播放到的位置开始。
同微信,建议使用能力更强的 wx.BackgroundAudioManager 接口
同微信,建议使用能力更强的 wx.BackgroundAudioManager 接口
同微信,建议使用能力更强的 wx.BackgroundAudioManager 接口
同微信,建议使用能力更强的 wx.BackgroundAudioManager 接口
同微信,建议使用能力更强的 wx.BackgroundAudioManager 接口
同微信,建议使用能力更强的 wx.BackgroundAudioManager 接口
获取 小程序 内唯一的背景音频管理器 backgroundAudioManager。即单个小程序只可能存在一个背景音乐。
backgroundAudioManager
backgroundAudioManager 对象的属性列表:
属性 | 类型 | 说明 | 只读 |
---|---|---|---|
src | String | 音频的数据源,默认为空字符串,当设置了新的 src 时,会自动开始播放 ,目前支持的格式包括但不限于 m4a, aac, mp3, wav | 否 |
title | String | 音频标题,在QQ浏览器中有此属性但不会在内置播放器展示给用户,需要小程序自己在界面中展示。 | 否 |
epname | String | 专辑名,在QQ浏览器中有此属性但不会在内置播放器展示给用户,需要小程序自己在界面中展示。 | 否 |
singer | String | 歌手名,在QQ浏览器中有此属性但不会在内置播放器展示给用户,需要小程序自己在界面中展示。 | 否 |
coverImgUrl | String | 封面图url,在QQ浏览器中有此属性但不会在内置播放器展示给用户,需要小程序自己在界面中展示 | 否 |
webUrl | String | 页面链接,在QQ浏览器中有此属性但不会在内置播放器展示给用户,需要小程序自己在界面中展示。 | 否 |
protocol | 无效属性 | 无效属性 | 否 |
其它 | 同微信 | 同微信 | 否 |
backgroundAudioManager 对象的方法列表:同微信,且不存在onPrev,onNext
errCode 不保证与微信完全一致
微信wx.getBackgroundAudioManager
innerAudioContext
innerAudioContext 对象的属性列表:
属性 | 类型 | 说明 | 只读 |
---|---|---|---|
src | String | 音频的数据链接,用于直接播放。每个实例只能stop之后才能进行重新设置,否则设置无效 | 否 |
obeyMuteSwitch | Boolean | 无效 经查微信Android版本也是无效 | 否 |
currentTime | Number | 当前音频的播放位置(单位:s),只有在当前有合法的 src 时返回,时间不取整,保留小数点后 3 位 | 是 |
其它 | 同微信 | 同微信 | 同微信 |
innerAudioContext 对象的方法列表:
方法 | 参数 | 说明 |
---|---|---|
play/pause/stop | 无 | 同微信的作用 |
seek | position | 跳转到指定位置,单位 s。精确到小数点后 3 位,即支持 ms 级别精确度 |
destroy | 无 | 销毁当前实例 |
onWaiting | callback | 音频加载中事件(建议在onTimeUpdate里监听音乐是否正在流畅播放) |
其它on系列方法 | callback | 同微信作用,监听一系列事件 |
off系列方法 | 无 | 同微信作用,取消监听 |
errCode 不保证与微信完全一致
微信wx.createAudioContext
创建 camera 上下文 CameraContext 对象。微信wx.createCameraContext
获取 Camera 实时帧数据。微信CameraContext.onCameraFrame
开始录像。微信CameraContext.startRecord
停止录像。微信CameraContext.stopRecord
拍摄照片。微信CameraContext.takePhoto
开始监听帧数据。微信CameraFrameListener.start
停止监听帧数据。微信CameraFrameListener.stop
同微信,拍摄视频或从手机相册中选视频,返回视频的临时文件路径。微信wx.chooseVideo
保存视频到系统相册,同微信wx.saveVideoToPhotosAlbum
创建 video 上下文 VideoContext 对象,同微信wx.createVideoContext
退出全屏,同微信VideoContext.exitFullScreen
隐藏状态栏,仅在iOS全屏下有效,同微信VideoContext.hideStatusBar
暂停视频,同微信VideoContext.pause
播放视频,同微信VideoContext.play
设置倍速播放,同微信VideoContext.playbackRate
进入全屏,同微信VideoContext.requestFullScreen
跳转到指定位置,同微信VideoContext.seek
发送弹幕,同微信VideoContext.sendDanmu
显示状态栏,仅在iOS全屏下有效,同微信VideoContext.showStatusBar
停止播放,同微信VideoContext.stop
保存文件到本地,同微信wx.saveFile
获取文件信息,同微信wx.getFileInfo
获取本地已经保存的文件列表,同微信wx.getSavedFileList
取本地文件的文件信息。此接口只能用于获取已保存到本地的文件,若需要获取临时文件信息,请使用 wx.getFileInfo 接口。
同微信wx.getSavedFileInfo
删除本地存储的文件。同微信wx.removeSavedFile
新开页面打开文档,支持格式:doc, xls, ppt, pdf, docx, xlsx, pptx,同微信wx.openDocument
将数据存储在本地缓存中指定的 key 中,会覆盖掉原来该 key 对应的内容,这是一个异步接口。同微信wx.setStorage
将 data 存储在本地缓存中指定的 key 中,会覆盖掉原来该 key 对应的内容,这是一个同步接口。同微信wx.setStorageSync
从本地缓存中异步获取指定 key 对应的内容。同微信wx.getStorage
从本地缓存中同步获取指定 key 对应的内容。同微信wx.getStorageSync
异步获取当前storage的相关信息。同微信wx.getStorageInfo
同步获取当前storage的相关信息。同微信wx.getStorageInfoSync
从本地缓存中异步移除指定 key。同微信wx.removeStorage
从本地缓存中同步移除指定 key。同微信wx.removeStorageSync
清理本地数据缓存。同微信wx.clearStorage
同步清理本地数据缓存。同微信wx.clearStorageSync
设置自定义登录态,在周期性拉取数据时带上,便于第三方服务器验证请求合法性
收到 backgroundFetch 数据时的回调
获取设置过的自定义登录态。若无,则返回 fail
拉取 backgroundFetch 客户端缓存数据
获取位置,同微信wx.getLocation
获取位置,同微信wx.chooseLocation
使用QQ浏览器内置地图查看位置,效果同微信wx.openLocation
创建并返回 map 上下文 mapContext 对象。同微信wx.createMapContext
关闭监听实时位置变化,前后台都停止消息接收。同微信wx.stopLocationUpdate
开启小程序进入前后台时均接收位置消息,需引导用户开启授权。授权以后,小程序在运行中或进入后台均可接受位置消息变化。同微信wx.startLocationUpdateBackground
开启小程序进入前台时接收位置消息。同微信wx.startLocationUpdate
监听实时地理位置变化事件,需结合 wx.startLocationUpdateBackground、wx.startLocationUpdate使用。同微信wx.onLocationChange
取消监听实时地理位置变化事件。同微信wx.offLocationChange
获取系统信息。同微信wx.getSystemInfo
额外字段:environment,取值有以下三个 (之前运行环境是通过isQB和isOnReading来判断,后面会逐步废弃这两个接口,建议开发者使用environment来判断小程序环境)
QB:标识当前小程序运行在QQ浏览器中
KB:标识当前小程序运行在快报中
Unknown:标识当前小程序的运行环境未知
获取系统信息同步接口。同微信wx.getSystemInfoSync
判断小程序的API,回调,参数,组件等是否在当前版本可用。同微信wx.canIUse
获取网络类型。同微信wx.getNetworkType
监听网络状态变化。同微信wx.onNetworkStatusChange
监听加速度数据。同微信wx.onAccelerometerChange
开始监听加速度数据。同微信wx.startAccelerometer
停止监听加速度数据。同微信wx.stopAccelerometer
监听罗盘数据。同微信wx.onCompassChange
开始监听罗盘数据。同微信wx.startCompass
停止监听罗盘数据。同微信wx.stopCompass
设置系统剪贴板的内容。同微信wx.setClipboardData
获取系统剪贴板内容。同微信wx.getClipboardData
wx.getBatteryInfoSync 的同步版本。同微信wx.getBatteryInfoSync
获取设备电量。同步 API wx.getBatteryInfoSync 在 iOS 上不可用。同微信wx.getBatteryInfo
设置屏幕亮度。效果同微信wx.setScreenBrightness
获取屏幕亮度。效果同微信wx.getScreenBrightness
设置是否保持常亮状态。同微信wx.setKeepScreenOn
使手机发生较长时间的振动(400ms),同微信wx.vibrateLong
使手机发生较短时间的振动(15ms),同微信wx.vibrateShort
显示消息提示框,注意title不要超过7个汉字,其它同微信wx.showToast
显示 loading 提示框, 需主动调用 wx.hideLoading 才能关闭提示框,注意title不要超过7个汉字,其它同微信wx.showLoading
隐藏消息提示框
隐藏 loading 提示框
wx.showLoading({
title: '加载中',
})
setTimeout(function(){
wx.hideLoading()
},2000)
显示模态弹窗,同微信wx.showModal
显示操作菜单,同微信wx.showActionSheet
动态设置当前页面的标题,同微信wx.setNavigationBarTitle
在当前页面显示导航条加载动画。
隐藏导航条加载动画。
显示 tabBar,同微信wx.showTabBar
隐藏 tabBar,同微信wx.hideTabBar
跳转到 tabBar 页面,并关闭其他所有非 tabBar 页面,同微信wx.switchTab
关闭当前页面,返回上一页面或多级页面,同微信wx.navigateBack
关闭所有页面,打开到应用内的某个页面,同微信wx.reLaunch
页面间事件通信通道,同微信EventChannel
创建一个动画实例animation。调用实例的方法来描述动画,同微信wx.createAnimation
将页面滚动到目标位置。同微信wx.pageScrollTo
该系列接口同微信绘图
返回一个SelectorQuery对象实例。同微信wx.createSelectorQuery
将选择器的选取范围更改为自定义组件component内。同微信selectorQuery.in
在当前页面下选择第一个匹配选择器selector的节点,返回一个NodesRef对象实例,可以用于获取节点信息。同微信selectorQuery.select
在当前页面下选择匹配选择器selector的节点,返回一个NodesRef对象实例。 与selectorQuery.select(selector)不同的是,它选择所有匹配选择器的节点。
选择显示区域,可用于获取显示区域的尺寸、滚动位置等信息,返回一个NodesRef对象实例。
添加节点的布局位置的查询请求,相对于显示区域,以像素为单位。其功能类似于DOM的getBoundingClientRect。返回值是nodesRef对应的selectorQuery。
添加节点的滚动位置查询请求,以像素为单位。节点必须是scroll-view或者viewport。返回值是nodesRef对应的selectorQuery。
获取节点的相关信息,需要获取的字段在fields中指定。返回值是nodesRef对应的selectorQuery。
执行所有的请求,请求结果按请求次序构成数组,在callback的第一个参数中返回。
QB小程序登录与微信小程序登录不完全一致且登录态不互通,详情见文档QQ浏览器小程序登录适配指引
提前向用户发起授权请求。同微信wx.authorize
wx.getUserInfo的返回值
{
userInfo:
{
nickName: 昵称,
avatarUrl: 头像,
gender: 性别,
Province: 省份,
city: 城市,
country: 国家
}
}
发起支付。
QB小程序的支付和微信小程序不完全一样,QB下支持web支付,包括H5支付和WAP支付。
其中H5支付对应接口为requestPayment,WAP支付对应接口为requestPaymentWap。其中WAP支付已经被微信逐渐放弃,基于安全和适配工作量考虑,不建议使用WAP支付。
详情见文档QQ浏览器小程序适配
在 Page 中定义 onShareAppMessage 函数,设置该页面的转发信息。
调起客户端小程序设置界面,返回用户设置的操作结果。同微信wx.openSetting
获取用户的当前设置。同微信wx.getSetting
QB小程序提供拉起APP能力,但是该能力目前不支持小程序直接通过api调用,需要用户点击小程序右上角菜单中的按钮方可拉起app,具体页面路径通过小程序回调返回。
详情见文档QQ浏览器小程序适配
wx.qbShare 调起QB的分享面板
例子:wx.qbShare({
url:xxx
})
wx.qbSaveImage 图片保存
例子:wx.qbSaveImage({
url:xxx
})
wx.qbChooseFile QB文件选择器
例子:wx.qbChooseFile({
count:xxx
maxSize:xxx
})
wx.qbGetUniqueIdSync 获取uid
wx.qbOpenApp 打开第三方应用,没有安装则拉新,拉新渠道连接需要联系QB接口人 后台配置
例子:wx.qbOpenApp({
uri:xxx
})
wx.qbLaunchApp 打开第三方应用,没有安装则拉新,拉新渠道连接需要联系QB接口人 后台配置
例子:wx.qbLaunchApp({
appParameter:xxx
})
wx.msLaunchApp 同qbLaunch 在其他宿主app只接口通用
例子:wx.msLaunchApp({
uri:xxx
})
wx.msInvokeWebAPI 接入qb小程序组件自定义的接口
例子:wx.msInvokeWebAPI({
event:xxx
params:xxx
})
wx.isAppInstalled 检查APP是否已经安装
微信强相关的API都不支持