和缓视频医生微信小程序SDK（本SDK）为小程序自定义组件形式，使用npm方式发布。本文引导开发者从零开始，一步一步搭建起和缓视频医生基本功能框架。如果开发者是在现有项目中集成本SDK，可直接从第2步开始阅读。

开发者也可直接克隆当前仓库，使用微信开发者工具导入本项目后，执行以下步骤，快速浏览相关功能：

• 点击IDE右上角的“详情”，修改AppID。
• 使用命令提示符或终端，进入当前项目所在本地目录，执行命令更新SDK：npm i hhdoctor-wmp-sdk@latest --production。
• 点击IDE菜单中的“工具”-“构建 npm”。

如需查看旧版本文档，请：

查看0.*版本文档请点击此处

查看1.*版本文档请点击此处

查看2.*版本文档请点击此处

1. 本项目所使用的AppId为接口测试号AppId，在终端上执行预览会提示错误信息，请更换为实际可用的AppId。

2. 本项目需要使用微信小程序的livePusher和livePlayer组件，请确保AppId归属的小程序已开启相应的权限。如不清楚如何开启权限，请咨询和缓接口人。

3. 微信小程序IDE模拟器不支持livePusher和livePlayer组件，因此无法体验视频呼叫功能，请在真机中预览或进行真机调试。

4. 本项目所使用userToken和sdkProductId为演示专用，无法应用到测试或生产环境。

5. 如使用购药功能，需提供小程序AppId及小程序的主体信息给和缓接口人，以绑定支付功能，绑定成功后方可正常使用。详细绑定步骤请咨询和缓接口人。

6. 小程序开发完成后，需提交微信审核，审核通过后方可正式上线。如贵方小程序属首次提交审核，请务必预留充足的审核时间（至少预留1周审核时间，特殊情况下可能需要2周）。如在上线审核过程中遇到问题，可咨询和缓接口人寻求更多建议。

7. 在小程序后台“设置”-“基本设置”下，将“基础库最低版本设置”设置为2.19.6或更高版本。

8. 生产环境与测试环境的sdkProductId可以通用，但用户数据是完全隔离的，请勿将测试环境的userToken数据应用到生产环境，反之亦然。

9. 本SDK从3.0.3版本开始，呼叫时需要调用wx.getLocation()获取用户位置，因此请在项目的app.json文件中增加获取位置相关权限说明，请点击此处查看说明

10. 本SDK从3.1.0版本开始，移除了hh-sdkcontext组件，其下的navigateTo()方法移到hhDoctor组件中，使用hhDoctor.navigateTo()可实现前述跳转功能，方法接口参数不变

11. 如果您是从 1.* 版本SDK升级到 2.* 版本SDK，请点击此处查看升级指南。

12. 如果您是从 2.* 版本SDK升级到 3.* 版本SDK，请点击此处查看升级指南。

通过本SDK可实现以下功能：

• 咨询医助
• 呼叫医生
• 查看健康档案

• 启动IDE，选择小程序项目。

  

• 新建项目。

  

• 选择项目目录，输入AppID和项目名称，点击确定。

  

• 点击IDE右上角的“详情”，勾选“使用npm模块”和“不校验合法域名、web-view(业务域名)、TLS版本以及HTTPS证书”。

  

• 使用命令提示符或终端，进入小程序项目所在根目录，执行命令初始化：npm init --yes

  

• 初始化成功后，执行命令加载SDK：npm i hhdoctor-wmp-sdk@latest --production

  

• 使用小程序IDE打开package.json文件，确保dependencies.hhdoctor-wmp-sdk为最新版本。如不确定是否为最新版本请联系和缓的技术支持人员。

• 点击IDE菜单中的“工具”-“构建 npm”，如果构建成功，会提示“完成构建”。

• 使用小程序IDE创建新的页面(以pages/index/index为例)，编辑index.json文件，声明要使用的SDK组件。

  

• 编辑index.wxml文件，插入SDK组件标签。

  

• 编辑index.js文件，通过setData()给相应的变量赋值。

• SDK中可使用的页面

  "miniprogram_npm/hhdoctor-wmp-sdk/innerpages/realName/realName",
  "miniprogram_npm/hhdoctor-wmp-sdk/innerpages/user/user",
  "miniprogram_npm/hhdoctor-wmp-sdk/innerpages/ehr-family/ehr-family",
  "miniprogram_npm/hhdoctor-wmp-sdk/innerpages/ehr-filings/ehr-filings",
  "miniprogram_npm/hhdoctor-wmp-sdk/innerpages/ehr-filingdetail/ehr-filingdetail",
  "miniprogram_npm/hhdoctor-wmp-sdk/innerpages/view/view",
  "miniprogram_npm/hhdoctor-wmp-sdk/innerpages/pay/pay",
  "miniprogram_npm/hhdoctor-wmp-sdk/innerpages/invitationcode/invitationcode",
  "miniprogram_npm/hhdoctor-wmp-sdk/innerpages/doctorInfo/doctorInfo"

• 使用命令提示符或终端，进入小程序项目所在根目录，执行命令更新：npm i hhdoctor-wmp-sdk@latest --production。

• 打开小程序开发者IDE，点击IDE菜单中的“工具”-“构建 npm”。

• request合法域名:

  https://e.hh-medic.com
  https://mp.hh-medic.com
  https://wmp.hh-medic.com
  https://test.hh-medic.com
  https://pingtas.qq.com
  https://yun.tim.qq.com
  https://webim.tim.qq.com
  https://cloud.tencent.com
  https://official.opensso.tencent-cloud.com
  

• socket合法域名:

  wss://mp.hh-medic.com
  wss://wmp.hh-medic.com
  wss://test.hh-medic.com

• uploadFile合法域名:

  https://mp.hh-medic.com
  https://wmp.hh-medic.com
  https://test.hh-medic.com

• downloadFile合法域名:

  https://mp.hh-medic.com
  https://wmp.hh-medic.com
  https://imgfamily.hh-medic.com
  https://imgs.hh-medic.com
  https://test.hh-medic.com

  https://e.hh-medic.com
  https://mp.hh-medic.com
  https://wmp.hh-medic.com
  https://sec.hh-medic.com
  https://test.hh-medic.com
  https://dicom.hh-medic.com

使用视频医生小程序的第一步，需要初始化hhDoctor组件，并调用login()方法进行登录，登录成功后方可使用下方的hh-im、hh-rtc等组件。hhDoctor.login()方法全局调用一次即可，建议在获取到当前微信用户的userToken信息后执行。如执行hhDoctor.login()方法失败，建议给出提示信息。示例代码：

const hhDoctor = require('./miniprogram_npm/hhdoctor-wmp-sdk/hhDoctor.js')

hhDoctorLogin() {
    hhDoctor.logout();
    return hhDoctor.login({
      profileName: profileName,     //test:测试环境   prod:生产环境
      subDomain: 'mp',                //根据实际情况填写
      sdkProductId: sdkProductId,   //和缓分配的sdkProductId
      userToken: userToken,         //调用和缓服务器接口注册用户后得到的userToken
      openId: openId,               //当前用户openId
      callPage: '/pages/call/call'  //呼叫页面，在此注册页面后可支持医生回拨
    })
}

• 方法 ：

  • navigateTo(options) :跳转至相应页面，使用方法可参考pages/index/custom页面。

    • options :Object，跳转参数，结构如下：

    {
      page:'',          //Enum，跳转页面名称，具体指参见下方说明;
      drugOrderId:'',   //String,购药订单ID，当page='drugOrder'时必填。
      redirectPage:'',  //String,支付完成后跳转页面，留空默认跳转至'pages/index/index'
      patient:'',       //String,实际患者的userToken，当page='ehrList'或page='ehrDetail'时必填
      medicRecordId:''  //String,要查看的档案的medicRecordId，当page='ehrDetail'时必填
    }

    page参数枚举值说明

    'drugOrder':购药订单详情页; 
    'drugOrderList':购药订单列表页; 
    'personalPage':个人主页; 
    'addressList':地址列表;
    'ehrMemberList':档案库首页; 
    'ehrList':指定成员的档案列表; 
    'ehrDetail': 指定的档案详情;
    

• 功能 ：联系医助、查看病历档案

• 入口 ：hhdoctor-wmp-sdk/hh-im/hh-im

• 参数说明：

  • request :Object，请求参数，说明见下方。

• 事件

  • login:用户登录事件，登录成功后方可与医助沟通，detail数据结构如下：

  {
    success:[true:false]  //是否登录成功 
  }

• 功能 ：呼叫视频医生

• 入口 ：hhdoctor-wmp-sdk/hh-trtc/hh-trtc

• 参数说明 ：

  • request :Object，请求参数，说明见下方。

• 事件

  • login:用户登录事件，登录成功后正式发起呼叫，detail数据结构如下：

    {
      success:[true:false]  //是否登录成功 
    }

  • hangup:用户挂机事件，detail数据结构如下：

    {
      initiative:[true:false],  //是否主动挂机
      hangupType:['HANGUP','CANCEL','TIMEOUT'],  //挂机类型，依次为：正常挂断、取消挂断、超时挂断
      videoDur:Integer  //视频持续时长,单位：秒。
    }