OpticalSystem/developer-front/public/docs/mobile-dev.md

移动端开发

完成配对与权限接入，下载示例 App 并查看开源仓库，集成通知与同步。

平台支持

觉远创智 SDK 支持以下移动端平台：

Android

使用 Kotlin/Java 开发，支持蓝牙和 Wi-Fi 配对，需要相应权限。

环境要求：

• Android 5.0 (API 21) 及以上
• Kotlin 1.5+ 或 Java 8+

安装：

dependencies {
    implementation 'com.smartglasses:mobile-sdk:2.1.0'
}

初始化：

val mobileSDK = MobileSDK.getInstance(context)
mobileSDK.initialize(
    apiKey = "your-api-key",
    appId = "your-app-id"
)

设备配对：

// 扫描设备
mobileSDK.scanDevices { devices ->
    // 选择设备进行配对
    mobileSDK.pairDevice(devices[0]) { success ->
        if (success) {
            println("配对成功")
        }
    }
}

iOS

使用 Swift 开发，需要麦克风和通知权限，支持设备绑定。

环境要求：

• iOS 12.0 及以上
• Swift 5.0+

安装：

pod 'SmartGlassesMobileSDK', '~> 2.1.0'

初始化：

import SmartGlassesMobileSDK

let mobileSDK = MobileSDK.shared
mobileSDK.initialize(
    apiKey: "your-api-key",
    appId: "your-app-id"
)

设备配对：

// 扫描设备
mobileSDK.scanDevices { devices in
    // 选择设备进行配对
    mobileSDK.pairDevice(devices[0]) { success in
        if success {
            print("配对成功")
        }
    }
}

Web

使用 Web API 进行开发，支持进度上报。

安装：

npm install smartglasses-mobile-sdk

使用：

import { MobileSDK } from 'smartglasses-mobile-sdk'

const mobileSDK = new MobileSDK({
    apiKey: 'your-api-key',
    appId: 'your-app-id'
})

// 初始化
await mobileSDK.initialize()

// 扫描设备
const devices = await mobileSDK.scanDevices()

// 配对设备
await mobileSDK.pairDevice(devices[0])

权限配置

Android

在 AndroidManifest.xml 中添加权限：

<uses-permission android:name="android.permission.BLUETOOTH" />
<uses-permission android:name="android.permission.BLUETOOTH_ADMIN" />
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />

iOS

在 Info.plist 中添加权限说明：

<key>NSBluetoothAlwaysUsageDescription</key>
<string>需要蓝牙权限以连接智能眼镜设备</string>
<key>NSMicrophoneUsageDescription</key>
<string>需要麦克风权限以进行语音交互</string>

通知集成

// Android 示例
mobileSDK.notifications.sendNotification(
    title = "新消息",
    content = "您有一条新消息",
    icon = R.drawable.notification_icon
)

// iOS 示例
mobileSDK.notifications.sendNotification(
    title: "新消息",
    body: "您有一条新消息"
)