# API 总览
# 1. 基础
名称 | 功能说明 | 版本 | 备注 |
---|---|---|---|
ft.env | 环境变量 | 1.0.0 | |
ft.canIUse | 判断小程序的API,回调,参数,组件等是否在当前版本可用 | 1.0.0 | |
ft.base64ToArrayBuffer | 将 Base64 字符串转成 ArrayBuffer 对象 | 1.0.0 | |
ft.arrayBufferToBase64 | 将 ArrayBuffer 对象转成 Base64 字符串 | 1.0.0 | |
ft.base64ToTempFilePath | 将图片的base64数据保存到本地沙盒,并返回本地缓存路径 | 1.0.0 | |
ft.fileToBase64 | 将文件转换为 Base64 字符串 | 1.0.0 |
# 1.1 系统
名称 | 功能说明 | 版本 | 备注 |
---|---|---|---|
ft.getSystemInfoSync | ft.getSystemInfo 的同步版本 | 1.0.0 | |
ft.getSystemInfoAsync | 异步获取系统信息 | 1.0.0 | |
ft.getSystemInfo | 获取系统信息 | 1.0.0 |
请注意
以下 API 暂不支持
名称 | 功能说明 |
---|---|
ft.openAppAuthorizeSetting | 跳转系统微信授权管理页 |
ft.openSystemBluetoothSetting | 跳转系统蓝牙设置页 |
ft.getWindowInfo | 获取窗口信息 |
ft.getSystemSetting | 获取设备设置 |
ft.getSkylineInfoSync | ft.getSkylineInfo 的同步版本 |
ft.getSkylineInfo | 获取当前运行环境对于 Skyline 渲染引擎 的支持情况 |
ft.getDeviceInfo | 获取设备基础信息 |
# 1.2 更新
名称 | 功能说明 | 版本 | 备注 |
---|---|---|---|
ft.getUpdateManager | 获取全局唯一的版本更新管理器,用于管理小程序更新 | 1.0.0 |
请注意
以下 API 暂不支持
名称 | 功能说明 |
---|---|
ft.updateWeChatApp | 更新客户端版本 |
# 1.2.1 UpdateManager
名称 | 功能说明 | 版本 | 备注 |
---|---|---|---|
UpdateManager.applyUpdate | 强制小程序重启并使用新版本 | 1.0.0 | |
UpdateManager.onCheckForUpdate | 监听向微信后台请求检查更新结果事件 | 1.0.0 | |
UpdateManager.onUpdateFailed | 监听小程序更新失败事件 | 1.0.0 | |
UpdateManager.onUpdateReady | 监听小程序有版本更新事件 | 1.0.0 |
# 1.3 小程序
# 1.3.1 生命周期
名称 | 功能说明 | 版本 | 备注 |
---|---|---|---|
ft.getLaunchOptionsSync | 获取小程序启动时的参数 | 1.0.0 | |
ft.getEnterOptionsSync | 获取本次小程序启动时的参数 | 1.0.0 |
# 1.3.2 应用级事件
名称 | 功能说明 | 版本 | 备注 |
---|---|---|---|
ft.onPageNotFound | 监听小程序要打开的页面不存在事件 | 1.0.0 | |
ft.onError | 监听小程序错误事件 | 1.0.0 | |
ft.onAppShow | 监听小程序切前台事件 | 1.0.0 | |
ft.onAppHide | 监听小程序切后台事件 | 1.0.0 | |
ft.offPageNotFound | 取消监听小程序要打开的页面不存在事件 | 1.0.0 | |
ft.offError | 取消监听小程序错误事件 | 1.0.0 | |
ft.offAppShow | 取消监听小程序切前台事件 | 1.0.0 | |
ft.offAppHide | 取消监听小程序切后台事件 | 1.0.0 | |
ft.onThemeChange | 监听系统主题改变事件 | 1.0.0 | |
ft.onUnhandledRejection | 监听未处理的 Promise 拒绝事件 | 1.0.0 | |
ft.offUnhandledRejection | 取消监听未处理的 Promise 拒绝事件 | 1.0.0 | |
ft.offThemeChange | 取消监听系统主题改变事件 | 1.0.0 |
请注意
以下 API 暂不支持
名称 | 功能说明 |
---|---|
ft.onAudioInterruptionEnd | 监听音频中断结束事件 |
ft.onAudioInterruptionBegin | 监听音频因为受到系统占用而被中断开始事件 |
ft.offAudioInterruptionEnd | 取消监听音频中断结束事件 |
ft.offAudioInterruptionBegin | 取消监听音频因为受到系统占用而被中断开始事件 |
ft.onLazyLoadError | 监听应用异步组件加载失败回调 |
ft.offLazyLoadError | 取消监听应用异步组件加载失败回调 |
# 1.4 调试
名称 | 功能说明 | 版本 | 备注 |
---|---|---|---|
ft.setEnableDebug | 设置是否打开调试开关 | 1.0.0 |
请注意
以下 API 暂不支持
名称 | 功能说明 |
---|---|
ft.getRealtimeLogManager | 获取实时日志管理器对象 |
ft.getLogManager | 获取日志管理器对象 |
# 1.4.1 console
名称 | 功能说明 | 版本 | 备注 |
---|---|---|---|
console.debug | 向调试面板中打印 debug 日志 | 1.0.0 | |
console.error | 向调试面板中打印 error 日志 | 1.0.0 | |
console.group | 在调试面板中创建一个新的分组 | 1.0.0 | |
console.groupEnd | 结束由 console.group 创建的分组 | 1.0.0 | |
console.info | 向调试面板中打印 info 日志 | 1.0.0 | |
console.log | 向调试面板中打印 log 日志 | 1.0.0 | |
console.warn | 向调试面板中打印 warn 日志 | 1.0.0 |
# 1.4.2 LogManager
请注意
以下 API 暂不支持
名称 | 功能说明 |
---|---|
LogManager.debug | 写 debug 日志 |
LogManager.info | 写 info 日志 |
LogManager.log | 写 log 日志 |
LogManager.warn | 写 warn 日志 |
# 1.4.3 RealtimeLogManager
请注意
以下 API 暂不支持
名称 | 功能说明 |
---|---|
RealtimeLogManager.error | 写 error 日志 |
RealtimeLogManager.getCurrentState | 实时日志会将一定时间间隔内缓存的日志聚合上报,如果该时间内缓存的内容超出限制,则会被丢弃 |
RealtimeLogManager.in | 设置实时日志page参数所在的页面 |
RealtimeLogManager.tag | 获取给定标签的日志管理器实例 |
RealtimeLogManager.info | 写 info 日志 |
RealtimeLogManager.warn | 写 warn 日志 |
RealtimeLogManager.setFilterMsg | 设置过滤关键字 |
RealtimeLogManager.addFilterMsg | 添加过滤关键字 |
# 1.4.4 RealtimeTagLogManager
请注意
以下 API 暂不支持
名称 | 功能说明 |
---|---|
RealtimeTagLogManager.info | 写 info 日志 |
RealtimeTagLogManager.warn | 写 warn 日志 |
RealtimeTagLogManager.error | 写 error 日志 |
RealtimeTagLogManager.insetFilterMsgfo | 设置过滤关键字 |
RealtimeTagLogManager.addFilterMsg | 添加过滤关键字 |
# 1.5 性能
请注意
以下 API 暂不支持
名称 | 功能说明 |
---|---|
ft.getPerformance | 获取当前小程序性能相关的信息 |
ft.reportPerformance | 小程序测速上报 |
ft.preloadWebview | 预加载下个页面的 WebView |
ft.preloadSkylineView | 预加载下个页面所需要的 Skyline 运行环境 |
ft.preloadAssets | 为视图层预加载媒体资源文件 |
# 1.5.1 EntryList
请注意
以下 API 暂不支持
名称 | 功能说明 |
---|---|
EntryList.getEntries | 该方法返回当前列表中的所有性能数据 |
EntryList.getEntriesByType | 获取当前列表中所有类型为 [entryType] 的性能数据 |
EntryList.getEntriesByName | 获取当前列表中所有名称为 [name] 且类型为 [entryType] 的性能数据 |
# 1.5.2 Performance
请注意
以下 API 暂不支持
名称 | 功能说明 |
---|---|
Performance.getEntries | 该方法返回当前缓冲区中的所有性能数据 |
Performance.getEntriesByType | 获取当前缓冲区中所有类型为 [entryType] 的性能数据 |
Performance.getEntriesByName | 获取当前缓冲区中所有名称为 [name] 且类型为 [entryType] 的性能数据 |
Performance.createObserver | 创建全局性能事件监听器 |
Performance.setBufferSize | 设置缓冲区大小,默认缓冲 30 条性能数据 |
PerformanceEntry | 单条性能数据 |
# 1.5.3 PerformanceObserver
请注意
以下 API 暂不支持
名称 | 功能说明 |
---|---|
PerformanceObserver.disconnect | 停止监听 |
PerformanceObserver.observe | 开始监听 |
# 1.6 分包加载
请注意
以下 API 暂不支持
名称 | 功能说明 |
---|---|
ft.preDownloadSubpackage | 触发分包预下载 |
# 1.6.1 PreDownloadSubpackageTask
请注意
以下 API 暂不支持
名称 | 功能说明 |
---|---|
PreDownloadSubpackageTask.onProgressUpdate | 监听分包加载进度变化事件 |
# 1.7 加密
请注意
以下 API 暂不支持
名称 | 功能说明 |
---|---|
ft.getUserCryptoManager | 获取用户加密模块 |
# 1.7.1 UserCryptoManager
请注意
以下 API 暂不支持
名称 | 功能说明 |
---|---|
UserCryptoManager.getLatestUserKey | 获取最新的用户加密密钥 |
UserCryptoManager.getRandomValues | 获取密码学安全随机数 |
# 2. 路由
名称 | 功能说明 | 版本 | 备注 |
---|---|---|---|
ft.switchTab | 跳转到 tabBar 页面,并关闭其他所有非 tabBar 页面 | 1.0.0 | |
ft.reLaunch | 关闭所有页面,打开到应用内的某个页面 | 1.0.0 | |
ft.redirectTo | 关闭当前页面,跳转到应用内的某个页面 | 1.0.0 | |
ft.navigateTo | 保留当前页面,跳转到应用内的某个页面 | 1.0.0 | |
ft.navigateBack | 关闭当前页面,返回上一页面或多级页面 | 1.0.0 |
# 2.1 EventChannel
名称 | 功能说明 | 版本 | 备注 |
---|---|---|---|
EventChannel.emit | 触发一个事件 | 1.0.0 | |
EventChannel.off | 取消监听一个事件 | 1.0.0 | |
EventChannel.on | 持续监听一个事件 | 1.0.0 | |
EventChannel.once | 监听一个事件一次,触发后失效 | 1.0.0 |
# 3. 跳转
名称 | 功能说明 | 版本 | 备注 |
---|---|---|---|
ft.navigateToMiniProgram | 打开另一个小程序 | 1.0.0 | |
ft.navigateBackMiniProgram | 返回到上一个小程序 | 1.0.0 | |
ft.exitMiniProgram | 退出当前小程序 | 1.0.0 |
请注意
以下 API 暂不支持
名称 | 功能说明 |
---|---|
ft.openEmbeddedMiniProgram | 打开半屏小程序 |
# 4. 转发
名称 | 功能说明 | 版本 | 备注 |
---|---|---|---|
ft.showShareMenu | 显示当前页面的转发按钮 | 1.0.0 | |
ft.hideShareMenu | 隐藏当前页面的转发按钮 | 1.0.0 |
请注意
以下 API 暂不支持
名称 | 功能说明 |
---|---|
ft.updateShareMenu | 更新转发属性 |
ft.showShareImageMenu | 打开分享图片弹窗,可以将图片发送给朋友、收藏或下载 |
ft.shareVideoMessage | 转发视频到聊天 |
ft.shareFileMessage | 转发文件到聊天 |
ft.onCopyUrl | 监听用户点击右上角菜单的「复制链接」按钮时触发的事件 |
ft.offCopyUrl | 取消监听用户点击右上角菜单的「复制链接」按钮时触发的事件 |
ft.getShareInfo | 获取转发详细信息 |
ft.authPrivateMessage | 验证私密消息 |
# 5. 界面
# 5.1 交互
名称 | 功能说明 | 版本 | 备注 |
---|---|---|---|
ft.showToast | 显示消息提示框 | 1.0.0 | |
ft.showModal | 显示模态对话框 | 1.0.0 | |
ft.showLoading | 显示 loading 提示框 | 1.0.0 | |
ft.showActionSheet | 显示操作菜单 | 1.0.0 | |
ft.hideToast | 隐藏消息提示框 | 1.0.0 | |
ft.hideLoading | 隐藏 loading 提示框 | 1.0.0 | |
ft.enableAlertBeforeUnload | 开启小程序页面返回询问对话框 | 2.11.5 | |
ft.disableAlertBeforeUnload | 关闭小程序页面返回询问对话框 | 2.11.5 |
# 5.2 导航栏
名称 | 功能说明 | 版本 | 备注 |
---|---|---|---|
ft.showNavigationBarLoading | 在当前页面显示导航条加载动画 | 1.0.0 | |
ft.setNavigationBarTitle | 动态设置当前页面的标题 | 1.0.0 | |
ft.setNavigationBarColor | 设置页面导航条颜色 | 1.0.0 | |
ft.hideNavigationBarLoading | 在当前页面隐藏导航条加载动画 | 1.0.0 | |
ft.hideHomeButton | 隐藏返回首页按钮 | 1.0.0 |
# 5.3 背景
名称 | 功能说明 | 版本 | 备注 |
---|---|---|---|
ft.setBackgroundTextStyle | 动态设置下拉背景字体、loading 图的样式 | 1.0.0 | |
ft.setBackgroundColor | 动态设置窗口的背景色 | 1.0.0 |
# 5.4 Tab Bar
名称 | 功能说明 | 版本 | 备注 |
---|---|---|---|
ft.showTabBarRedDot | 显示 tabBar 某一项的右上角的红点 | 1.0.0 | |
ft.showTabBar | 显示 tabBar | 1.0.0 | |
ft.setTabBarStyle | 动态设置 tabBar 的整体样式 | 1.0.0 | |
ft.setTabBarItem | 动态设置 tabBar 某一项的内容,2.7.0 起图片支持临时文件和网络文件 | 1.0.0 | |
ft.setTabBarBadge | 为 tabBar 某一项的右上角添加文本 | 1.0.0 | |
ft.removeTabBarBadge | 移除 tabBar 某一项右上角的文本 | 1.0.0 | |
ft.hideTabBarRedDot | 隐藏 tabBar 某一项的右上角的红点 | 1.0.0 | |
ft.hideTabBar | 隐藏 tabBar | 1.0.0 |
# 5.5 字体
名称 | 功能说明 | 版本 | 备注 |
---|---|---|---|
ft.loadFontFace | 动态加载网络字体,文件地址需为下载类型 | 1.0.0 |
# 5.6 下拉刷新
名称 | 功能说明 | 版本 | 备注 |
---|---|---|---|
ft.stopPullDownRefresh | 停止当前页面下拉刷新 | 1.0.0 | |
ft.startPullDownRefresh | 开始下拉刷新 | 1.0.0 |
# 5.7 滚动
名称 | 功能说明 | 版本 | 备注 |
---|---|---|---|
ft.pageScrollTo | 将页面滚动到目标位置,支持选择器和滚动距离两种方式定位 | 1.0.0 |
# 5.7.1 ScrollViewContext
请注意
以下 API 暂不支持
名称 | 功能说明 |
---|---|
ScrollViewContext.scrollIntoView | 滚动至指定位置 |
ScrollViewContext.scrollTo | 滚动至指定位置 |
# 5.8 动画
名称 | 功能说明 | 版本 | 备注 |
---|---|---|---|
ft.createAnimation | 创建一个动画实例 animation | 1.0.0 |
# 5.8.1 Animation
名称 | 功能说明 | 版本 | 备注 |
---|---|---|---|
Animation.export | 导出动画队列 | 1.0.0 | |
Animation.step | 表示一组动画完成 | 1.0.0 | |
Animation.matrix | 同 transform-function matrix | 1.0.0 | |
Animation.matrix3d | 同 transform-function matrix3d | 1.0.0 | |
Animation.rotate | 从原点顺时针旋转一个角度 | 1.0.0 | |
Animation.rotate3d | 从 固定 轴顺时针旋转一个角度 | 1.0.0 | |
Animation.rotateX | 从 X 轴顺时针旋转一个角度 | 1.0.0 | |
Animation.rotateY | 从 Y 轴顺时针旋转一个角度 | 1.0.0 | |
Animation.rotateZ | 从 Z 轴顺时针旋转一个角度 | 1.0.0 | |
Animation.scale | 缩放 | 1.0.0 | |
Animation.scale3d | 缩放 | 1.0.0 | |
Animation.scaleX | 缩放 X 轴 | 1.0.0 | |
Animation.scaleY | 缩放 Y 轴 | 1.0.0 | |
Animation.scaleZ | 缩放 Z 轴 | 1.0.0 | |
Animation.skew | 对 X、Y 轴坐标进行倾斜 | 1.0.0 | |
Animation.skewX | 对 X 轴坐标进行倾斜 | 1.0.0 | |
Animation.skewY | 对 Y 轴坐标进行倾斜 | 1.0.0 | |
Animation.translate | 平移变换 | 1.0.0 | |
Animation.translate3d | 对 xyz 坐标进行平移变换 | 1.0.0 | |
Animation.translateX | 对 X 轴平移 | 1.0.0 | |
Animation.translateY | 对 Y 轴平移 | 1.0.0 | |
Animation.translateZ | 对 Z 轴平移 | 1.0.0 | |
Animation.opacity | 设置透明度 | 1.0.0 | |
Animation.backgroundColor | 设置背景色 | 1.0.0 | |
Animation.width | 设置宽度 | 1.0.0 | |
Animation.height | 设置高度 | 1.0.0 | |
Animation.left | 设置 left 值 | 1.0.0 | |
Animation.right | 设置 right 值 | 1.0.0 | |
Animation.top | 设置 top 值 | 1.0.0 | |
Animation.bottom | 设置 bottom 值 | 1.0.0 |
# 5.9 置顶
请注意
以下 API 暂不支持
名称 | 功能说明 |
---|---|
ft.setTopBarText | 动态设置置顶栏文字内容 |
# 5.10 自定义组件
名称 | 功能说明 | 版本 | 备注 |
---|---|---|---|
ft.nextTick | 延迟一部分操作到下一个时间片再执行 | 1.0.0 |
# 5.11 菜单
名称 | 功能说明 | 版本 | 备注 |
---|---|---|---|
ft.getMenuButtonBoundingClientRect | 获取菜单按钮(右上角胶囊按钮)的布局位置信息 | 1.0.0 |
# 5.12 窗口
名称 | 功能说明 | 版本 | 备注 |
---|---|---|---|
ft.onWindowResize | 监听窗口尺寸变化事件 | 1.0.0 | |
ft.offWindowResize | 取消监听窗口尺寸变化事件 | 1.0.0 |
请注意
以下 API 暂不支持
名称 | 功能说明 |
---|---|
ft.setWindowSize | 设置窗口大小,该接口仅适用于 PC 平台,使用细则请参见指南 |
# 5.13 worklet 动画
请注意
以下 API 暂不支持
名称 | 功能说明 |
---|---|
ft.worklet | 获取 worklet 对象 |
# 5.13.1 worklet
请注意
以下 API 暂不支持
名称 | 功能说明 |
---|---|
worklet.cancelAnimation | 取消由 SharedValue 驱动的动画 |
worklet.derived | 衍生值 DerivedValue,可基于已有的 SharedValue 生成其它共享变量 |
worklet.shared | 共享变量 SharedValue,用于跨线程共享数据和驱动动画 |
worklet.decay | 基于滚动的动画 |
worklet.spring | 基于物理的动画 |
worklet.timing | 基于时间的动画 |
worklet.delay | 延迟执行动画 |
worklet.repeat | 重复执行动画 |
worklet.sequence | 组合动画序列,依次执行传入的动画 |
worklet.runOnJS | worklet 函数运行在 UI 线程时,捕获的外部函数可能为 worklet 类型或普通函数,为了更明显的对其区分,要求必须使用 runOnJS 调回 JS 线程的普通函数 |
worklet.runOnUI | 在 UI 线程执行 worklet 函数 |
# 6. 网络
# 6.1 发起请求
名称 | 功能说明 | 版本 | 备注 |
---|---|---|---|
ft.request | 发起 HTTPS 网络请求 | 1.0.0 |
# 6.2 RequestTask
名称 | 功能说明 | 版本 | 备注 |
---|---|---|---|
RequestTask.abort | 中断请求任务 | 1.0.0 | |
RequestTask.offHeadersReceived | 取消监听 HTTP Response Header 事件 | 1.0.0 | |
RequestTask.onHeadersReceived | 监听 HTTP Response Header 事件 | 1.0.0 |
请注意
以下 API 暂不支持
名称 | 功能说明 |
---|---|
RequestTask.onChunkReceived | 监听 Transfer-Encoding Chunk Received 事件 |
RequestTask.offChunkReceived | 移除 Transfer-Encoding Chunk Received 事件的监听函数 |
# 6.3 下载
名称 | 功能说明 | 版本 | 备注 |
---|---|---|---|
ft.downloadFile | 下载文件资源到本地 | 1.0.0 |
# 6.3.1 DownloadTask
名称 | 功能说明 | 版本 | 备注 |
---|---|---|---|
DownloadTask.abort | 中断下载任务 | 1.0.0 | |
DownloadTask.offHeadersReceived | 移除 HTTP Response Header 事件的监听函数 | 1.0.0 | |
DownloadTask.onHeadersReceived | 监听 HTTP Response Header 事件。会比请求完成事件更早 | 1.0.0 | |
DownloadTask.offProgressUpdate | 移除下载进度变化事件的监听函数 | 1.0.0 | |
DownloadTask.onProgressUpdate | 监听下载进度变化事件 | 1.0.0 |
# 6.4 上传
名称 | 功能说明 | 版本 | 备注 |
---|---|---|---|
ft.uploadFile | 将本地资源上传到服务器 | 1.0.0 |
# 6.4.1 UploadTask
名称 | 功能说明 | 版本 | 备注 |
---|---|---|---|
UploadTask.abort | 中断上传任务 | 1.0.0 | |
UploadTask.offHeadersReceived | 移除 HTTP Response Header 事件的监听函数 | 1.0.0 | |
UploadTask.onHeadersReceived | 监听 HTTP Response Header 事件。会比请求完成事件更早 | 1.0.0 | |
UploadTask.offProgressUpdate | 移除上传进度变化事件的监听函数 | 1.0.0 | |
UploadTask.onProgressUpdate | 监听上传进度变化事件 | 1.0.0 |
# 6.5 WebSocket
名称 | 功能说明 | 版本 | 备注 |
---|---|---|---|
ft.sendSocketMessage | 通过 WebSocket 连接发送数据 | 1.0.0 | |
ft.onSocketOpen | 监听 WebSocket 连接打开事件 | 1.0.0 | |
ft.onSocketMessage | 监听 WebSocket 接受到服务器的消息事件 | 1.0.0 | |
ft.onSocketError | 监听 WebSocket 错误事件 | 1.0.0 | |
ft.onSocketClose | 监听 WebSocket 连接关闭事件 | 1.0.0 | |
ft.connectSocket | 创建一个 WebSocket 连接 | 1.0.0 | |
ft.closeSocket | 关闭 WebSocket 连接 | 1.0.0 |
# 6.5.1 SocketTask
名称 | 功能说明 | 版本 | 备注 |
---|---|---|---|
SocketTask.close | 关闭 WebSocket 连接 | 1.0.0 | |
SocketTask.onClose | 监听 WebSocket 连接关闭事件 | 1.0.0 | |
SocketTask.onError | 监听 WebSocket 错误事件 | 1.0.0 | |
SocketTask.onMessage | 监听 WebSocket 接受到服务器的消息事件 | 1.0.0 | |
SocketTask.onOpen | 监听 WebSocket 连接打开事件 | 1.0.0 | |
SocketTask.send | 通过 WebSocket 连接发送数据 | 1.0.0 |
# 6.6 mDNS
请注意
以下 API 暂不支持
名称 | 功能说明 |
---|---|
ft.stopLocalServiceDiscovery | 停止搜索 mDNS 服务 |
ft.startLocalServiceDiscovery | 开始搜索局域网下的 mDNS 服务 |
ft.onLocalServiceResolveFail | 监听 mDNS 服务解析失败的事件 |
ft.onLocalServiceLost | 监听 mDNS 服务离开的事件 |
ft.onLocalServiceFound | 监听 mDNS 服务发现的事件 |
ft.onLocalServiceDiscoveryStop | 监听 mDNS 服务停止搜索的事件 |
ft.offLocalServiceResolveFail | 取消监听 mDNS 服务解析失败的事件 |
ft.offLocalServiceLost | 取消监听 mDNS 服务离开的事件 |
ft.offLocalServiceFound | 取消监听 mDNS 服务发现的事件 |
ft.offLocalServiceDiscoveryStop | 取消监听 mDNS 服务停止搜索的事件 |
# 6.7 TCP 通信
名称 | 功能说明 | 版本 | 备注 |
---|---|---|---|
ft.createTCPSocket | 创建一个 TCP Socket 实例 | 1.0.0 |
# 6.7.1 TCPSocket
名称 | 功能说明 | 版本 | 备注 |
---|---|---|---|
TCPSocket.onMessage | 监听当接收到数据的时触发该事件 | 1.0.0 | |
TCPSocket.write | 在 socket 上发送数据 | 1.0.0 | |
TCPSocket.close | 关闭连接 | 1.0.0 | |
TCPSocket.connect | 在给定的套接字上启动连接 | 1.0.0 | |
TCPSocket.offConnect | 移除当一个 socket 连接成功建立的时候触发该事件的监听函数 | 1.0.0 | |
TCPSocket.offClose | 移除一旦 socket 完全关闭就发出该事件的监听函数 | 1.0.0 | |
TCPSocket.offError | 移除当错误发生时触发的监听函数 | 1.0.0 | |
TCPSocket.offMessage | 移除当接收到数据的时触发该事件的监听函数 | 1.0.0 | |
TCPSocket.onClose | 监听一旦 socket 完全关闭就发出该事件 | 1.0.0 | |
TCPSocket.onConnect | 监听当一个 socket 连接成功建立的时候触发该事件 | 1.0.0 | |
TCPSocket.onError | 监听当错误发生时触发 | 1.0.0 |
请注意
以下 API 暂不支持
名称 | 功能说明 |
---|---|
TCPSocket.bindWifi | 将 TCP Socket 绑定到当前 wifi 网络,成功后会触发 onBindWifi 事件(仅安卓支持) |
TCPSocket.offBindWifi | 移除当一个 socket 绑定当前 wifi 网络成功时触发该事件的监听函数 |
TCPSocket.onBindWifi | 监听当一个 socket 绑定当前 wifi 网络成功时触发该事件 |
# 6.8 UDP 通信
名称 | 功能说明 | 版本 | 备注 |
---|---|---|---|
ft.createUDPSocket | 创建一个 UDP Socket 实例 | 1.0.0 |
# 6.8.1 UDPSocket
名称 | 功能说明 | 版本 | 备注 |
---|---|---|---|
UDPSocket.bind | 绑定一个系统随机分配的可用端口,或绑定一个指定的端口号 | 1.0.0 | |
UDPSocket.close | 关闭 UDP Socket 实例,相当于销毁 | 1.0.0 | |
UDPSocket.offClose | 取消监听关闭事件 | 1.0.0 | |
UDPSocket.offError | 取消监听错误事件 | 1.0.0 | |
UDPSocket.offListening | 取消监听开始监听数据包消息的事件 | 1.0.0 | |
UDPSocket.offMessage | 取消监听收到消息的事件 | 1.0.0 | |
UDPSocket.onClose | 监听关闭事件 | 1.0.0 | |
UDPSocket.onError | 监听错误事件 | 1.0.0 | |
UDPSocket.onListening | 监听开始监听数据包消息的事件 | 1.0.0 | |
UDPSocket.onMessage | 监听收到消息的事件 | 1.0.0 | |
UDPSocket.connect | 预先连接到指定的 IP 和 port,需要配合 write 方法一起使用 | 1.0.0 | |
UDPSocket.write | 用法与 send 方法相同,如果没有预先调用 connect 则与 send 无差异(注意即使调用了 connect 也需要在本接口填入地址和端口参数) | 1.0.0 | |
UDPSocket.setTTL | 设置 IP_TTL 套接字选项,用于设置一个 IP 数据包传输时允许的最大跳步数 | 1.0.0 | |
UDPSocket.send | 向指定的 IP 和 port 发送消息 | 1.0.0 |
# 7. 数据缓存
名称 | 功能说明 | 版本 | 备注 |
---|---|---|---|
ft.setStorageSync | ft.setStorage 的同步版本 | 1.0.0 | |
ft.setStorage | 将数据存储在本地缓存中指定的 key 中 | 1.0.0 | |
ft.removeStorageSync | ft.removeStorage 的同步版本 | 1.0.0 | |
ft.removeStorage | 从本地缓存中移除指定 key | 1.0.0 | |
ft.getStorageSync | ft.getStorage 的同步版本 | 1.0.0 | |
ft.getStorageInfoSync | ft.getStorageInfo 的同步版本 | 1.0.0 | |
ft.getStorageInfo | 异步获取当前storage的相关信息 | 1.0.0 | |
ft.getStorage | 从本地缓存中异步获取指定 key 的内容 | 1.0.0 | |
ft.clearStorageSync | ft.clearStorage 的同步版本 | 1.0.0 | |
ft.clearStorage | 清理本地数据缓存 | 1.0.0 |
请注意
以下 API 暂不支持
名称 | 功能说明 |
---|---|
ft.revokeBufferURL | 根据 URL 销毁存在内存中的数据 |
ft.createBufferURL | 根据传入的 buffer 创建一个唯一的 URL 存在内存中 |
ft.batchSetStorageSync | 将数据批量存储在本地缓存中指定的 key 中 |
ft.batchSetStorage | 将数据批量存储在本地缓存中指定的 key 中 |
ft.batchGetStorageSync | 从本地缓存中同步批量获取指定 key 的内容 |
ft.batchGetStorage | 从本地缓存中同步批量获取指定 key 的内容 |
# 7.1 周期性更新
请注意
以下 API 暂不支持
名称 | 功能说明 |
---|---|
ft.setBackgroundFetchToken | 设置自定义登录态,在周期性拉取数据时带上,便于第三方服务器验证请求合法性 |
ft.onBackgroundFetchData | 监听收到 backgroundFetch 数据时的回调 |
ft.getBackgroundFetchToken | 获取设置过的自定义登录态 |
ft.getBackgroundFetchData | 拉取 backgroundFetch 客户端缓存数据 |
# 7.2 缓存管理器
请注意
以下 API 暂不支持
名称 | 功能说明 |
---|---|
ft.createCacheManager | 创建缓存管理器 |
# 7.2.1 CacheManager
请注意
以下 API 暂不支持
名称 | 功能说明 |
---|---|
CacheManager.addRule | 添加规则 |
CacheManager.addRules | 批量添加规则,规则写法可参考 CacheManager.addRule |
CacheManager.clearCaches | 清空所有缓存 |
CacheManager.clearRules | 清空所有规则,同时会删除对应规则下所有缓存 |
CacheManager.deleteCache | 删除缓存 |
CacheManager.deleteCaches | 批量删除缓存 |
CacheManager.deleteRule | 删除规则,同时会删除对应规则下所有缓存 |
CacheManager.deleteRules | 删除规则,同时会删除对应规则下所有缓存 |
CacheManager.match | 匹配命中的缓存规则,一般需要和 request 事件搭配使用 |
CacheManager.off | 取消事件监听 |
CacheManager.on | 监听事件 |
CacheManager.start | 开启缓存,仅在 mode 为 none 时生效,调用后缓存管理器的 state 会置为 1 |
CacheManager.stop | 关闭缓存,仅在 mode 为 none 时生效,调用后缓存管理器的 state 会置为 0 |
# 8. 数据分析
请注意
以下 API 暂不支持
名称 | 功能说明 |
---|---|
ft.reportMonitor | 自定义业务数据监控上报接口 |
ft.reportEvent | 事件上报 |
ft.reportAnalytics | 自定义分析数据上报接口 |
ft.getExptInfoSync | 给定实验参数数组,获取对应的实验参数值 |
# 9. 画布
名称 | 功能说明 | 版本 | 备注 |
---|---|---|---|
ft.createOffscreenCanvas | 创建离屏 canvas 实例 | 1.0.0 | |
ft.createCanvasContext | 创建 canvas 的绘图上下文 CanvasContext 对象 | 1.0.0 | |
ft.canvasToTempFilePath | 把当前画布指定区域的内容导出生成指定大小的图片 | 1.0.0 | |
ft.canvasPutImageData | 将像素数据绘制到画布 | 1.0.0 | |
ft.canvasGetImageData | 获取 canvas 区域隐含的像素数据 | 1.0.0 |
# 9.1 Canvas
名称 | 功能说明 | 版本 | 备注 |
---|---|---|---|
Canvas.createImage | 创建一个 image 对象,仅 createSelectorQuery 获取到的 canvas 有该方法 | 1.0.0 | |
Canvas.getContext | 该方法返回 Canvas 的绘图上下文 | 1.0.0 | |
Canvas.createImageData | 创建一个 ImageData 对象 | 1.0.0 |
请注意
以下 API 暂不支持
名称 | 功能说明 |
---|---|
Canvas.cancelAnimationFrame | 取消由 requestAnimationFrame 添加到计划中的动画帧请求 |
Canvas.createPath2D | 创建 Path2D 对象 |
Canvas.requestAnimationFrame | 在下次进行重绘时执行 |
Canvas.toDataURL | 返回一个包含图片展示的 data URI |
# 9.2 CanvasContext
# 9.3 CanvasGradient
名称 | 功能说明 |
---|---|
CanvasGradient.addColorStop | 添加颜色的渐变点 |
Color | 颜色 |
Image | 图像 |
ImageData | ImageData 对象 |
# 9.4 OffscreenCanvas
名称 | 功能说明 | 版本 | 备注 |
---|---|---|---|
OffscreenCanvas.createImage | 创建一个图片对象 | 1.0.0 | |
OffscreenCanvas.getContext | 该方法返回 OffscreenCanvas 的绘图上下文 | 1.0.0 |
# 10. 媒体
# 10.1 地图
名称 | 功能说明 | 版本 | 备注 |
---|---|---|---|
ft.createMapContext | 创建 map 上下文 MapContext 对象 | 1.0.0 |
# 10.1.1 MapContext
名称 | 功能说明 | 版本 | 备注 |
---|---|---|---|
MapContext.addArc | 添加弧线,途经点与夹角必须设置一个 | 1.0.0 | |
MapContext.addCustomLayer | 添加个性化图层 | 1.0.0 | |
MapContext.addGroundOverlay | 创建自定义图片图层,图片会随着地图缩放而缩放 | 1.0.0 | |
MapContext.addMarkers | 添加 marker | 1.0.0 | |
MapContext.fromScreenLocation | 获取屏幕上的点对应的经纬度,坐标原点为地图左上角 | 1.0.0 | |
MapContext.getCenterLocation | 获取当前地图中心的经纬度 | 1.0.0 | |
MapContext.getRegion | 获取当前地图的视野范围 | 1.0.0 | |
MapContext.getRotate | 获取当前地图的旋转角 | 1.0.0 | |
MapContext.getSkew | 获取当前地图的倾斜角 | 1.0.0 | |
MapContext.getScale | 获取当前地图的缩放级别 | 1.0.0 | |
MapContext.includePoints | 缩放视野展示所有经纬度 | 1.0.0 | |
MapContext.initMarkerCluster | 初始化点聚合的配置,未调用时采用默认配置 | 1.0.0 | |
MapContext.moveAlong | 沿指定路径移动 marker,用于轨迹回放等场景 | 1.0.0 | |
MapContext.moveToLocation | 将地图中心移置当前定位点,此时需设置地图组件 show-location 为true | 1.0.0 | |
MapContext.openMapApp | 拉起地图APP选择导航 | 1.0.0 | |
MapContext.removeCustomLayer | 移除个性化图层 | 1.0.0 | |
MapContext.removeGroundOverlay | 移除自定义图片图层 | 1.0.0 | |
MapContext.removeMarkers | 移除 marker | 1.0.0 | |
MapContext.setBoundary | 限制地图的显示范围 | 1.0.0 | |
MapContext.setCenterOffset | 设置地图中心点偏移,向后向下为增长,屏幕比例范围(0.25~0.75),默认偏移为[0.5, 0.5] | 1.0.0 | |
MapContext.setLocMarkerIcon | 设置定位点图标,支持网络路径、本地路径、代码包路径 | 1.0.0 | |
MapContext.toScreenLocation | 获取经纬度对应的屏幕坐标,坐标原点为地图左上角 | 1.0.0 | |
MapContext.translateMarker | 平移marker,带动画 | 1.0.0 | |
MapContext.updateGroundOverlay | 更新自定义图片图层 | 1.0.0 | |
MapContext.on | 监听地图事件 | 1.0.0 |
请注意
以下 API 暂不支持
名称 | 功能说明 |
---|---|
MapContext.addVisualLayer | 添加可视化图层 |
MapContext.removeVisualLayer | 移除可视化图层 |
MapContext.removeArc | 删除弧线 |
# 10.2 图片
名称 | 功能说明 | 版本 | 备注 |
---|---|---|---|
ft.saveImageToPhotosAlbum | 保存图片到系统相册 | 1.0.0 | |
ft.previewMedia | 预览图片和视频 | 1.0.0 | |
ft.previewImage | 在新页面中全屏预览图片 | 1.0.0 | |
ft.getImageInfo | 获取图片信息 | 1.0.0 | |
ft.compressImage | 压缩图片接口,可选压缩质量 | 1.0.0 | |
ft.chooseFile | 从客户端会话选择文件 | 2.0.32 | |
ft.chooseImage | 从本地相册选择图片或使用相机拍照 | 1.0.0 |
请注意
以下 API 暂不支持
名称 | 功能说明 |
---|---|
ft.cropImage | 编辑图片接口 |
ft.editImage | 裁剪图片接口 |
ft.chooseMessageFile | 从客户端会话选择文件 |
# 10.3 视频
名称 | 功能说明 | 版本 | 备注 |
---|---|---|---|
ft.saveVideoToPhotosAlbum | 保存视频到系统相册 | 1.0.0 | |
ft.createVideoContext | 创建 video 上下文 VideoContext 对象 | 1.0.0 | |
ft.compressVideo | 压缩视频接口 | 1.0.0 | |
ft.chooseVideo | 拍摄视频或从手机相册中选视频 | 1.0.0 | |
ft.chooseMedia | 拍摄或从手机相册中选择图片或视频 | 1.0.0 | |
ft.previewVideo | 预览视频 | 1.0.0 |
请注意
以下 API 暂不支持
名称 | 功能说明 |
---|---|
ft.openVideoEditor | 打开视频编辑器 |
ft.getVideoInfo | 获取视频详细信息 |
# 10.3.1 videoContext
名称 | 功能说明 | 版本 | 备注 |
---|---|---|---|
videoContext.exitBackgroundPlayback | 退出后台音频播放模式 | 1.0.0 | |
videoContext.exitFullScreen | 退出全屏 | 1.0.0 | |
videoContext.exitPictureInPicture | 退出小窗,该方法可在任意页面调用 | 1.0.0 | |
videoContext.hideStatusBar | 隐藏状态栏,仅在iOS全屏下有效 | 1.0.0 | |
videoContext.pause | 暂停视频 | 1.0.0 | |
videoContext.play | 播放视频 | 1.0.0 | |
videoContext.playbackRate | 设置倍速播放 | 1.0.0 | |
videoContext.requestBackgroundPlayback | 进入后台音频播放模式 | 1.0.0 | |
videoContext.requestFullScreen | 进入全屏 | 1.0.0 | |
videoContext.seek | 跳转到指定位置 | 1.0.0 | |
videoContext.sendDanmu | 发送弹幕 | 1.0.0 | |
videoContext.showStatusBar | 显示状态栏,仅在iOS全屏下有效 | 1.0.0 | |
videoContext.stop | 停止视频 | 1.0.0 |
# 10.4 音频
名称 | 功能说明 | 版本 | 备注 |
---|---|---|---|
ft.stopVoice | 结束播放语音 | 1.0.0 | |
ft.setInnerAudioOption | 设置 InnerAudioContext 的播放选项 | 1.0.0 | |
ft.playVoice | 开始播放语音 | 1.0.0 | |
ft.pauseVoice | 暂停正在播放的语音 | 1.0.0 | |
ft.createInnerAudioContext | 创建内部 audio 上下文 InnerAudioContext 对象 | 1.0.0 | |
ft.createAudioContext | 创建 audio 上下文 AudioContext 对象 | 1.0.0 |
请注意
以下 API 暂不支持
名称 | 功能说明 |
---|---|
ft.getAvailableAudioSources | 获取当前支持的音频输入源 |
ft.createWebAudioContext | 创建WebAudio上下文 |
ft.createMediaAudioPlayer | 创建媒体音频播放器对象 MediaAudioPlayer 对象,可用于播放视频解码器 VideoDecoder 输出的音频 |
# 10.4.1 AudioBuffer
请注意
以下 API 暂不支持
名称 | 功能说明 |
---|---|
AudioBuffer.copyFromChannel | 从AudioBuffer的指定频道复制到数组终端 |
AudioBuffer.copyToChannel | 从指定数组复制样本到audioBuffer的特定通道 |
AudioBuffer.getChannelData | 返回一个 Float32Array,包含了带有频道的PCM数据,由频道参数定义(有0代表第一个频道) |
# 10.4.2 audiocontext
名称 | 功能说明 | 版本 | 备注 |
---|---|---|---|
audiocontext.setSrc | 设置音频地址 | 1.0.0 | |
audiocontext.play | 播放音频 | 1.0.0 | |
audiocontext.pause | 暂停音频 | 1.0.0 | |
audiocontext.seek | 跳转到指定位置 | 1.0.0 |
# 10.4.3 InnerAudioContext
# 10.4.4 MediaAudioPlayer
请注意
以下 API 暂不支持
名称 | 功能说明 |
---|---|
MediaAudioPlayer.addAudioSource | 添加音频源 |
MediaAudioPlayer.destroy | 销毁播放器 |
MediaAudioPlayer.removeAudioSource | 移除音频源 |
MediaAudioPlayer.start | 启动播放器 |
MediaAudioPlayer.stop | 停止播放器 |
# 10.4.5 WebAudioContext
请注意
以下 API 暂不支持
名称 | 功能说明 |
---|---|
WebAudioContext.close | 关闭WebAudioContext |
WebAudioContext.createAnalyser | 创建一个 AnalyserNode |
WebAudioContext.createBiquadFilter | 创建一个BiquadFilterNode |
WebAudioContext.createBuffer | 创建一个AudioBuffer,代表着一段驻留在内存中的短音频 |
WebAudioContext.createBufferSource | 创建一个BufferSourceNode实例,通过AudioBuffer对象来播放音频数据 |
WebAudioContext.createChannelMerger | 创建一个ChannelMergerNode |
WebAudioContext.createChannelSplitter | 创建一个ChannelSplitterNode |
WebAudioContext.createConstantSource | 创建一个ConstantSourceNode |
WebAudioContext.createDelay | 创建一个DelayNode |
WebAudioContext.createDynamicsCompressor | 创建一个DynamicsCompressorNode |
WebAudioContext.createGain | 创建一个GainNode |
WebAudioContext.createIIRFilter | 创建一个IIRFilterNode |
WebAudioContext.createOscillator | 创建一个OscillatorNode |
WebAudioContext.createPanner | 创建一个PannerNode |
WebAudioContext.createPeriodicWave | 创建一个PeriodicWaveNode |
WebAudioContext.createScriptProcessor | 创建一个ScriptProcessorNode |
WebAudioContext.createWaveShaper | 创建一个WaveShaperNode |
WebAudioContext.decodeAudioData | 异步解码一段资源为AudioBuffer |
WebAudioContext.resume | 同步恢复已经被暂停的WebAudioContext上下文 |
WebAudioContext.suspend | 同步暂停WebAudioContext上下文 |
WebAudioContextNode | 一类音频处理模块,不同的Node具备不同的功能,如GainNode(音量调整)等 |
# 10.5 背景音频
名称 | 功能说明 | 版本 | 备注 |
---|---|---|---|
ft.stopBackgroundAudio | 停止播放音乐 | 1.0.0 | |
ft.seekBackgroundAudio | 控制音乐播放进度 | 1.0.0 | |
ft.playBackgroundAudio | 使用后台播放器播放音乐 | 1.0.0 | |
ft.pauseBackgroundAudio | 暂停播放音乐 | 1.0.0 | |
ft.onBackgroundAudioStop | 监听音乐停止事件 | 1.0.0 | |
ft.onBackgroundAudioPlay | 监听音乐播放事件 | 1.0.0 | |
ft.onBackgroundAudioPause | 监听音乐暂停事件 | 1.0.0 | |
ft.getBackgroundAudioPlayerState | 获取后台音乐播放状态 | 1.0.0 | |
ft.getBackgroundAudioManager | 获取全局唯一的背景音频管理器 小程序切入后台,如果音频处于播放状态,可以继续播放。但是后台状态不能通过调用API操纵音频的播放状态。 | 2.12.12 |
# 10.5.1 backgroundaudiomanager
名称 | 功能说明 | 版本 | 备注 |
---|---|---|---|
backgroundaudiomanager.onCanplay | 监听背景音频进入可播放状态事件 | 1.0.0 | |
backgroundaudiomanager.onEnded | 监听背景音频自然播放结束事件 | 1.0.0 | |
BackgroundAudioManager.onError | 监听背景音频播放错误事件 | 1.0.0 | |
backgroundaudiomanager.onNext | 监听用户在系统音乐播放面板点击下一曲事件(仅iOS) | 1.0.0 | |
backgroundaudiomanager.onPause | 监听背景音频暂停事件 | 1.0.0 | |
backgroundaudiomanager.onPlay | 监听背景音频播放事件 | 1.0.0 | |
backgroundaudiomanager.onPrev | 监听用户在系统音乐播放面板点击上一曲事件(仅iOS) | 1.0.0 | |
backgroundaudiomanager.onSeeked | 监听背景音频完成跳转操作事件 | 1.0.0 | |
backgroundaudiomanager.onSeeking | 监听背景音频开始跳转操作事件 | 1.0.0 | |
backgroundaudiomanager.onStop | 监听背景音频停止事件 | 1.0.0 | |
backgroundaudiomanager.onTimeUpdate | 监听背景音频播放进度更新事件,只有小程序在前台时会回调 | 1.0.0 | |
backgroundaudiomanager.onWaiting | 监听音频加载中事件 | 1.0.0 | |
backgroundaudiomanager.pause | 暂停音乐 | 1.0.0 | |
backgroundaudiomanager.play | 播放音乐 | 1.0.0 | |
backgroundaudiomanager.seek | 跳转到指定位置 | 1.0.0 | |
backgroundaudiomanager.stop | 停止音乐 | 1.0.0 |
# 10.6 实时音视频
名称 | 功能说明 | 版本 | 备注 |
---|---|---|---|
ft.createLivePusherContext | 创建 live-pusher 上下文 LivePusherContext 对象 | 1.0.0 | |
ft.createLivePlayerContext | 创建 live-player 上下文 LivePlayerContext 对象 | 1.0.0 |
# 10.6.1 LivePlayerContext
名称 | 功能说明 | 版本 | 备注 |
---|---|---|---|
LivePlayerContext.exitFullScreen | 退出全屏 | 1.0.0 | |
LivePlayerContext.exitPictureInPicture | 退出小窗,该方法可在任意页面调用 | 1.0.0 | |
LivePlayerContext.mute | 静音 | 1.0.0 | |
LivePlayerContext.pause | 暂停 | 1.0.0 | |
LivePlayerContext.play | 播放 | 1.0.0 | |
LivePlayerContext.requestFullScreen | 进入全屏 | 1.0.0 | |
LivePlayerContext.requestPictureInPicture | 进入小窗 | 1.0.0 | |
LivePlayerContext.resume | 恢复 | 1.0.0 | |
LivePlayerContext.snapshot | 截图 | 1.0.0 | |
LivePlayerContext.stop | 停止 | 1.0.0 |
# 10.6.2 LivePusherContext
名称 | 功能说明 | 版本 | 备注 |
---|---|---|---|
LivePusherContext.exitPictureInPicture | 退出小窗,该方法可在任意页面调用 | 1.0.0 | |
LivePusherContext.pause | 暂停推流 | 1.0.0 | |
LivePusherContext.pauseBGM | 暂停背景音 | 1.0.0 | |
LivePusherContext.playBGM | 播放背景音 | 1.0.0 | |
LivePusherContext.resume | 恢复推流 | 1.0.0 | |
LivePusherContext.resumeBGM | 恢复背景音 | 1.0.0 | |
LivePusherContext.sendMessage | 发送SEI消息 | 1.0.0 | |
LivePusherContext.setBGMVolume | 设置背景音音量 | 1.0.0 | |
LivePusherContext.setMICVolume | 设置麦克风音量 | 1.0.0 | |
LivePusherContext.snapshot | 快照 | 1.0.0 | |
LivePusherContext.start | 开始推流,同时开启摄像头预览 | 1.0.0 | |
LivePusherContext.startPreview | 开启摄像头预览 | 1.0.0 | |
LivePusherContext.stop | 停止推流,同时停止摄像头预览 | 1.0.0 | |
LivePusherContext.stopBGM | 停止背景音 | 1.0.0 | |
LivePusherContext.stopPreview | 关闭摄像头预览 | 1.0.0 | |
LivePusherContext.switchCamera | 切换前后摄像头 | 1.0.0 | |
LivePusherContext.toggleTorch | 切换手电筒 | 1.0.0 |
请注意
以下 API 暂不支持
名称 | 功能说明 |
---|---|
LivePusherContext.createOffscreenCanvas | 创建一个能够承接 LivePusher 采集纹理的离屏 Canvas |
LivePusherContext.onCustomRendererEvent | 开启自定义渲染时,开发者通过此方法订阅相关事件 |
# 10.7 录音
名称 | 功能说明 | 版本 | 备注 |
---|---|---|---|
ft.stopRecord | 停止录音 | 1.0.0 | |
ft.startRecord | 开始录音 | 1.0.0 | |
ft.getRecorderManager | 获取全局唯一的录音管理器 RecorderManager | 1.0.0 |
# 10.7.1 RecorderManager
名称 | 功能说明 | 版本 | 备注 |
---|---|---|---|
RecorderManager.onError | 监听录音错误事件 | 1.0.0 | |
RecorderManager.onFrameRecorded | 监听已录制完指定帧大小的文件事件 | 1.0.0 | |
RecorderManager.onInterruptionBegin | 监听录音因为受到系统占用而被中断开始事件 | 1.0.0 | |
RecorderManager.onInterruptionEnd | 监听录音中断结束事件 | 1.0.0 | |
RecorderManager.onPause | 监听录音暂停事件 | 1.0.0 | |
RecorderManager.onResume | 监听录音继续事件 | 1.0.0 | |
RecorderManager.onStop | 监听录音结束事件 | 1.0.0 | |
RecorderManager.pause | 暂停录音 | 1.0.0 | |
RecorderManager.resume | 继续录音 | 1.0.0 | |
RecorderManager.onStart | 监听录音开始事件 | 1.0.0 | |
RecorderManager.stop | 停止录音 | 1.0.0 | |
RecorderManager.start | 开始录音 | 1.0.0 |
# 10.8 相机
名称 | 功能说明 | 版本 | 备注 |
---|---|---|---|
ft.createCameraContext | 创建 camera 上下文 CameraContext 对象 | 1.0.0 |
# 10.8.1 CameraContext
名称 | 功能说明 | 版本 | 备注 |
---|---|---|---|
CameraContext.onCameraFrame | 获取 Camera 实时帧数据 | 1.0.0 | |
CameraContext.setZoom | 设置缩放级别 | 1.0.0 | |
CameraContext.startRecord | 开始录像 | 1.0.0 | |
CameraContext.stopRecord | 结束录像 | 1.0.0 | |
CameraContext.takePhoto | 拍摄照片 | 1.0.0 |
# 10.8.2 CameraFrameListener
名称 | 功能说明 | 版本 | 备注 |
---|---|---|---|
CameraFrameListener.start | 开始监听帧数据 | 1.0.0 | |
CameraFrameListener.stop | 停止监听帧数据 | 1.0.0 |
# 10.9 富文本
# 10.9.1 EditorContext
名称 | 功能说明 | 版本 | 备注 |
---|---|---|---|
EditorContext.blur | 编辑器失焦,同时收起键盘 | 1.0.0 | |
EditorContext.clear | 清空编辑器内容 | 1.0.0 | |
EditorContext.format | 修改样式 | 1.0.0 | |
EditorContext.getContents | 获取编辑器内容 | 1.0.0 | |
EditorContext.getSelectionText | 获取编辑器已选区域内的纯文本内容 | 1.0.0 | |
EditorContext.insertDivider | 插入分割线 | 1.0.0 | |
EditorContext.insertImage | 插入图片 | 1.0.0 | |
EditorContext.insertText | 覆盖当前选区,设置一段文本 | 1.0.0 | |
EditorContext.redo | 恢复 | 1.0.0 | |
EditorContext.removeFormat | 清除当前选区的样式 | 1.0.0 | |
EditorContext.scrollIntoView | 使得编辑器光标处滚动到窗口可视区域内 | 1.0.0 | |
EditorContext.setContents | 初始化编辑器内容,html和delta同时存在时仅delta生效 | 1.0.0 | |
EditorContext.undo | 撤销 | 1.0.0 |
# 10.10 音视频合成
请注意
以下 API 暂不支持
名称 | 功能说明 |
---|---|
ft.createMediaContainer | 创建音视频处理容器,最终可将容器中的轨道合成一个视频 |
# 10.10.1 MediaContainer
请注意
以下 API 暂不支持
名称 | 功能说明 |
---|---|
MediaContainer.addTrack | 将音频或视频轨道添加到容器 |
MediaContainer.destroy | 将容器销毁,释放资源 |
MediaContainer.export | 将容器内的轨道合并并导出视频文件 |
MediaContainer.extractDataSource | 将传入的视频源分离轨道 |
MediaContainer.removeTrack | 将音频或视频轨道从容器中移除 |
MediaTrack | 可通过 MediaContainer.extractDataSource 返回 |
# 10.11 实时语音
请注意
以下 API 暂不支持
名称 | 功能说明 |
---|---|
ft.updateVoIPChatMuteConfig | 更新实时语音静音设置 |
ft.subscribeVoIPVideoMembers | 订阅视频画面成员 |
ft.setEnable1v1Chat | 开启双人通话 |
ft.onVoIPVideoMembersChanged | 监听实时语音通话成员视频状态变化事件 |
ft.onVoIPChatStateChanged | 监听房间状态变化事件 |
ft.onVoIPChatSpeakersChanged | 监听实时语音通话成员通话状态变化事件 |
ft.onVoIPChatMembersChanged | 监听实时语音通话成员在线状态变化事件 |
ft.offVoIPChatSpeakersChanged | 移除实时语音通话成员通话状态变化事件的监听函数 |
ft.onVoIPChatInterrupted | 监听被动断开实时语音通话事件 |
ft.offVoIPVideoMembersChanged | 取消监听实时语音通话成员视频状态变化事件 |
ft.offVoIPChatStateChanged | 取消监听房间状态变化事件 |
ft.offVoIPChatMembersChanged | 取消监听实时语音通话成员在线状态变化事件 |
ft.offVoIPChatInterrupted | 取消监听被动断开实时语音通话事件 |
ft.joinVoIPChat | 加入 (创建) 实时语音通话,更多信息可见 实时语音指南 |
ft.exitVoIPChat | 退出(销毁)实时语音通话 |
ft.join1v1Chat | 加入(创建)双人通话 |
# 10.12 画面录制器
名称 | 功能说明 | 版本 | 备注 |
---|---|---|---|
ft.createMediaRecorder | 创建 WebGL 画面录制器,可逐帧录制在 WebGL 上渲染的画面并导出视频文件 | 1.0.0 |
# 10.12.1 MediaRecorder
名称 | 功能说明 | 版本 | 备注 |
---|---|---|---|
MediaRecorder.pause | 暂停录制 | 1.0.0 | |
MediaRecorder.resume | 恢复录制 | 1.0.0 | |
MediaRecorder.start | 开始录制 | 1.0.0 | |
MediaRecorder.stop | 结束录制 | 1.0.0 |
请注意
以下 API 暂不支持
名称 | 功能说明 |
---|---|
MediaRecorder.destroy | 销毁录制器 |
MediaRecorder.off | 取消监听录制事件 |
MediaRecorder.on | 注册监听录制事件的回调函数 |
MediaRecorder.requestFrame | 请求下一帧录制,在 callback 里完成一帧渲染后开始录制当前帧 |
# 10.13 视频解码器
请注意
以下 API 暂不支持
名称 | 功能说明 |
---|---|
ft.createVideoDecoder | 创建视频解码器,可逐帧获取解码后的数据 |
# 10.13.1 VideoDecoder
请注意
以下 API 暂不支持
名称 | 功能说明 |
---|---|
VideoDecoder.getFrameData | 获取下一帧的解码数据 |
VideoDecoder.off | 取消监听录制事件 |
VideoDecoder.on | 注册监听录制事件的回调函数 |
VideoDecoder.remove | 移除解码器 |
VideoDecoder.seek | 跳到某个时间点解码 |
VideoDecoder.start | 开始解码 |
VideoDecoder.stop | 停止解码 |
# 11. 位置
名称 | 功能说明 | 版本 | 备注 |
---|---|---|---|
ft.openLocation | 使用内置地图查看位置 | 1.0.0 | |
ft.startLocationUpdate | 开启小程序进入前台时接收位置消息 | 1.0.0 | |
ft.getLocation | 获取当前的地理位置、速度 | 1.0.0 | |
ft.choosePoi | 打开POI列表选择位置,支持模糊定位(精确到市)和精确定位混选 | 2.12.1 | |
ft.chooseLocation | 打开地图选择位置 | 1.0.0 | |
ft.stopLocationUpdate | 关闭监听实时位置变化,前后台都停止消息接收 | 3.0.18 | |
ft.startLocationUpdateBackground | 开启小程序进入前后台时均接收位置消息,需引导用户开启授权 | 3.0.18 | |
ft.onLocationChange | 监听实时地理位置变化事件,需结合 ft.startLocationUpdateBackground、wx.startLocationUpdate使用 | 3.0.18 | |
ft.offLocationChange | 取消监听实时地理位置变化事件 | 3.0.18 | |
ft.onLocationChangeError | 监听持续定位接口返回失败时触发 | 3.0.18 | |
ft.offLocationChangeError | 移除持续定位接口返回失败时触发 | 3.0.18 |
请注意
以下 API 暂不支持
名称 | 功能说明 |
---|---|
getFuzzyLocation | 获取当前的模糊地理位置 |
# 12. 文件
名称 | 功能说明 | 版本 | 备注 |
---|---|---|---|
ft.saveFile | 保存文件到本地 | 1.0.0 | |
ft.removeSavedFile | 删除本地缓存文件 | 1.0.0 | |
ft.openDocument | 新开页面打开文档 | 1.0.0 | |
ft.getSavedFileList | 获取该小程序下已保存的本地缓存文件列表 | 1.0.0 | |
ft.getSavedFileInfo | 获取本地文件的文件信息 | 1.0.0 | |
ft.getFileSystemManager | 获取全局唯一的文件管理器 | 1.0.0 | |
ft.getFileInfo | 获取文件信息 | 1.0.0 | |
ft.saveFileToDisk | 保存文件系统的文件到用户磁盘,仅在 PC 端支持 | 1.0.0 |
# 12.1 FileSystemManager
# 12.2 Stats
名称 | 功能说明 | 版本 | 备注 |
---|---|---|---|
Stats.isDirectory | 判断当前文件是否一个目录 | 1.0.0 | |
Stats.isFile | 判断当前文件是否一个普通文件 | 1.0.0 | |
WriteResult | 文件写入结果 | 1.0.0 |
# 13. 开放接口
# 13.1 登录
请注意
- 以下 API 需要集成扩展SDK或者需要App实现相应的代理方法。
- 您可以点击 这里 了解如何在小程序中复用微信登录能力。
名称 | 功能说明 | 版本 | 备注 |
---|---|---|---|
ft.login | 调用接口获取登录凭证(code) | 1.0.0 | |
ft.checkSession | 检查登录态是否过期 | 1.0.0 |
请注意
以下 API 暂不支持
名称 | 功能说明 |
---|---|
ft.pluginLogin | 该接口仅在小程序插件中可调用,调用接口获得插件用户标志凭证(code) |
# 13.2 帐号信息
名称 | 功能说明 | 版本 | 备注 |
---|---|---|---|
ft.getAccountInfoSync | 获取当前帐号信息 | 1.0.0 |
# 13.3 用户信息
请注意
名称 | 功能说明 | 版本 | 备注 |
---|---|---|---|
ft.getUserProfile | 获取用户信息 | 1.0.0 | 注意使用该api需要集成微信扩展SDK |
ft.getUserInfo | 获取用户信息 | 1.0.0 | 注意使用该api需要App实现代理方法 |
UserInfo | 用户信息 | 1.0.0 |
# 13.4 授权
名称 | 功能说明 | 版本 | 备注 |
---|---|---|---|
ft.authorize | 提前向用户发起授权请求 | 1.0.0 |
请注意
以下 API 暂不支持
名称 | 功能说明 |
---|---|
ft.authorizeForMiniProgram | 仅小程序插件中能调用该接口,用法同 ft.authorize |
# 13.5 设置
名称 | 功能说明 | 版本 | 备注 |
---|---|---|---|
ft.openSetting | 调起客户端小程序设置界面,返回用户设置的操作结果 | 1.0.0 | |
ft.getSetting | 获取用户的当前设置 | 1.0.0 | |
AuthSetting | 用户授权设置信息,详情参考权限 | 1.0.0 |
请注意
以下 API 暂不支持
名称 | 功能说明 |
---|---|
SubscriptionsSetting | 订阅消息设置 |
# 13.6 收货地址
请注意
以下 API 暂不支持
名称 | 功能说明 |
---|---|
ft.chooseAddress | 获取用户收货地址 |
# 13.7 卡券
请注意
以下 API 暂不支持
名称 | 功能说明 |
---|---|
ft.openCard | 查看微信卡包中的卡券 |
ft.addCard | 批量添加卡券 |
# 13.8 发票
请注意
以下 API 暂不支持
名称 | 功能说明 |
---|---|
ft.chooseInvoiceTitle | 选择用户的发票抬头 |
ft.chooseInvoice | 选择用户已有的发票 |
# 13.9 生物认证
请注意
以下 API 暂不支持
名称 | 功能说明 |
---|---|
ft.startSoterAuthentication | 开始 SOTER 生物认证 |
ft.checkIsSupportSoterAuthentication | 获取本机支持的 SOTER 生物认证方式 |
ft.checkIsSoterEnrolledInDevice | 获取设备内是否录入如指纹等生物信息的接口 |
# 13.10 微信运动
请注意
以下 API 暂不支持
名称 | 功能说明 |
---|---|
ft.shareToWeRun | 分享数据到微信运动 |
ft.getWeRunData | 获取用户过去三十天微信运动步数 |
# 13.11 订阅消息
请注意
以下 API 暂不支持
名称 | 功能说明 |
---|---|
ft.requestSubscribeMessage | 调起客户端小程序订阅消息界面,返回用户订阅消息的操作结果 |
ft.requestSubscribeDeviceMessage | 订阅设备消息接口,调用后弹出授权框 |
# 13.12 微信红包
请注意
以下 API 暂不支持
名称 | 功能说明 |
---|---|
ft.showRedPackage | 拉取 h5 领取红包封面页 |
# 13.13 收藏
请注意
以下 API 暂不支持
名称 | 功能说明 |
---|---|
ft.addVideoToFavorites | 收藏视频 |
ft.addFileToFavorites | 收藏文件 |
# 13.14 车牌
请注意
以下 API 暂不支持
名称 | 功能说明 |
---|---|
ft.chooseLicensePlate | 选择车牌号 |
# 13.15 视频号
请注意
以下 API 暂不支持
名称 | 功能说明 |
---|---|
ft.reserveChannelsLive | 预约视频号直播 |
ft.openChannelsUserProfile | 打开视频号主页 |
ft.openChannelsEvent | 打开视频号活动页 |
ft.openChannelsLive | 打开视频号直播 |
ft.getChannelsShareKey | 获取视频号直播卡片/视频卡片的分享来源 |
ft.openChannelsActivity | 打开视频号视频 |
ft.getChannelsLiveNoticeInfo | 获取视频号直播预告信息 |
ft.getChannelsLiveInfo | 获取视频号直播信息 |
# 13.16 微信群
请注意
以下 API 暂不支持
名称 | 功能说明 |
---|---|
ft.getGroupEnterInfo | 获取微信群聊场景下的小程序启动信息 |
# 13.17 微信客服
请注意
以下 API 暂不支持
名称 | 功能说明 |
---|---|
ft.openCustomerServiceChat | 打开微信客服 |
# 14. 设备
# 14.1 蓝牙-通用
名称 | 功能说明 | 版本 | 备注 |
---|---|---|---|
ft.stopBluetoothDevicesDiscovery | 停止搜寻附近的蓝牙外围设备 | 1.0.0 | |
ft.startBluetoothDevicesDiscovery | 开始搜寻附近的蓝牙外围设备 | 1.0.0 | |
ft.openBluetoothAdapter | 初始化蓝牙模块 | 1.0.0 | |
ft.onBluetoothDeviceFound | 监听搜索到新设备的事件 | 1.0.0 | |
ft.onBluetoothAdapterStateChange | 监听蓝牙适配器状态变化事件 | 1.0.0 | |
ft.offBluetoothDeviceFound | 取消监听寻找到新设备的事件 | 1.0.0 | |
ft.offBluetoothAdapterStateChange | 取消监听蓝牙适配器状态变化事件 | 1.0.0 | |
ft.makeBluetoothPair | 蓝牙配对接口,仅安卓支持 | 1.0.0 | |
ft.getConnectedBluetoothDevices | 根据主服务 UUID 获取已连接的蓝牙设备 | 1.0.0 | |
ft.getBluetoothDevices | 获取在蓝牙模块生效期间所有搜索到的蓝牙设备 | 1.0.0 | |
ft.getBluetoothAdapterState | 获取本机蓝牙适配器状态 | 1.0.0 | |
ft.closeBluetoothAdapter | 关闭蓝牙模块 | 1.0.0 |
# 14.2 蓝牙-低功耗中心设备
名称 | 功能说明 | 版本 | 备注 |
---|---|---|---|
ft.writeBLECharacteristicValue | 向蓝牙低功耗设备特征值中写入二进制数据 | 1.0.0 | |
ft.setBLEMTU | 协商设置蓝牙低功耗的最大传输单元 (Maximum Transmission Unit, MTU) | 1.0.0 | |
ft.readBLECharacteristicValue | 读取蓝牙低功耗设备特征值的二进制数据 | 1.0.0 | |
ft.onBLEConnectionStateChange | 监听蓝牙低功耗连接状态的改变事件 | 1.0.0 | |
ft.onBLECharacteristicValueChange | 监听蓝牙低功耗设备的特征值变化事件 | 1.0.0 | |
ft.offBLEConnectionStateChange | 取消监听蓝牙低功耗连接状态的改变事件 | 1.0.0 | |
ft.offBLECharacteristicValueChange | 取消监听蓝牙低功耗设备的特征值变化事件 | 1.0.0 | |
ft.notifyBLECharacteristicValueChange | 启用蓝牙低功耗设备特征值变化时的 notify 功能,订阅特征 | 1.0.0 | |
ft.getBLEDeviceServices | 获取蓝牙低功耗设备所有服务 (service) | 1.0.0 | |
ft.getBLEDeviceRSSI | 获取蓝牙低功耗设备的信号强度 (Received Signal Strength Indication, RSSI) | 1.0.0 | |
ft.getBLEDeviceCharacteristics | 获取蓝牙低功耗设备某个服务中所有特征 (characteristic) | 1.0.0 | |
ft.createBLEConnection | 连接蓝牙低功耗设备 | 1.0.0 | |
ft.closeBLEConnection | 断开与蓝牙低功耗设备的连接 | 1.0.0 |
请注意
以下 API 暂不支持
名称 | 功能说明 |
---|---|
ft.isBluetoothDevicePaired | 查询蓝牙设备是否配对,仅安卓支持 |
ft.onBLEMTUChange | 监听蓝牙低功耗的最大传输单元变化事件(仅安卓触发) |
ft.offBLEMTUChange | 移除蓝牙低功耗的最大传输单元变化事件的监听函数 |
ft.getBLEMTU | 获取蓝牙低功耗的最大传输单元 |
# 14.3 蓝牙-低功耗外围设备
名称 | 功能说明 | 版本 | 备注 |
---|---|---|---|
ft.onBLEPeripheralConnectionStateChanged | 监听当前外围设备被连接或断开连接事件 | 1.0.0 | |
ft.offBLEPeripheralConnectionStateChanged | 取消监听当前外围设备被连接或断开连接事件 | 1.0.0 | |
ft.createBLEPeripheralServer | 建立本地作为蓝牙低功耗外围设备的服务端,可创建多个 | 1.0.0 |
# 14.3.1 BLEPeripheralServer
名称 | 功能说明 | 版本 | 备注 |
---|---|---|---|
BLEPeripheralServer.addService | 添加服务 | 1.0.0 | |
BLEPeripheralServer.close | 关闭当前服务端 | 1.0.0 | |
BLEPeripheralServer.offCharacteristicReadRequest | 取消监听已连接的设备请求读当前外围设备的特征值事件 | 1.0.0 | |
BLEPeripheralServer.offCharacteristicSubscribed | 取消监听特征值订阅事件 | 1.0.0 | |
BLEPeripheralServer.offcharacteristicUnsubscribed | 取消监听取消特征值订阅事件 | 1.0.0 | |
BLEPeripheralServer.offCharacteristicWriteRequest | 取消监听已连接的设备请求写当前外围设备的特征值事件 | 1.0.0 | |
BLEPeripheralServer.onCharacteristicReadRequest | 监听已连接的设备请求读当前外围设备的特征值事件 | 1.0.0 | |
BLEPeripheralServer.onCharacteristicSubscribed | 监听特征值订阅事件,仅 iOS 支持 | 1.0.0 | |
BLEPeripheralServer.onCharacteristicUnsubscribed | 监听取消特征值订阅事件,仅 iOS 支持 | 1.0.0 | |
BLEPeripheralServer.onCharacteristicWriteRequest | 监听已连接的设备请求写当前外围设备的特征值事件 | 1.0.0 | |
BLEPeripheralServer.removeService | 移除服务 | 1.0.0 | |
BLEPeripheralServer.startAdvertising | 开始广播本地创建的外围设备 | 1.0.0 | |
BLEPeripheralServer.stopAdvertising | 停止广播 | 1.0.0 | |
BLEPeripheralServer.writeCharacteristicValue | 往指定特征值写入数据,并通知已连接的主机,从机的特征值已发生变化,该接口会处理是走回包还是走订阅 | 1.0.0 |
# 14.4 蓝牙-信标(Beacon)
名称 | 功能说明 | 版本 | 备注 |
---|---|---|---|
ft.stopBeaconDiscovery | 停止搜索附近的 Beacon 设备 | 1.0.0 | |
ft.startBeaconDiscovery | 开始搜索附近的 Beacon 设备 | 1.0.0 | |
ft.onBeaconUpdate | 监听 Beacon 设备更新事件,仅能注册一个监听 | 1.0.0 | |
ft.onBeaconServiceChange | 监听 Beacon 服务状态变化事件,仅能注册一个监听 | 1.0.0 | |
ft.offBeaconUpdate | 取消监听 Beacon 设备更新事件 | 1.0.0 | |
ft.offBeaconServiceChange | 取消监听 Beacon 服务状态变化事件 | 1.0.0 | |
ft.getBeacons | 获取所有已搜索到的 Beacon 设备 | 1.0.0 | |
BeaconInfo | Beacon 设备 | 1.0.0 |
# 14.5 NFC
请注意
以下 API 暂不支持
名称 | 功能说明 |
---|---|
ft.stopHCE | 关闭 NFC 模块 |
ft.startHCE | 初始化 NFC 模块 |
ft.sendHCEMessage | 发送 NFC 消息 |
ft.onHCEMessage | 监听接收 NFC 设备消息事件,仅能注册一个监听 |
ft.offHCEMessage | 接收 NFC 设备消息事件,取消事件监听 |
ft.getNFCAdapter | 获取 NFC 实例 |
ft.getHCEState | 判断当前设备是否支持 HCE 能力 |
# 14.5.1 IsoDep
请注意
以下 API 暂不支持
名称 | 功能说明 |
---|---|
IsoDep.close | 断开连接 |
IsoDep.connect | 连接 NFC 标签 |
IsoDep.getHistoricalBytes | 获取复位信息 |
IsoDep.getMaxTransceiveLength | 获取最大传输长度 |
IsoDep.isConnected | 检查是否已连接 |
IsoDep.setTimeout | 设置超时时间 |
IsoDep.transceive | 发送数据 |
# 14.5.2 MifareClassic
请注意
以下 API 暂不支持
名称 | 功能说明 |
---|---|
MifareClassic.close | 断开连接 |
MifareClassic.connect | 连接 NFC 标签 |
MifareClassic.getMaxTransceiveLength | 获取最大传输长度 |
MifareClassic.isConnected | 检查是否已连接 |
MifareClassic.setTimeout | 设置超时时间 |
MifareClassic.transceive | 发送数据 |
# 14.5.2 MifareUltralight
请注意
以下 API 暂不支持
名称 | 功能说明 |
---|---|
MifareUltralight.close | 断开连接 |
MifareUltralight.connect | 连接 NFC 标签 |
MifareUltralight.getMaxTransceiveLength | 获取最大传输长度 |
MifareUltralight.isConnected | 检查是否已连接 |
MifareUltralight.setTimeout | 设置超时时间 |
MifareUltralight.transceive | 发送数据 |
# 14.5.3 Ndef
请注意
以下 API 暂不支持
名称 | 功能说明 |
---|---|
Ndef.close | 断开连接 |
Ndef.connect | 连接 NFC 标签 |
Ndef.isConnected | 检查是否已连接 |
Ndef.offNdefMessage | 取消监听 Ndef 消息 |
Ndef.onNdefMessage | 监听 Ndef 消息 |
Ndef.setTimeout | 设置超时时间 |
Ndef.writeNdefMessage | 重写 Ndef 标签内容 |
# 14.5.4 NfcA
请注意
以下 API 暂不支持
名称 | 功能说明 |
---|---|
NfcA.close | 断开连接 |
NfcA.connect | 连接 NFC 标签 |
NfcA.getAtqa | 获取ATQA信息 |
NfcA.getMaxTransceiveLength | 获取最大传输长度 |
NfcA.getSak | 获取SAK信息 |
NfcA.isConnected | 检查是否已连接 |
NfcA.setTimeout | 设置超时时间 |
NfcA.transceive | 发送数据 |
# 14.5.5 NFCAdapter
请注意
以下 API 暂不支持
名称 | 功能说明 |
---|---|
NFCAdapter.getIsoDep | 获取IsoDep实例,实例支持ISO-DEP (ISO 14443-4)标准的读写 |
NFCAdapter.getMifareClassic | 获取MifareClassic实例,实例支持MIFARE Classic标签的读写 |
NFCAdapter.getMifareUltralight | 获取MifareUltralight实例,实例支持MIFARE Ultralight标签的读写 |
NFCAdapter.getNdef | 获取Ndef实例,实例支持对NDEF格式的NFC标签上的NDEF数据的读写 |
NFCAdapter.getNfcA | 获取NfcA实例,实例支持NFC-A (ISO 14443-3A)标准的读写 |
NFCAdapter.getNfcB | 获取NfcB实例,实例支持NFC-B (ISO 14443-3B)标准的读写 |
NFCAdapter.getNfcF | 获取NfcF实例,实例支持NFC-F (JIS 6319-4)标准的读写 |
NFCAdapter.getNfcV | 获取NfcV实例,实例支持NFC-V (ISO 15693)标准的读写 |
NFCAdapter.offDiscovered | 取消监听 NFC Tag |
NFCAdapter.onDiscovered | 监听 NFC Tag |
NFCAdapter.startDiscovery | |
NFCAdapter.stopDiscovery |
# 14.5.6 NfcB
请注意
以下 API 暂不支持
名称 | 功能说明 |
---|---|
NfcB.close | 断开连接 |
NfcB.connect | 连接 NFC 标签 |
NfcB.getMaxTransceiveLength | 获取最大传输长度 |
NfcB.isConnected | 检查是否已连接 |
NfcB.setTimeout | 设置超时时间 |
NfcB.transceive | 发送数据 |
# 14.5.7 NfcF
请注意
以下 API 暂不支持
名称 | 功能说明 |
---|---|
NfcF.close | 断开连接 |
NfcF.connect | 连接 NFC 标签 |
NfcF.getMaxTransceiveLength | 获取最大传输长度 |
NfcF.isConnected | 检查是否已连接 |
NfcF.setTimeout | 设置超时时间 |
NfcF.transceive | 发送数据 |
# 14.5.7 NfcV
请注意
以下 API 暂不支持
名称 | 功能说明 |
---|---|
NfcV.close | 断开连接 |
NfcV.connect | 连接 NFC 标签 |
NfcV.getMaxTransceiveLength | 获取最大传输长度 |
NfcV.isConnected | 检查是否已连接 |
NfcV.setTimeout | 设置超时时间 |
NfcV.transceive | 发送数据 |
# 14.6 Wi-Fi
请注意
以下 API 暂不支持
名称 | 功能说明 |
---|---|
ft.stopWifi | 关闭 Wi-Fi 模块 |
ft.startWifi | 初始化 Wi-Fi 模块 |
ft.setWifiList | 设置 wifiList 中 AP 的相关信息 |
ft.onWifiConnected | 监听连接上 Wi-Fi 的事件 |
ft.onGetWifiList | 监听获取到 Wi-Fi 列表数据事件 |
ft.getWifiList | 请求获取 Wi-Fi 列表 |
ft.getConnectedWifi | 获取已连接中的 Wi-Fi 信息 |
ft.connectWifi | 连接 Wi-Fi |
ft.onWifiConnectedWithPartialInfo | 监听连接上 Wi-Fi 的事件 |
ft.offWifiConnectedWithPartialInfo | 移除连接上 Wi-Fi 的事件的监听函数 |
ft.offWifiConnected | 取消监听连接上 Wi-Fi 的事件 |
ft.offGetWifiList | 取消监听获取到 Wi-Fi 列表数据事件 |
WifiInfo | Wifi 信息 |
# 14.7 日历
请注意
以下 API 暂不支持
名称 | 功能说明 |
---|---|
ft.addPhoneRepeatCalendar | 向系统日历添加重复事件 |
ft.addPhoneCalendar | 向系统日历添加事件 |
# 14.8 联系人
名称 | 功能说明 | 版本 | 备注 |
---|---|---|---|
ft.addPhoneContact | 添加手机通讯录联系人 | 1.0.0 | |
ft.chooseContact | 拉起手机通讯录,选择联系人 | 1.0.0 |
请注意
以下 API 暂不支持
名称 | 功能说明 |
---|---|
ft.searchContacts | 查找通讯录,匹配相近的手机号 |
# 14.9 无障碍
名称 | 功能说明 | 版本 | 备注 |
---|---|---|---|
ft.checkIsOpenAccessibility | 检测是否开启视觉无障碍功能 | 2.12.1 |
# 14.10 电量
名称 | 功能说明 | 版本 | 备注 |
---|---|---|---|
ft.getBatteryInfoSync | ft.getBatteryInfo 的同步版本 | 1.0.0 | |
ft.getBatteryInfo | 获取设备电量 | 1.0.0 |
# 14.11 剪贴板
名称 | 功能说明 | 版本 | 备注 |
---|---|---|---|
ft.setClipboardData | 设置系统剪贴板的内容 | 1.0.0 | |
ft.getClipboardData | 获取系统剪贴板的内容 | 1.0.0 |
# 14.12 网络
名称 | 功能说明 | 版本 | 备注 |
---|---|---|---|
ft.onNetworkStatusChange | 监听网络状态变化事件 | 1.0.0 | |
ft.offNetworkStatusChange | 取消监听网络状态变化事件,参数为空,则取消所有的事件监听 | 1.0.0 | |
ft.getNetworkType | 获取网络类型 | 1.0.0 |
请注意
以下 API 暂不支持
名称 | 功能说明 |
---|---|
ft.onNetworkWeakChange | 监听弱网状态变化事件 |
ft.getLocalIPAddress | 获取局域网IP地址 |
ft.offNetworkWeakChange | 移除弱网状态变化事件的监听函数 |
# 14.13 加密
名称 | 功能说明 | 版本 | 备注 |
---|---|---|---|
ft.getRandomValues | 获取密码学安全随机数 | 1.0.0 |
# 14.14 屏幕
名称 | 功能说明 | 版本 | 备注 |
---|---|---|---|
ft.setVisualEffectOnCapture | 设置截屏/录屏时屏幕表现,仅支持在 Android 端调用 | 2.12.16 | |
ft.setScreenBrightness | 设置屏幕亮度 | 1.0.0 | |
ft.setKeepScreenOn | 设置是否保持常亮状态 | 1.3.9 | |
ft.onUserCaptureScreen | 监听用户主动截屏事件 | 1.0.0 | |
ft.onScreenRecordingStateChanged | 监听用户录屏事件 | 2.12.16 | |
ft.offUserCaptureScreen | 用户主动截屏事件 | 1.0.0 | |
ft.offScreenRecordingStateChanged | 移除用户录屏事件的监听函数 | 2.12.16 | |
ft.getScreenRecordingState | 查询用户是否在录屏 | 2.12.16 | |
ft.getScreenBrightness | 获取屏幕亮度 | 1.0.0 |
# 14.15 键盘
名称 | 功能说明 | 版本 | 备注 |
---|---|---|---|
ft.onKeyboardHeightChange | 监听键盘高度变化 | 1.0.0 | |
ft.offKeyboardHeightChange | 取消监听键盘高度变化事件 | 1.0.0 | |
ft.hideKeyboard | 在input、textarea等focus拉起键盘之后,手动调用此接口收起键盘 | 1.0.0 | |
ft.getSelectedTextRange | 在input、textarea等focus之后,获取输入框的光标位置 | 1.0.0 |
# 14.16 电话
名称 | 功能说明 | 版本 | 备注 |
---|---|---|---|
ft.makePhoneCall | 拨打电话 | 1.0.0 |
# 14.17 加速计
名称 | 功能说明 | 版本 | 备注 |
---|---|---|---|
ft.stopAccelerometer | 停止监听加速度数据 | 1.0.0 | |
ft.startAccelerometer | 开始监听加速度数据 | 1.0.0 | |
ft.onAccelerometerChange | 监听加速度数据事件 | 1.0.0 | |
ft.offAccelerometerChange | 取消监听加速度数据事件,参数为空,则取消所有的事件监听 | 1.0.0 |
# 14.18 罗盘
名称 | 功能说明 | 版本 | 备注 |
---|---|---|---|
ft.stopCompass | 停止监听罗盘数据 | 1.0.0 | |
ft.startCompass | 开始监听罗盘数据 | 1.0.0 | |
ft.onCompassChange | 监听罗盘数据变化事件 | 1.0.0 | |
ft.offCompassChange | 取消监听罗盘数据变化事件,参数为空,则取消所有的事件监听 | 1.0.0 |
# 14.19 设备方向
请注意
以下 API 暂不支持
名称 | 功能说明 |
---|---|
ft.stopDeviceMotionListening | 停止监听设备方向的变化 |
ft.startDeviceMotionListening | 开始监听设备方向的变化 |
ft.onDeviceMotionChange | 监听设备方向变化事件 |
ft.offDeviceMotionChange | 取消监听设备方向变化事件,参数为空,则取消所有的事件监听 |
# 14.20 陀螺仪
请注意
以下 API 暂不支持
名称 | 功能说明 |
---|---|
ft.stopGyroscope | 停止监听陀螺仪数据 |
ft.startGyroscope | 开始监听陀螺仪数据 |
ft.onGyroscopeChange | 监听陀螺仪数据变化事件 |
ft.offGyroscopeChange | 取消监听陀螺仪数据变化事件 |
# 14.21 内存
请注意
以下 API 暂不支持
名称 | 功能说明 |
---|---|
ft.onMemoryWarning | 监听内存不足告警事件 |
ft.offMemoryWarning | 取消监听内存不足告警事件 |
# 14.22 扫码
名称 | 功能说明 | 版本 | 备注 |
---|---|---|---|
ft.scanCode | 调起客户端扫码界面进行扫码 | 1.0.0 |
# 15.23 振动
名称 | 功能说明 | 版本 | 备注 |
---|---|---|---|
ft.vibrateShort | 使手机发生较短时间的振动(15 ms) | 1.0.0 | |
ft.vibrateLong | 使手机发生较长时间的振动(400 ms) | 1.0.0 |
# 14.24 短信
请注意
以下 API 暂不支持
名称 | 功能说明 |
---|---|
ft.sendSms | 拉起手机发送短信界面 |
# 15. AI
# 15.1 视觉算法
请注意
以下 API 暂不支持
名称 | 功能说明 |
---|---|
ft.isVKSupport | 判断支持版本 |
ft.createVKSession | 创建 vision kit 会话对象 |
VKBodyAnchor | 人体 anchor |
# 15.2 VKCamera
请注意
以下 API 暂不支持
名称 | 功能说明 |
---|---|
VKCamera.getProjectionMatrix | 获取投影矩阵 |
VKFaceAnchor | 人脸 anchor |
# 15.3 VKFrame
请注意
以下 API 暂不支持
名称 | 功能说明 |
---|---|
VKFrame.getCameraBuffer | 获取当前帧 rgba buffer |
VKFrame.getCameraTexture | 获取当前帧纹理,目前只支持 YUV 纹理 |
VKFrame.getDisplayTransform | 获取纹理调整矩阵 |
VKMarkerAnchor | marker anchor |
VKOSDAnchor | OSD anchor |
VKHandAnchor | 手势 anchor |
VKPlaneAnchor | 平面 anchor,只有 v2 版本支持 |
# 15.4 VKSession
请注意
以下 API 暂不支持
名称 | 功能说明 |
---|---|
VKSession.addMarker | 添加一个 marker,要求调 ft.createVKSession 时传入的 track.marker 为 true |
VKSession.addOSDMarker | 添加一个 OSD marker(one-shot detection marker),要求调 ft.createVKSession 时传入的 track.OSD 为 true |
VKSession.cancelAnimationFrame | 取消由 requestAnimationFrame 添加到计划中的动画帧请求 |
VKSession.destroy | 销毁会话 |
VKSession.detectFace | 静态图像人脸关键点检测 |
VKSession.getAllMarker | 获取所有 marker,要求调 ft.createVKSession 时传入的 track.marker 为 true |
VKSession.getAllOSDMarker | 获取所有 OSD marker,要求调 ft.createVKSession 时传入的 track.OSD 为 true |
VKSession.getVKFrame | 获取帧对象,每调用一次都会触发一次帧分析过程 |
VKSession.hitTest | 触摸检测,v1 版本只支持单平面(即 hitTest 生成一次平面后,后续 hitTest 均不会再生成平面,而是以之前生成的平面为基础进行检测) |
VKSession.detectHand | 静态图像手势关键点检测。当 ft.createVKSession 参数传入 {track: {hand: {mode: 2} } } 时可用。 |
VKSession.detectBody | 静态图像人体关键点检测。当 ft.createVKSession 参数传入 {track: {body: {mode: 2} } } 时可用。 |
VKSession.off | 取消监听会话事件 |
VKSession.on | 监听会话事件 |
VKSession.runOCR | 静态图像 OCR 检测。当 ft.createVKSession 参数传入 {track: {OCR: {mode: 2} } } 时可用。 |
VKSession.removeMarker | 删除一个 marker,要求调 ft.createVKSession 时传入的 track.marker 为 true |
VKSession.removeOSDMarker | 删除一个 OSD marker,要求调 ft.createVKSession 时传入的 track.OSD 为 true |
VKSession.requestAnimationFrame | 在下次进行重绘时执行 |
VKSession.start | 开启会话 |
VKSession.stop | 停止会话 |
VKSession.updateOSDThreshold | 更新 OSD 识别精确度,要求调 ft.createVKSession 时传入的 track.OSD 为 true |
# 15.5 人脸识别
请注意
以下 API 暂不支持。
名称 | 功能说明 |
---|---|
ft.stopFaceDetect | 停止人脸识别 |
ft.initFaceDetect | 初始化人脸识别 |
ft.faceDetect | 人脸识别,使用前需要通过 ft.initFaceDetect 进行一次初始化,推荐使用相机接口返回的帧数据 |
# 16. Worker
请注意
以下 API 暂不支持
名称 | 功能说明 |
---|---|
ft.createWorker | 创建一个 Worker 线程 |
# 16.1 Worker
请注意
以下 API 暂不支持
名称 | 功能说明 |
---|---|
Worker.getCameraFrameData | 获取摄像头当前帧图像,返回ArrayBuffer数据 |
Worker.onMessage | 监听主线程/Worker 线程向当前线程发送的消息的事件 |
Worker.onProcessKilled | 监听 worker线程被系统回收事件(当iOS系统资源紧张时,worker线程存在被系统回收的可能,开发者可监听此事件并重新创建一个worker) |
Worker.postMessage | 向主线程/Worker 线程发送的消息 |
Worker.terminate | 结束当前 Worker 线程 |
Worker.testOnProcessKilled | 用于模拟 iOS ExperimentalWorker 线程被系统回收事件,以便于调试。接口仅在 worker 线程内可用。 |
# 17. FXML
名称 | 功能说明 | 版本 | 备注 |
---|---|---|---|
ft.createSelectorQuery | 返回一个 SelectorQuery 对象实例 | 1.0.0 | |
ft.createIntersectionObserver | 创建并返回一个 IntersectionObserver 对象实例 | 1.0.0 |
# 17.1 IntersectionObserver
名称 | 功能说明 | 版本 | 备注 |
---|---|---|---|
IntersectionObserver.disconnect | 停止监听 | 1.0.0 | |
IntersectionObserver.observe | 指定目标节点并开始监听相交状态变化情况 | 1.0.0 | |
IntersectionObserver.relativeTo | 使用选择器指定一个节点,作为参照区域之一 | 1.0.0 | |
IntersectionObserver.relativeToViewport | 指定页面显示区域作为参照区域之一 | 1.0.0 |
# 17.2 MediaQueryObserver
名称 | 功能说明 | 版本 | 备注 |
---|---|---|---|
MediaQueryObserver.disconnect | 停止监听 | 1.0.0 | |
MediaQueryObserver.observe | 开始监听页面 media query 变化情况 | 1.0.0 |
# 17.3 NodesRef
名称 | 功能说明 | 版本 | 备注 |
---|---|---|---|
NodesRef.boundingClientRect | 添加节点的布局位置的查询请求 | 1.0.0 | |
NodesRef.context | 添加节点的 Context 对象查询请求 | 1.0.0 | |
NodesRef.fields | 获取节点的相关信息 | 1.0.0 | |
NodesRef.scrollOffset | 添加节点的滚动位置查询请求 | 1.0.0 | |
NodesRef.node | 获取 Node 节点实例 | 2.12.12 |
# 17.4 SelectorQuery
名称 | 功能说明 | 版本 | 备注 |
---|---|---|---|
SelectorQuery.exec | 执行所有的请求 | 1.0.0 | |
SelectorQuery.in | 将选择器的选取范围更改为自定义组件 component 内 | 1.0.0 | |
SelectorQuery.select | 在当前页面下选择第一个匹配选择器 selector 的节点 | 1.0.0 | |
SelectorQuery.selectAll | 在当前页面下选择匹配选择器 selector 的所有节点 | 1.0.0 | |
SelectorQuery.selectViewport | 选择显示区域 | 1.0.0 |
# 18. 第三方平台
请注意
以下 API 暂不支持
名称 | 功能说明 |
---|---|
ft.getExtConfigSync | ft.getExtConfig 的同步版本 |
ft.getExtConfig | 获取第三方平台自定义的数据字段 |
# 19. 广告
请注意
以下 API 暂不支持
名称 | 功能说明 |
---|---|
ft.createRewardedVideoAd | 创建激励视频广告组件 |
ft.createInterstitialAd | 创建插屏广告组件 |
# 19.1 InterstitialAd
请注意
以下 API 暂不支持
名称 | 功能说明 |
---|---|
InterstitialAd.destroy | 销毁插屏广告实例 |
InterstitialAd.load | 加载插屏广告 |
InterstitialAd.offClose | 移除插屏广告关闭事件的监听函数 |
InterstitialAd.offError | 移除插屏错误事件的监听函数 |
InterstitialAd.offLoad | 移除插屏广告加载事件的监听函数 |
InterstitialAd.onClose | 监听插屏广告关闭事件 |
InterstitialAd.onError | 监听插屏错误事件 |
InterstitialAd.onLoad | 监听插屏广告加载事件 |
InterstitialAd.show | 显示插屏广告 |
# 19.2 RewardedVideoAd
请注意
以下 API 暂不支持
名称 | 功能说明 |
---|---|
RewardedVideoAd.destroy | 销毁激励视频广告实例 |
RewardedVideoAd.load | 加载激励视频广告 |
RewardedVideoAd.offClose | 移除用户点击 关闭广告 按钮的事件的监听函数 |
RewardedVideoAd.offError | 移除激励视频错误事件的监听函数 |
RewardedVideoAd.offLoad | 移除激励视频广告加载事件的监听函数 |
RewardedVideoAd.onClose | 监听用户点击 关闭广告 按钮的事件 |
RewardedVideoAd.onError | 监听激励视频错误事件 |
RewardedVideoAd.onLoad | 监听激励视频广告加载事件 |
RewardedVideoAd.show | 显示激励视频广告 |
# 20. 其他
名称 | 功能说明 |
---|---|
ft.onCustomEvent | 监听原生派发的onCustomEvent事件 |
ft.offCustomEvent | 取消监听原生派发的onCustomEvent事件 |
ft.getSuperviseInfo | 获取监控信息 |
ft.sendWebviewEvent | 小程序发送事件给 H5 |