cordova 引入 LocNaviWebSDK 簡介

cordova-plugin-LocNaviWebSDK 是一套面向 cordova 開發者使用LocNaviWebSDK的插件，開發者可自行引用該插件輕鬆實現地圖展示、導航至具體poi等功能。 1.*的版本开始支持Android Support。0.*和2.*版本支持Android X库。iOS部分没有什么影响

獲取AppKey

appKey mapId targetId 請向[email protected] 申請

插件引用

npm引用

直接引入线上npm包

// android support 使用1.*的版本
cordova plugin add [email protected]
// android x 使用0.*和2.*的版本
cordova plugin add [email protected]

如果已經添加cordova-plugin-locnavi-websdk,請先移除,在進行添加

cordova plugin remove cordova-plugin-locnavi-websdk
cordova plugin add cordova-plugin-locnavi-websdk

本地引用

拷貝插件文件夾cordova-plugin-LocNaviWebSDK 至項目目錄 (相對路徑)

cordova plugin add ./cordova-plugin-LocNaviWebSDK

如果已經添加cordova-plugin-LocNaviWebSDK,請先移除,在進行添加

//先查看安装了什么插件
cordova plugin list
cordova plugin remove cordova-plugin-LocNaviWebSDK
cordova plugin add ./cordova-plugin-LocNaviWebSDK

衝突處理

若是加入插件遇到衝突，請加入--force指令，如下：

cordova plugin add ./cordova-plugin-LocNaviWebSDK --force

安裝注意事項

• iOS

  • 要安裝Cordova，需要先安裝Node.js在Node.js官網上下載並安裝
  • 添加該插件之後，cd到iOS項目目錄，使用pod install
  • 打開項目工程後會發現有些文件沒有，比如Plugins文件可以在 cordova-plugin-LocNaviWebSDK 拷貝
  • 权限设置请参考iOS原生demo iOS README

SDK初始化

        LocNaviWebSDKPlugin.init(appkey, {
            userId: "123",
            serverUrl: "https://xxx.com",
            uuids: ["uuid1", "uuid2"],
            uploadApi: "https://xxx.com", //需要https
            uploadInterval: 1000
        });

        //初始化定位服務
        LocNaviWebSDKPlugin.initLocationService("HHrzBwF5dY", {
             serverUrl: "https://l.sailstech.com",
        }, (winParam) => {
            console.log(winParam)
        }, (error) => {
            console.log(error);
        });

顯示室內地圖

  LocNaviWebSDKPlugin.showMap(mapId);

導航至具體地址

  LocNaviWebSDKPlugin.showMap(mapId, poi);

攜帶參數打開地圖

  //支持打開地圖並蒐索地點
  LocNaviWebSDKPlugin.showMapWithParmas(mapId, encodeURI("search=廁所"));

初始化定位服務

        LocNaviWebSDKPlugin.initLocationService("HHrzBwF5dY", {
             serverUrl: "https://l.sailstech.com",
        }, (winParam) => {
            console.log(winParam)
        }, (error) => {
            console.log(error);
        });

開始定位

// 註意使用該功能前需要申請好授權
// Android未授權時，內置會彈出授權框，用戶需要手動授權。授權完成後需要手動觸發startLocation，iOS則是自動觸發。
// Manifest.permission.ACCESS_FINE_LOCATION,
// Manifest.permission.BLUETOOTH_SCAN,
// Manifest.permission.BLUETOOTH_CONNECT
// 持续返回winParam，winParam一开始只是普通String告知调用成功，后面会返回定位信息 "{\"longitude\":\"NaN\",\"latitude\":\"NaN\",\"floor\":null}"
            LocNaviWebSDKPlugin.startLocation({}, (winParam)=>{
                                              console.log(winParam);
                                        },
                                        (error)=>{
//                                            console.log(error);
                                        });

停止定位

            LocNaviWebSDKPlugin.stopLocation({}, (winParam)=>{
                                            console.log(winParam);
                                        },
                                        (error)=>{
                                            console.log(error);
                                        });

進入 IOS 和 Android 平台查看相關的 README 進行設置

iOS文檔

Android文檔