1 应用场景

在苍穹移动端单据的开发过程中，经常会遇到需要调用APP接口的场景，例如扫码、定位、拍照等等。

通过调用APP的接口，开发者可以直接使用手机系统的能力，为用户提供更优质的网页体验。

目前，苍穹集成了云之家的大部分APP接口供移动端页面插件调用，企业微信、钉钉以及welink提供了部分接口（陆续支持），如下表：

【emoji】：支持【emoji】：不支持【emoji】️：后续支持

除此之外，想要了解云之家支持的其他接口，可以查看云之家开放平台提供的API文档，苍穹大部分都已集成进来。

2 调用方法

这里以调用“扫一扫”和“选择图片/拍照”接口为例，提供Java插件调用的示例代码。其他接口的调用方法均可以参照这两个例子，通过 callYZJApi 指令调用，接口参数需要参阅云之家开放平台文档。

1.调用“扫一扫”

HashMap map = new HashMap();
map.put("method", "scanQRCode"); //scanQRCode 为云之家方法名
HashMap args = new HashMap();
args.put("needResult", 1); //是否需要处理，默认为0，扫描结果由云之家处理，1则直接返回扫描结果
map.put("args", args);  //args 调用该云之家方法需要传递的参数
this.getView().executeClientCommand("callYZJApi", map);

2.调用“选择图片/拍照”

HashMap map = new HashMap();
map.put("method", "selectPic"); //selectPic 为云之家方法名
HashMap args = new HashMap();
args.put("type", "camera"); //类型，“camera”代表“相机”，“photo”代表“相册”，不传表示从相机、相册中选择
map.put("args", args);  //args 调用该云之家方法需要传递的参数
this.getView().executeClientCommand("callYZJApi", map);

3.监听客户端回调

//如调用该App方法会有回调，则进该事件
@Override
public void customEvent(CustomEventArgs e) {
    String eventName = e.getEventName();
    String value = e.getEventArgs();
    String key = e.getKey();
    if(key.equals("callAppMethod")){
        if(eventName.equals("scanQRCode")) {
            //扫码处理逻辑
        } else if (eventName.equals("selectPic")) {
            //选择图片/拍照处理逻辑
        }
    }
}

3 扩展方法

看到这里，可能有些开发会有疑问，如果用户不是使用以上提到的app，应该要怎么调用客户端的功能呢？

除了云之家、企业微信、钉钉和welink之外，如果集成到其他客户端的轻应用中，想要调用客户端API的功能，则需要通过自定义JS的方式扩展。

3.1 下载自定义JS模板

使用管理员登录苍穹，然后点击系统管理 -> 登录页配置 -> 高级设置 -> 下载模板，解压后有两个文件 index.js 和 index_m.js。

index.js 用于扩展web端的页面
index_m.js 用于扩展移动端页面

3.2 自定义JS开发

打开index_m.js文件，参考以下示例代码，编写自定义app插件。

(function () {
    /**
    * 自定义app插件入口
    * @param {*} loadjs 加载app需要的js资源，可选
    * @param {*} releaseResource 释放根页面资源，可选
    * @param callback 插件安装回调，插件生效，最后必须调用：callback({success:true})
    */
    window.initKDPlugin = function ({ loadjs, releaseResource }, callback) {
        // load插件需要的js桥文件
        loadjs('jsbridge.js', () => {
            window.KDPlugin = {
                setWebViewTitle: function (title) {
                    // todo：调用app的接口设置导航栏标题
                },
                scanQRCode: function (data = {}, callback) {
                    // todo：调用app的接口打开扫一扫
                }
            }
            callback({ success: true })//插件安装成功回调{success:false, error:'error info'}
        })
        //如果要支持额外多个平台不支持的app,需要根据window.navigator.userAgent类型来设置最终window.KDPlugin的值
    }
})();

3.3 上传自定义JS文件

将编写好的自定义JS文件压缩后上传至刚刚打开的登录页配置页面，并点击保存即可。

#往期推荐#

更多精彩内容，“码”上了解！↓

想获得移动端APP的能力？跟我学！

想获得移动端APP的能力？跟我学！

恭喜您！