# 插件调用 API 的限制

插件可以调用的 API 与小程序不同,主要有两个区别:

  • 插件的请求域名列表与小程序相互独立;
  • 一些 API 不允许插件调用(这些函数不存在于 qq 对象下)。

有些接口虽然在插件中不能使用,但可以通过插件功能页来达到目的,请参考插件功能页

目前,允许插件调用的 API 及其对应版本要求如下:

# 发起请求

API 最低版本 备注
qq.request

# 上传、下载

API 最低版本 备注
qq.downloadFile qq.uploadFile

# WebSocket

API 最低版本 备注
qq.connectSocket

# 图片

API 最低版本 备注
qq.previewImage
qq.chooseImage
qq.getImageInfo
qq.saveImageToPhotosAlbum

# 录音

API 最低版本 备注
qq.startRecord
qq.stopRecord

# 实时音视频

API 最低版本 备注
qq.createLivePlayerContext
qq.createLivePusherContext

# 录音管理

API 最低版本 备注
qq.getRecorderManager

# 音频播放控制

API 最低版本 备注
qq.pauseVoice
qq.playVoice
qq.stopVoice

# 音乐播放控制

API 最低版本 备注
qq.onBackgroundAudioPlay
qq.getBackgroundAudioPlayerState
qq.onBackgroundAudioStop
qq.stopBackgroundAudio
qq.onBackgroundAudioPause
qq.seekBackgroundAudio
qq.playBackgroundAudio
qq.pauseBackgroundAudio

# 背景音频播放管理

API 最低版本 备注
qq.getBackgroundAudioManager

# 音频组件控制

API 最低版本 备注
qq.createInnerAudioContext
qq.createAudioContext

# 视频

API 最低版本 备注
qq.chooseVideo
qq.saveVideoToPhotosAlbum

# 视频组件控制

API 最低版本 备注
qq.createVideoContext

# 相机组件控制

API 最低版本 备注
qq.createCameraContext

# 数据缓存

API 最低版本 备注
qq.setStorageSync
qq.getStorage
qq.removeStorageSync
qq.setStorage
qq.getStorageSync
qq.removeStorage

# 获取位置

API 最低版本 备注
qq.getLocation
qq.chooseLocation

# 查看位置

API 最低版本 备注
qq.openLocation

# 地图组件控制

API 最低版本 备注
qq.createMapContext

# 系统信息

API 最低版本 备注
qq.getSystemInfoSync
qq.getSystemInfo

# 屏幕亮度

API 最低版本 备注
qq.setKeepScreenOn
qq.setScreenBrightness
qq.getScreenBrightness

# 用户截屏事件

API 最低版本 备注
qq.onUserCaptureScreen

# 振动

API 最低版本 备注
qq.vibrateLong
qq.vibrateShort

# 手机联系人

API 最低版本 备注
qq.addPhoneContact

# NFC

API 最低版本 备注
qq.sendHCEMessage
qq.stopHCE
qq.onHCEMessage
qq.startHCE
qq.getHCEState

# 网络状态

API 最低版本 备注
qq.onNetworkStatusChange
qq.getNetworkType

# 加速度计

API 最低版本 备注
qq.startAccelerometer
qq.stopAccelerometer
qq.onAccelerometerChange

# 罗盘

API 最低版本 备注
qq.onCompassChange
qq.stopCompass
qq.startCompass

# 拨打电话

API 最低版本 备注
qq.makePhoneCall

# 扫码

API 最低版本 备注
qq.scanCode

# 剪贴板

API 最低版本 备注
qq.setClipboardData
qq.getClipboardData

# 蓝牙

API 最低版本 备注
qq.writeBLECharacteristicValue
qq.startBluetoothDevicesDiscovery
qq.getConnectedBluetoothDevices
qq.notifyBLECharacteristicValueChange
qq.onBluetoothDeviceFound
qq.readBLECharacteristicValue
qq.openBluetoothAdapter
qq.getBLEDeviceCharacteristics
qq.stopBluetoothDevicesDiscovery
qq.onBLEConnectionStateChange
qq.getBluetoothDevices
qq.getBluetoothAdapterState
qq.onBluetoothAdapterStateChange
qq.getBLEDeviceServices
qq.onBLECharacteristicValueChange
qq.createBLEConnection
qq.closeBluetoothAdapter
qq.closeBLEConnection
qq.notifyBLECharacteristicValueChange
qq.onBLEConnectionStateChange

# iBeacon

API 最低版本 备注
qq.getBeacons
qq.startBeaconDiscovery
qq.onBeaconServiceChange
qq.onBeaconUpdate
qq.stopBeaconDiscovery

# 交互反馈

API 最低版本 备注
qq.hideLoading
qq.showActionSheet
qq.showLoading
qq.hideToast
qq.showToast
qq.showModal

# 设置导航条

API 最低版本 备注
qq.showNavigationBarLoading
qq.hideNavigationBarLoading
qq.setNavigationBarColor
qq.setNavigationBarTitle

# 背景

API 最低版本 备注
qq.setBackgroundColor
qq.setBackgroundTextStyle

# QML节点信息

API 最低版本 备注
qq.createSelectorQuery

# QML节点布局相交状态

API 最低版本 备注
qq.createIntersectionObserver

# 导航

API 最低版本 备注
qq.navigateBack
qq.navigateTo
qq.redirectTo
qq.switchTab
qq.reLaunch

# 动画

API 最低版本 备注
qq.createAnimation

# 位置

API 最低版本 备注
qq.pageScrollTo

# 绘图

API 最低版本 备注
qq.canvasPutImageData
qq.canvasToTempFilePath
qq.createCanvasContext
qq.canvasGetImageData

# 下拉刷新

API 最低版本 备注
qq.stopPullDownRefresh
qq.startPullDownRefresh

# 当前账号信息

API 最低版本 备注
qq.getAccountInfoSync

# 转发

API 最低版本 备注
qq.hideShareMenu
qq.getShareInfo
qq.showShareMenu
qq.updateShareMenu

# 登录和获取用户信息

这一组接口仅限在用户信息功能页中获得用户授权之后调用。否则将返回 fail 。详见 用户信息功能页

API 最低版本 备注
qq.login
qq.getUserInfo