更新记录

1.2.0（2024-03-02）

移除了插件包中kotlin-stdlib的依赖;

1.0.3（2024-01-06）

补充了说明文档,添加了使用示例代码;

平台兼容性

原生插件通用使用流程：

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和高德定位SDK.

插件包含"文字转语音"、"导航"、"定位"、"请求权限"等功能;部分使用示例如下:

在nvue文件中引入插件:

var navi = uni.requireNativePlugin("coscoshipping-AMapNaviModule"); 

高德的隐私合规是否同意的弹窗:

navi.agreement({
    "agree":true,//用户是否同意高德的隐私合规信息
},(res)=>{
    console.log(res);
});

请求权限:

navi.request({},(res)=>{
    console.log("request",res);
    _this.getLocation();//申请到权限后开始调用获取定位
});

播放文字转语音:

navi.speak({//需要语音播报的内容
    content:"正在使用自定义导航语音导航内容，前方500米到达目的地，本次导航结束，祝您生活愉快！"
})

获取当前定位:

navi.getLocation({},(res)=>{//res是回调的返回参数,包含定位信息
    console.log("获取到高德定位",res)
});

导航功能,可定义起点、终点、途经点、车辆信息:

navi.startNavi({
    carInfo:{//车辆信息,比如长宽高,方便检测限高路段
        CarNumber:"京C123456",//车牌
        CarType:"1",//类型
        VehicleAxis:"6",//车辆轴数,
        VehicleHeight:"3.56",//车辆高度
        VehicleLength:"7.3",//车辆长度
        VehicleWidth:"2.5",//车辆宽度
        VehicleSize:"4",
        VehicleLoad:"25.99",//载重
        VehicleWeight:"20",//净重
        Restriction:true,
        VehicleLoadSwitch:true,
    },
    start:{//起点信息,包含位置名称和经纬度信息
        CUST_NM:"鲁迅文学院八里庄校区",//定位名称
        LATITUDE_S:39.923703,//纬度
        LONGITUDE_S:116.498672,//经度
    },
    end:{//终点信息,同上
        CUST_NM:"珠江摩尔国际中心",
        LATITUDE_S:40.094792,
        LONGITUDE_S:116.287902,
    },
    ways:[//途经点信息数组,同上
        {
            CUST_NM:"北京首都国际机场",
            LATITUDE_S:40.080833,
            LONGITUDE_S:116.604204,
        },{
            CUST_NM:"北京友谊宾馆",
            LATITUDE_S:39.963458,
            LONGITUDE_S:116.319665,
        },
    ]
},(res)=>{
    console.log("导航结束",res);
});

关于高德SDK的介绍:

• Android 定位 SDK 是一套简单的LBS服务定位接口，您可以使用这套定位API获取定位结果、逆地理编码（地址文字描述）、以及地理围栏功能。
• Android 定位 SDK 是提供给具有一定 Android 编程经验和了解面向对象概念的读者使用的。

高德给开发者的建议

1. 对于高德开放平台提供的地图API/SDK，若您以非商业目的使用，则均可免费使用 。若您以商业目的使用，则您需事先从高德获取商用授权。您需要先申请Key，才能使用该服务。关于具体使用规则，请参阅《高德地图开放平台服务协议》获得详细信息。
2. 您可以通过开发指南和参考手册来掌握Android 定位SDK 的开发。