概览

JSAPI 是对 JSBridge 的一个标准封装,​ 解决了移动网页能力不足的问题,开放了设备、媒体、存储、分享等几十个 API,让所有开发者都可以使用到 App 的原生能力,去完成一些之前做不到或者难以做到的事情。

APP: 该方法支持移动端小程序调用
PC: 该方法支持桌面端小程序调用
TV: 该方法支持轻应用调用
H5: 该方法支持网页应用调用

小程序接口

基础

名称 功能说明
ok.canIUse 判断 API 是否在当前版本可用
ok.login 获取登录凭证
ok.getVersion 获取小程序基础库版本号信息

界面

名称 功能说明
ok.showToast 显示消息提示框
ok.showLoading 显示 loading 提示框
ok.hideLoading 隐藏 loading 提示框
ok.showModal 显示模态对话框
ok.setNavigationBar 设置导航条
ok.showHistoryBack 导航栏显示返回按钮
ok.hideHistoryBack 导航栏隐藏返回按钮
ok.showNavigationBar 显示导航条
ok.hideNavigationBar 隐藏导航条

设备

名称 功能说明
ok.getSystemInfo 获取系统信息
ok.getNetworkType 获取网络类型
ok.setClipboardData 设置剪切板内容
ok.getClipboardData 获取剪切板内容
ok.vibrateLong 使手机发生较长时间的振动
ok.vibrateShort 使手机发生较端时间的振动
ok.setScreenBrightness 设置屏幕亮度
ok.getScreenBrightness 获取屏幕亮度
ok.setKeepScreenOn 设置保持常亮状态
ok.scanCode 调起客户端扫码界面进行扫码
ok.makePhoneCall 拨打电话
ok.getSysAuthorizeSetting 获取用户是否开启系统授权
ok.sysAuthorize 请求系统授权

跳转

名称 功能说明
ok.launchWebView 打开新页面窗口
ok.launchMiniProgram 客户端唤起微信小程序
ok.launchNative 小程序/H5 唤起原生页面
ok.launchApp 小程序/H5 唤起原生页面

存储

名称 功能说明
ok.setH5AppStorage 设置小程序数据缓存
ok.getH5AppStorage 获取小程序数据缓存
ok.removeH5AppStorage 移除小程序数据缓存
ok.clearH5AppStorage 清理小程序数据缓存

媒体

名称 功能说明
ok.chooseLocalImage 从本地相册选择图片
ok.clearLocalImage 清理当前小程序已选的图片数据
ok.chooseLocalVideo 从本地相册选择视频
ok.startRecord 开始录音
ok.onRecord 录音事件监听
ok.stopRecord 结束录音
ok.clearRecord 清理当前小程序已录音的临时文件
ok.saveMediaToAlbum 保存照片或视频到手机系统相册
ok.removeMediaToAlbum 删除手机系统相册的图片/视频
ok.openDocument 打开预览文档类型文件(TXT/DOC/EXCEL/PPT/PDF)
ok.playAudio 播放音频文件(MP3/OGG/WAV)
ok.playVideo 播放视频文件(MP4/AVI)

支付

名称 功能说明
ok.checkPayApp 检测当前手机是否安装支付应用程序

小程序

名称 功能说明
ok.launchH5App 打开/唤起一个小程序
ok.restartH5App 重启当前小程序
ok.closeH5App 关闭当前小程序
ok.getH5AppInfo 获取当前小程序基本信息
ok.loadH5AppPage 打开当前小程序的一个本地路径页面
ok.checkH5AppUpdate 检测小程序版本更新

位置

名称 功能说明
ok.getLocation 获取位置信息(经度、纬度)

文件

名称 功能说明
ok.chooseLocalFile 从本地文件中选择文件
ok.saveFile 保存照片/视频/文件到本地
ok.removeFile 删除手机某个本地文件
ok.clearFiles 清理当前小程序已选的文件数据

分享

名称 功能说明
ok.shareAppMessage 从客户端分享消息至微信社交平台
ok.shareMiniProgramMessage 客户端分享消息至小程序卡片
ok.shareToWechat 从客户端分享消息至微信 App 可选择(好友列表/朋友圈)

云存(天翼云盘)

名称 功能说明
ok.chooseEcloudImage 从云盘相册选择图片
ok.uploadToEcloud 上传文件(上传到天翼云盘,个人云-我的应用-xx 小程序目录)
ok.createEcloudDownload 天翼云盘原生下载文件
ok.pauseEcloudTrans 暂停天翼云盘传输列表内所有传输活动
ok.continueEcloudTrans 恢复天翼云盘传输列表内所有传输活动
ok.createEcloudUpload 将本地资源添加到天翼云盘原生上传任务队列
ok.openEcloudTransPanel 打开天翼云盘原生传输列表
ok.onEcloudProgressUpdate 天翼云盘传输任务监听接口

AI 图像处理

名称 功能说明
ok.generalBasicOCR 通用文字识别(OCR)
ok.changeFaceAge 人脸年龄变换
ok.swapFaceGender 人脸性别变换
ok.makeFaceCartoon 人脸动漫化
ok.morphFaceGradient 人脸渐变短视频合成(处理任务)
ok.queryFaceGradient 人脸渐变短视频合成(查询结果)
ok.fuseFaceFusion 人脸融合

地理信息类

名称 功能说明
ok.covertGeoCoding 地理编码转换(地址位置 -> 经纬度)
ok.reverseGeoCoding 拟地理编码(经纬度 -> 地址位置)
ok.getIpLocation 普通IP定位(IP地址 -> 地址位置)
ok.searchRegion 行政区划查询

PC 端(终端特性)

名称 功能说明
ok.isMaximized 检测小程序窗口是否最大化
ok.maximize 最大化小程序窗口
ok.minimize 最小化小程序窗口
ok.showMenuList 唤起小程序菜单
ok.showSceneList 切换小程序场景入口
ok.unmaximize 取消小程序窗口最大化

TV 端(终端特性)

名称 功能说明
ok.onKeyboardEvent 监听摇控按键事件
ok.disableKeyboardDefault 禁用摇控某个按键默认事件
ok.enableKeyboardDefault 启用摇控某个按键默认事件
ok.switchEAccount 轻应用内切换天翼账号
ok.launchEAccount 轻应用内登录天翼账号
  1. 1. 概览
    1. 1.1. 小程序接口
      1. 1.1.1. 基础
      2. 1.1.2. 界面
      3. 1.1.3. 设备
      4. 1.1.4. 跳转
      5. 1.1.5. 存储
      6. 1.1.6. 媒体
      7. 1.1.7. 支付
      8. 1.1.8. 小程序
      9. 1.1.9. 位置
      10. 1.1.10. 文件
      11. 1.1.11. 分享
      12. 1.1.12. 云存(天翼云盘)
      13. 1.1.13. AI 图像处理
      14. 1.1.14. 地理信息类
      15. 1.1.15. PC 端(终端特性)
      16. 1.1.16. TV 端(终端特性)