推送透传消息 - WebApp快捷打包

WebApp快捷打包

推送透传消息

敬告：此 DEMO 演示为开放测试页面，仅用于开发者快速测试体验应用功能，请严格遵守开发者协议，了解更多。

♦ JS-SDK 引用方式：

♦ 普通网页 script 方式加载：下载最新版 jsBridge-v20251019.zip，请在页面上调用 jsBridge 接口之前引用 jsbridge-mini.js 库；

♦ js module 方式引用：npm install ym-jsbridge 具体请参考 npm package

接入推送平台服务器端接口发送个推透传消息；
可以在APP客户端调用个推 setListener 监听到你在服务器端发送的透传消息；
支持自动打开指定的 url 链接；
支持播放自定义 sound 提示音（在配置移动应用页面的推送功能里面上传mp3音频文件）；
注意：透传消息走的推送平台通道，而非手机设备厂商通道，APP进程处于存活状态时才能收到透传消息。可判断推送平台服务器端接口的返回状态，如果APP客户端不在线，透传消息发送失败可考虑重发通知(notification)类型的消息。

个推透传消息示例

• 安卓：确保APP进程（个推服务）处于存活状态，可引导用户设置自启动与省电策略管理，提高应用存活率；
• 苹果：确保APP处于前台激活状态，若离线可使用 iOS 通道的 aps.sound 字段自定义通知提示音；

//参考 http://docs.getui.com/getui/server/rest_v2/common_args/?id=doc-title-6
{
  push_message: {
    transmission:"透传消息字符串"
  }
}

//如：
var payload = {
  //提示音
  sound  : "notify-order_coming.mp3",
  //通知栏消息文字
  message: "新订单来了，速抢...",
  content: "自定义的任意 JSON 属性"
};
var message = {
  push_message: {
    //JSON Object 转字符串
    transmission: JSON.stringify(payload)
  }
}

APP客户端自动处理透传消息的约定

//透传消息必须是标准的 JSON 字符串，保留属性说明：
var payload = {
  //可选，字符串类型，收到消息需要自动打开的网页链接
  //必须是 http:// 或 https:// 开头的完整链接
  url    : "http://...",
  //可选，字符串类型，收到消息需要播放的自定义提示音
  //提示音名称为 notify-{mp3文件名}
  sound  : "notify-order_coming.mp3",
  //可选，字符串类型，通知栏消息文字
  message: "新订单来了，速抢...",
  content: "自定义的任意 JSON 属性"
};

//透传消息内容即为 JSON Ojbect 转字符串
var transmission = JSON.stringify(payload);