当前位置：首页 > news >正文

iOS客户端与网页交互文档

news 来源：原创 2024/5/22 9:39:04

很少和客户端打交道，这次由于做会活动，要和客户端配合做个分享的功能

这里总结下基本的流程，就是前端在H5 里调用客户端的方法即可

第一部分客户端提供需求文档

网页请求设置

客户端发起请求时在HTTP Header中设置UA标识为tianqiwang_ios
客户端在header中添加名为mp字段。字段内容为：{ "versionCode":"", "versionName":"4.6", "channel":"appStore", "imei":"123456789" } 字段经过base64加密。(iOS无versionCode概念，故该字段为空字符串)

客户端与网页通信

客户端初始化webView时注册名为webView2345KWApp的messageHandler用于支持2345自运营网页调用原生方法。前端可通过window.webkit.messageHandlers.webView2345KWApp.postMessage()向客户端发送消息。
前端发送数据格式。每条数据都应包括method字段，指定调用那个原生方法。可参考以下格式：
{ "method": "onShareClick", /* 必选 */"title": "后裔射日活动", "detail": "中秋活动", "url": "http://ww1.sinaimg.cn/large/0065oQSqly1ft3fna1ef9j30s210skgd.jpg", "imgUrl":"http://ww1.sinaimg.cn/large/0065oQSqly1ft3fna1ef9j30s210skgd.jpg", "supportPlatformType": ["Wechat","WechatMoments","QQ","QZone","SinaWeibo","ShortMessage"] }
客户端调用网页方法时，需网页定义好相应的js方法。将方法名称，调用参数、调用时机告知客户端即可。

已有交互方法

调用原生分享功能

场景：点击h5页面分享按钮，调起原生分

参数名	详情
method	调用的方法名(onShareClick)
title	分享的标题
detail	分享的详细内容
url	分享的url(已url encode过)
imgUrl	分享时显示的图片地址
supportPlatformType	该分享支持的平台

客户端通知分享是否成功

场景: 用户分享后通知网页，客户端调用onShareCallback(int resultCode，String platformType)方法

参数名	详情
resultCode	分享状态(1：成功 2：失败 3:取消)
platformType	分享的平台可选值:"Wechat","WechatMoments","QQ","QZone","SinaWeibo","ShortMessage"

客户端检查网页支持分享的平台

场景: 网页加载完成后,客户端调用js方法onCheckShare()检查网页需要分享的内容，以便用户点击原生页面分享时使用。网页需返回包含以下参数的JSON对象。

参数名	详情
title	分享的标题
detail	分享的详细内容
url	分享的url(已url encode过)
imgUrl	分享时显示的图片地址
supportPlatformType	该分享支持的平台

第二部分 js里去调用客户端方法

html

点击之后的回调函数：

window.callback = function(data) {
　　document.getElementById('callback1').innerText = JSON.stringify(data);
};

点击调用客户端的方法：
$("#btn1").click(function(){
　　try {
　　　　window.webkit.messageHandlers.webView2345KWApp.postMessage({
　　　　method: 'onShareClick',
　　　　params: {
　　　　　　title: '分享测试',
　　　　　　detail: '揭秘前世今生六道轮回',
　　　　　　url: 'http://www.77tianqi.com/frame/sm/pcqianshi',
　　　　　　imgUrl: 'http://www.77tianqi.com/images/prediction/qianshi/ming.png',
　　　　　　supportPlatformType: ["Wechat", "WechatMoments", "QQ", "QZone", "SinaWeibo", "ShortMessage"]
　　　　},
　　　　　　callback: 'callback'
　　　　});
　　} catch (e) {
　　　　window.callback(e.message);
　　　　}
　　})
一进入页面客户端会向H5注入一个对象，里面存储了用户的设备信息，是base64 加密过的，需要会解密下，这里推荐Base64.js