# 插件调用 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`

← 使用插件插件使用组件的限制 →