h5 与 RN 交互文档
文章目录
通信协议
- h5 向 RN 发送消息的方式,需按照以下形式:
window.ReactNativeWebView.postMessage(
JSON.stringify({
action: String,
payload: Object,
}));
- RN向h5发送消息,需按照以下的形式:
this.webref.injectJavaScript(`
window.g_app._store.dispatch({
type: 'action的类型',
payload: '携带的数据'
});
true;
`);
1、 标题栏有按钮(比如分享、提交等)
h5需要尽早向RN发送消息,告诉RN按钮的类型(最好constructor中)
{
action: 'sendHeaderButtonType',
payload: {
leftType:'左边按钮类型',
rightType:'右边按钮类型',
hideHeader: '布尔值', // true 隐藏header,可选
onPressType: '点击按钮触发的事件',// 同一种按钮,在不同页面有不同功能时,需要传这个值
headerBgColor: 'header的背景色的色值', //可选
}
}
- 如果没有
herder情况下,hideHeader:true -
右边按钮是
分享:rightType: 'share' -
左边按钮是
取消,右边按钮是提交:leftType:'cancel', rightType: 'submit', onPressType: 'consultDoctorSubmit' // 咨询医生提交订单
2、h5 向 RN 发送分享到微信等第三方app的内容
{
action:'sendShareMessage'`,
payload:{shareTitle:'分享的标题',shareContent:'分享的剪短的内容(不超过30字)'}
}
// ps: 分享有两种情况:
//1、点击app header上的按钮(所以需要这个action把分享的内容传给RN),
//2、点击h5内的分享按钮,
3、H5点击页面内的按钮,需要RN处理动作
-
点击
支付按钮,需要app来支付:-
咨询订单:
{ action:'onPressWechatPay', payload: { orderType: 'consultationOrder', orderId: '订单id', redirectUrl:'支付完成后需要进入的url' } } -
检测订单:
{ action:'onPressWechatPay', payload: { orderType: 'detectionOrder', orderId: '订单id', redirectUrl:'支付完成后需要进入的url' } }
-
-
点击
分享按钮,需要app处理分享:{ action: 'onPressShare' payload:{shareTitle:'分享的标题',shareContent:'分享的简短的内容(不超过30字)'} } // PS: 如果已经发送过`sendShareMessage`这个消息,payload 可以为空 - 点击
h5内的返回按钮,需要RN来处理返回逻辑:
{
action: 'onPressGoBack',
}
// ps: 无需payload
4、h5页面如果触发登录页面,需要用RN的登录页面
{
action: 'navigateToLogin'
payload: {currentUrl:'当前的url'}
}
5、RN向 H5 发送消息
- RN点击app内的按钮,触发h5的动作,
{
type:'user/changeIsPress',
payload:{onPressType:'按钮触发的动作类型'}
}
其中`onPressType`的值:
- `咨询医生`提交订单: `onPressType`:`'consultDoctorSubmit'`
- `RN`支付成功,需要通知`h5`刷新页面,`onPressType`: `onWeChatPaySuccess`
- RN 向h5发送
token:
{
type:'chat/saveUserToken',
payload:'token的值'
}
-
RN需要h5隐藏所有付费项目的入口,以规避iOS审核IAP要求:
{
type:'user/hidePurchaseInfo',
}
6、h5页面的title发生变化时,需要向RN发送消息传递新的title:
action: 'onPageTitleChange',
payload: {pageTitle: '页面的title'}
7、h5需要RN展示 loading动画,需要向RN发送消息:
{
action:'manageAppLoading',
payload: {type:'具体的动作'},
}
-
显示loading 时:type:'showLoading' -
隐藏loading 时:type:'hideLoading'
8、h5需要手机的权限(相机权限等),需要向RN发送消息:
{
action:'requestPermission',
payload:{permissionType: '权限类型'}
}
其中,permissionType的值:
- 请求相机权限:
permissionType:'camera' - 请求位置权限:
permissionType:'location'
9、h5需要拨打电话:
{
action:'makePhoneCall',
payload:{phoneNumber: '手机号码'}
}
10、h5 需要RN扫描条形码/二维码
{
action:'scanQRCode',
payload: '扫描成功后,RN向h5发送消息的时的type值',
}
扫描成功后,RN向h5发送扫描到的信息:
{
type: 'h5传过来的type',
payload: '扫描得到的信息'
}
11、h5 直接分享到第三方应用
{
action: 'directlySocialShare',
payload: {
type: '分享的平台',
webpageUrl: '分享的链接',
shareTitle:'分享的标题',
shareContent:'分享的简短的内容(不超过30字)'
}
}
其中,分享的平台type:
- 微信:'Wechat'
- 朋友圈:'WeChatTimeLine'
- QQ: 'QQ'
- 微博: 'Weibo'
评论
登录后参与技术讨论,分享你的经验与见解。
登录 / 注册暂无评论