Initial commit
This commit is contained in:
161
developer-front/public/docs/mobile-dev.md
Normal file
161
developer-front/public/docs/mobile-dev.md
Normal file
@@ -0,0 +1,161 @@
|
||||
# 移动端开发
|
||||
|
||||
完成配对与权限接入,下载示例 App 并查看开源仓库,集成通知与同步。
|
||||
|
||||
## 平台支持
|
||||
|
||||
觉远创智 SDK 支持以下移动端平台:
|
||||
|
||||
### Android
|
||||
|
||||
使用 Kotlin/Java 开发,支持蓝牙和 Wi-Fi 配对,需要相应权限。
|
||||
|
||||
**环境要求:**
|
||||
- Android 5.0 (API 21) 及以上
|
||||
- Kotlin 1.5+ 或 Java 8+
|
||||
|
||||
**安装:**
|
||||
|
||||
```gradle
|
||||
dependencies {
|
||||
implementation 'com.smartglasses:mobile-sdk:2.1.0'
|
||||
}
|
||||
```
|
||||
|
||||
**初始化:**
|
||||
|
||||
```kotlin
|
||||
val mobileSDK = MobileSDK.getInstance(context)
|
||||
mobileSDK.initialize(
|
||||
apiKey = "your-api-key",
|
||||
appId = "your-app-id"
|
||||
)
|
||||
```
|
||||
|
||||
**设备配对:**
|
||||
|
||||
```kotlin
|
||||
// 扫描设备
|
||||
mobileSDK.scanDevices { devices ->
|
||||
// 选择设备进行配对
|
||||
mobileSDK.pairDevice(devices[0]) { success ->
|
||||
if (success) {
|
||||
println("配对成功")
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### iOS
|
||||
|
||||
使用 Swift 开发,需要麦克风和通知权限,支持设备绑定。
|
||||
|
||||
**环境要求:**
|
||||
- iOS 12.0 及以上
|
||||
- Swift 5.0+
|
||||
|
||||
**安装:**
|
||||
|
||||
```ruby
|
||||
pod 'SmartGlassesMobileSDK', '~> 2.1.0'
|
||||
```
|
||||
|
||||
**初始化:**
|
||||
|
||||
```swift
|
||||
import SmartGlassesMobileSDK
|
||||
|
||||
let mobileSDK = MobileSDK.shared
|
||||
mobileSDK.initialize(
|
||||
apiKey: "your-api-key",
|
||||
appId: "your-app-id"
|
||||
)
|
||||
```
|
||||
|
||||
**设备配对:**
|
||||
|
||||
```swift
|
||||
// 扫描设备
|
||||
mobileSDK.scanDevices { devices in
|
||||
// 选择设备进行配对
|
||||
mobileSDK.pairDevice(devices[0]) { success in
|
||||
if success {
|
||||
print("配对成功")
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### Web
|
||||
|
||||
使用 Web API 进行开发,支持进度上报。
|
||||
|
||||
**安装:**
|
||||
|
||||
```bash
|
||||
npm install smartglasses-mobile-sdk
|
||||
```
|
||||
|
||||
**使用:**
|
||||
|
||||
```javascript
|
||||
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` 中添加权限:
|
||||
|
||||
```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` 中添加权限说明:
|
||||
|
||||
```xml
|
||||
<key>NSBluetoothAlwaysUsageDescription</key>
|
||||
<string>需要蓝牙权限以连接智能眼镜设备</string>
|
||||
<key>NSMicrophoneUsageDescription</key>
|
||||
<string>需要麦克风权限以进行语音交互</string>
|
||||
```
|
||||
|
||||
## 通知集成
|
||||
|
||||
```kotlin
|
||||
// Android 示例
|
||||
mobileSDK.notifications.sendNotification(
|
||||
title = "新消息",
|
||||
content = "您有一条新消息",
|
||||
icon = R.drawable.notification_icon
|
||||
)
|
||||
```
|
||||
|
||||
```swift
|
||||
// iOS 示例
|
||||
mobileSDK.notifications.sendNotification(
|
||||
title: "新消息",
|
||||
body: "您有一条新消息"
|
||||
)
|
||||
```
|
||||
|
||||
Reference in New Issue
Block a user