更新记录

1.1（2023-08-07）

插件发布

平台兼容性

原生插件通用使用流程：

1. 购买插件，选择该插件绑定的项目。
2. 在HBuilderX里找到项目，在manifest的app原生插件配置中勾选模块，如需要填写参数则参考插件作者的文档添加。
3. 根据插件作者的提供的文档开发代码，在代码中引用插件，调用插件功能。
4. 打包自定义基座，选择插件，得到自定义基座，然后运行时选择自定义基座，进行log输出测试。
5. 开发完毕后正式云打包

付费原生插件目前不支持离线打包。
Android 离线打包原生插件另见文档 https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/android
iOS 离线打包原生插件另见文档 https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/ios

注意事项：使用HBuilderX2.7.14以下版本，如果同一插件且同一appid下购买并绑定了多个包名，提交云打包界面提示包名绑定不一致时，需要在HBuilderX项目中manifest.json->“App原生插件配置”->”云端插件“列表中删除该插件重新选择

插件使用说明

• 此插件基于部网络货运信息交互系统位置信息插件 SDK-2.1.1

• 在本地项目的 manifest.json 中，勾选 Geolocation 高德定位模块，并填写高德申请的 key

• 以下示例代码中涉及的字段、参数等，参考部网络货运信息交互系统位置信息 SDK 文档

• 关于回调函数的说明

  {
  "success": true, //使用success字段表示成功与失败
  "code": 1, //在调用sdk失败时，透传错误代码
  "data": [], //开始定位，发送定位等接口调用成功后，会返回对应的数据
  "mesage": "" //在调用sdk失败时，透传错误信息
  }

• shippingNoteInfos 数组

  {
  shippingNoteNumber, //必填 String 运单号
  serialNumber, // 必填 String 分单号    分单号填写的 0000
  startCountrySubdivisionCode,//  待定 String     起点位置行政区划代码，调用 start/stop/pause/restart 时必填，调用 send 非必填
  endCountrySubdivisionCode, // 待定 String 到达位置行政区划代码，调用 start/stop/pause/restart 时必填，调用 send 非必填
  startLongitude, // 待定 Double 起点位置经度，调用 start/stop/pause/restart 时必填，调用 send 非必填
  tartLatitude,// 待定 Double 起点位置纬度，调用 start/stop/pause/restart 时必填，调用 send 非必填
  endLongitude,// 待定 Double 到达位置经度，调用 start/stop/pause/restart 时必填，调用 send 非必填
  endLatitude,// 待定 Double 到达位置纬度，调用 start/stop/pause/restart 时必填，调用 send 非必填
  startLocationText,// 待定 String 起点地址文字描述，调用 start/stop/pause/restart 时必填，调用 send 非必填
  endLocationText,// 待定 String 到达地址文字描述，调用 start/stop/pause/restart 时必填，调用 send 非必填
  vehicleNumber,// 否 String 车牌号， SDK 回调返回，调用 start/stop/pause/restart/必填， send 时非必填
  driverName,// 否 String 司机姓名， SDK 回调返回，调用 start/stop/pause/restart/必填， send 时非必填
  interval,// 否 String 请求时间间隔， SDK 回调返回(单位 ms)
  }

• 加载原生插件

  // 建议在加载插件之前获取定位权限
  const plugin = uni.requireNativePlugin("ym-LocationInteraction");

• 初始化（init）

  plugin.init({}, (res) => {});

• 授权（auth）

  plugin.auth(
  {
    appId, //网络货运企业APP的唯一标识
    appSecurity, //网络货运企业在省平台申请的接入安全码
    enterpriseSenderCode, //网络货运企业在省平台申请的企业发送代码
    environment, //正式环境release，测试环境debug
  },
  (res) => {}
  );

• 开启定位（start）

  plugin.start(
  {
    vehicleNumber, //车牌号
    driverName, //司机姓名
    remark, //备注
    shippingNoteInfos: [], //运单信息列表
  },
  (res) => {}
  );

• 发送定位（send）

  plugin.send(
  {
    vehicleNumber, //车牌号
    driverName, //司机姓名
    remark, //备注
    shippingNoteInfos: [], //运单信息列表
  },
  (res) => {}
  );

• 暂停定位（pause）

  plugin.pause(
  {
    vehicleNumber, //车牌号
    driverName, //司机姓名
    remark, //备注
    shippingNoteInfos: [], //运单信息列表
  },
  (res) => {}
  );

• 重启定位（restart）

  plugin.restart(
  {
    vehicleNumber, //车牌号
    driverName, //司机姓名
    remark, //备注
    shippingNoteInfos: [], //运单信息列表
  },
  (res) => {}
  );

• 停止定位（stop）

  plugin.stop(
  {
    vehicleNumber, //车牌号
    driverName, //司机姓名
    remark, //备注
    shippingNoteInfos: [], //运单信息列表
  },
  (res) => {}
  );