Hybrid App交互方案-规范(一)

2020-11-21  本文已影响0人  代码

Android/iOS 功能交互

但是 Android 和 iOS 与 JS 交互的机制是不一样的,所以还需要制定一下统一的交互规则,方便 JS 进行方法调用。

Android 端调用可以直接拿到调用返回值:

let result = window._jh.api(); // 无参数 API 调用
let result = window._jh.api('eyJuYW1lIjogInRpdGxlIn0='); // 有参数 API 调用

参数解析格式:

{
    RequestId   : "9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d", // 唯一调用标识
    MethodName  : "getPlatformName", // 调用方法名称
    Params  : null | {}, // 要调用方法的参数
}
hybrid.notify("9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d", "eyJuYW1lIjogInRpdGxlIn0=");

iOS 端调用不能直接拿到调用返回值:

window.webkit.messageHandlers._jh.postMessage('eyJuYW1lIjogInRpdGxlIn0=');
{
    RequestId   : "9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d", // 唯一调用标识
    MethodName  : "getPlatformName", // 调用方法名称
    Params  : null | {}, // 要调用方法的参数
}
hybrid.notify("9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d", "eyJuYW1lIjogInRpdGxlIn0=");

交互消息通知

在很多 App 场景下,H5 页面在运行过程中也需要根据系统运行状态及时的发生改变,但是 H5 没有后台运行的能力,这会导致在有些业务流程中,跳转到了原生界面进行信息采集,但是采集之后的信息需要在不刷新 H5 页面的情况下返回给 H5 界面进行显示,这时候就需要 Android/iOS 原生客户端具备能够及时通知 JS 更新内容的能力。

为了解决这个问题,JS 向原生客户端公开如下方法调用,共接收两个参数:

hybrid.notify(event/* string */, params/* string */);

如果客户端想要主动通知 H5 更新页面的话,可以随时调用 JS 的 jh.notify 方法,并把要投递的消息参数给编码好即可,由 JS 自行决定消息应该怎么处理。

上一篇 下一篇

猜你喜欢

热点阅读