更新记录

1.0.0（2026-08-11）

• 新增 AuthKey 与高德 Key 动态授权。
• 新增二维码组网互联及完整状态码映射。
• 新增连接状态监听、状态快照和主动断开。
• 新增连接成功后的亿连地图页面入口。

平台兼容性

uni-app(4.72)

hl-edrive-auto

亿连手机互联 iOS UTS 插件。它提供 AuthKey 授权、扫码组网、连接状态监听、断开连接和亿连地图页面入口。

支持范围

• uni-app Vue 2 / Vue 3
• iOS 12.0 及以上
• iPhone 真机 arm64
• 亿连 SDK V12.14.2_DYSK02_20260720

插件不支持 Android、HarmonyOS、Web 和 iOS 模拟器。

接入前配置

在 HBuilderX 的 iOS 原生配置中完成以下内容：

1. 配置与亿连 AuthKey、高德 Key 匹配的 Bundle ID。
2. 配置开发证书和描述文件。
3. 开启 Hotspot Configuration 能力。
4. 开启 Access WiFi Information 能力。

插件已经声明本地网络、定位、蓝牙、相机、运动、Bonjour 和后台模式说明。Bundle ID、签名、Team 与 Capability 不写入插件，由宿主项目统一管理。

快速开始

<script setup>
import { onMounted, onUnmounted } from 'vue'

import * as EDriveAuto from '@/uni_modules/hl-edrive-auto'

const start = (authKey, amapKey) => {
  // Key 由业务层在运行时传入，插件原生代码不保存项目 Key。
  EDriveAuto.authorize({ authKey, amapKey }, (authResult) => {
    if (!authResult.success) return

    uni.scanCode({
      onlyFromCamera: true,
      success: ({ result }) => {
        EDriveAuto.connectByQrCode(result, (event) => {
          console.log('组网状态', event.code, event.message)
        })
      }
    })
  })
}

onMounted(() => {
  EDriveAuto.onConnectionStatusChange((event) => {
    if (event.connected) {
      EDriveAuto.openMapHomePage((result) => console.log('打开地图', result.success))
    }
  })
})

onUnmounted(() => EDriveAuto.offConnectionStatusChange())
</script>

扫码由 uni.scanCode() 完成。插件只接收二维码文本，不重复申请或封装相机能力。

API

authorize(options, callback)

设置高德 Key，并使用 AuthKey 完成亿连 SDK 授权。调用其他亿连接口前必须先授权。

connectByQrCode(qrContent, callback)

将扫码结果交给亿连 SDK，SDK 自动完成 Wi-Fi 或蓝牙组网并启动互联服务。回调可能触发多次，terminal 表示当前流程结束。

onConnectionStatusChange(callback)

监听连接状态。注册后立即返回一次当前状态，后续继续接收 SDK 状态变化。

公开状态包括：

• unauthorized：尚未授权
• ready：授权完成，等待扫码
• connecting：正在组网互联
• connected：普通连接成功
• mirrorConnected：镜像连接成功
• disconnected：已断开

offConnectionStatusChange()

移除并释放前端连接状态回调。页面卸载时必须调用。

getConnectionStatus()

同步读取插件当前保存的连接状态快照。

disconnect(callback)

断开当前互联，但不关闭亿连互联服务。再次扫码时插件会先调用 SDK 的重新连接接口。

openMapHomePage(callback)

打开亿连地图首页，并将地图返回目标设置为三方来源页。只有普通连接或镜像连接成功后才能调用。

错误码

组网错误还会返回 nativeCode，对应亿连二维码连接状态码 0...14。

演示页面

项目内的 pages/edrive-auto-demo/index.vue 展示完整流程：

1. 使用预填 Key 完成授权。
2. 调用 uni.scanCode() 扫描车机二维码。
3. 发起组网并监听连接状态。
4. 连接成功后自动打开亿连地图。
5. 支持手动打开地图和断开连接。

原生依赖

插件包含亿连核心静态 Framework、定制高德地图 Framework、导航 UI 静态 Framework、AMR 静态库和资源包。高德、AFNetworking、Masonry、CocoaAsyncSocket 与 OpenSSL 依赖均随插件放置在 utssdk/app-ios/Frameworks，不需要宿主工程执行 CocoaPods 依赖安装。

依赖版本固定为 AFNetworking 4.0.1、Masonry 1.1.0、CocoaAsyncSocket 7.6.5、OpenSSL-Universal 1.1.2301、AMapNavi 9.8.1、AMapLocation 2.10.0 和 AMapSearch 9.7.2。

Libs/LLVMProfileRuntime/libhl_edrive_llvm_profile_marker.a 在链接期提供亿连 DeviceAuth Framework 编译时引用的 LLVM 标记符号。

HLEDriveNativeBridge.framework 只封装本插件使用的 Objective-C 接口，用于隔离亿连二进制内 Swift 模块与宿主 Xcode 小版本差异。