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来支付:

      1. 咨询订单:

        {
              action:'onPressWechatPay',
              payload: {
                  orderType: 'consultationOrder',
                  orderId: '订单id', 
                  redirectUrl:'支付完成后需要进入的url'
             }
        }
      2. 检测订单:

        {
            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'

    评论

    暂无评论