# 概述
U聊JS-SDK是U聊面向网页开发者提供的基于U聊内的网页开发工具包
通过使用U聊JS-SDK,网页开发者可借助U聊高效地使用拍照、选图、语音、位置等手机系统的能力,同时可以直接使用U聊分享、扫一扫等U聊特有的能力,为U聊用户提供更优质的网页体验。
# 引入JS文件
在需要调用JS接口的页面引入如下JS文件,(支持https):https://upchat.95516.net/public/scripts/app.upchat.js
js文件引入需在业务js之前,建议在<head>中引入
# 接口调用说明
JS-SDK提供的接口,除每个接口本身需要的业务参数,一般需要提供成功和错误回调这两个参数。
接口的成功回调函数success,都会统一返回status的值,若status == '0',则表示结果正确,其他情况可以提示为服务器内部错误;
接口的错误回调函数fail,若是用户需下载最新版app,则 iOS 返回'版本不支持',Android 返回 'Class not found' 或者 'Invalid action' ,其他情况提示用户错误信息。
# 基础接口
确保页面与 Native 完成桥接:UPCHAT.M.init(fn)
虽然我们已经建议在业务js加载之前引入 JS-SDK 文件,这只能保证JS接口方法已经注册,但不能保证已经能正常调用 Native 功能,因为 Cordova 框架在读入 HTML5代码之后,要进行 HTML5和 Native 建立桥接,在未能完成这个桥接的初始的情况下,是不能调用 Native 功能的。
因此,在调用 JS-SDK 接口前,需先调用 init 方法,通过回调的触发来判断与 Native 的桥接是否已完成。或者直接将接口调用方法作为 init 的回调。