更新记录

1.0.0(2021-11-25)

初始版本


平台兼容性

Android Android CPU类型 iOS
适用版本区间:5.0 - 10.0 armeabi-v7a:支持,arm64-v8a:支持,x86:支持 ×

原生插件通用使用流程:

  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原生插件配置”->”云端插件“列表中删除该插件重新选择


平台兼容性

Android iOS
×

高德地图导航原生插件(安卓)使用说明

插件功能:

  • 当前插件版本主要实现三个功能
    1. 实现 App 内部调用高德地图功能
    2. 实现高德地图多途径点导航功能
    3. 实现路线策略计算

解决问题:

  1. 解决当前 uniapp 无法在 App 内部调用地图高级功能(如导航)的问题
  2. 解决 uniapp 无法实现多途径点导航的问题
  3. 解决 uniapp 无法进行路线策略计算问题

Api 说明

路线策略计算Api:

amapPlugin.strategyConvert({'策略参数'})

策略参数说明

参数 描述 是否必传 实例
amapAppKey 高德AppKey xxxxxxxxxxxx
congestion 躲避拥堵 true
avoidHightSpeed 不走高速 false
cost 避免收费 false
hightSpeed 高速优先 false
multipleRoute 多路径 true

参数都是boolean类型,其中multipleRoute参数表示是否多条路线,如果为true则此策略会算出多条路线。

  • 注意:
  • 不走高速与高速优先不能同时为true
  • 高速优先与避免收费不能同时为true

    关键代码示例

var amapPlugin = uni.requireNativePlugin("miaojia-amap-android-plugin-AmapNaviMuiltPointPlugin");
amapPlugin.strategyConvert({amapAppKey: xxxxxxxxxxxx,
                            congestion: true,
                            avoidHightSpeed: false,
                            cost: false,
                            hightSpeed: false,
                            multipleRoute: true},
                    (ret) => { 
                        console.log(ret);
                    });
var amapPlugin = uni.requireNativePlugin("miaojia-amap-android-plugin-AmapNaviMuiltPointPlugin");
amapPlugin.driver({
                        start:{
                            address: '深圳卫星大厦',
                            lat: 22.525407,
                            lng: 113.939678
                        },
                        end: {
                            address: '深圳腾讯大厦',
                            lat: 22.540517,
                            lng: 113.934497 
                        },
                        points: [
                            {
                                address: 'A8音乐大厦',
                                lat: 22.522392,
                                lng: 113.938689 
                            }
                        ],
                        strategy: this.strategy,
                        amapAppKey: "你的高德appkey"
                    },
                    (ret) => { 
                        console.log(ret);
                    });

驾车导航Api,多途径点导航:

amapPlugin.driver('导航参数')

导航参数说明

参数 描述 是否必传 实例
amapAppKey 高德AppKey xxxxxxxxxxxx
start 起点坐标 {address: '深圳卫星大厦',lat: 22.525407,lng: 113.939678}
end 终点坐标 {address: '深圳腾讯大厦',lat: 22.540517,lng: 113.934497 }
points 途经点坐标 [{address: 'A8音乐大厦',lat: 22.522392,lng: 113.938689 }]
strategy 策略(默认10) 10

关键代码示例

var amapPlugin = uni.requireNativePlugin("miaojia-amap-android-plugin-AmapNaviMuiltPointPlugin");
amapPlugin.driver({
                        start:{
                            address: '深圳卫星大厦',
                            lat: 22.525407,
                            lng: 113.939678
                        },
                        end: {
                            address: '深圳腾讯大厦',
                            lat: 22.540517,
                            lng: 113.934497 
                        },
                        points: [
                            {
                                address: 'A8音乐大厦',
                                lat: 22.522392,
                                lng: 113.938689 
                            }
                        ],
                        strategy: 10,
                        amapAppKey: "你的高德appkey"
                    },
                    (ret) => { 
                        console.log(ret);
                    });

隐私、权限声明

1. 本插件需要申请的系统权限列表:

"<uses-permission android:name='android.permission.ACCESS_COARSE_LOCATION'></uses-permission>", "<uses-permission android:name='android.permission.ACCESS_FINE_LOCATION'></uses-permission>", "<uses-permission android:name='android.permission.ACCESS_WIFI_STATE'></uses-permission>", "<uses-permission android:name='android.permission.ACCESS_NETWORK_STATE'></uses-permission>", "<uses-permission android:name='android.permission.CHANGE_WIFI_STATE'></uses-permission>", "<uses-permission android:name='android.permission.READ_PHONE_STATE'></uses-permission>", "<uses-permission android:name='android.permission.WRITE_EXTERNAL_STORAGE'></uses-permission>", "<uses-permission android:name='android.permission.INTERNET'/>", "<uses-permission android:name='android.permission.MOUNT_UNMOUNT_FILESYSTEMS'></uses-permission>", "<uses-permission android:name='android.permission.READ_LOGS'></uses-permission>", "<uses-permission android:name='android.permission.WRITE_SETTINGS'/>

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

采集的数据:本插件需要采集用户手机当前位置信息(主要是经纬度),该主要用户在高德地图中绘制当前位置和计算地图信息,不需要上传到服务器 高德地图隐私协议地址: https://lbs.amap.com/pages/privacy/

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

使用中有什么不明白的地方,就向插件作者提问吧~ 我要提问