Rokid設備連接全解析：藍牙與Wi-Fi通信源碼深度剖析 Detail - java,kotlin 認真的咖啡 Blog

Stories

Detail

Return

Rokid設備連接全解析：藍牙與Wi-Fi通信源碼深度剖析 - Stories Detail

04:05 PM · Oct 26 ,2025

一、概述

在AR眼鏡開發中，設備連接是構建完整交互體驗的基礎環節。Rokid通過其CXR_M SDK提供了完整的藍牙和Wi-Fi連接解決方案，本文將深入解析其實現原理和代碼架構。

1.1 連接架構總覽

Rokid設備連接採用分層設計：
在這裏插入圖片描述

二、藍牙連接實現詳解

2.1 設備發現機制

設備發現是整個連接流程的起點，Rokid通過標準的Android Bluetooth API進行設備掃描，同時使用特定UUID過濾Rokid設備。

2.1.1 權限管理

class BluetoothHelper(
    val context: AppCompatActivity,
    val initStatus: (INIT_STATUS) -> Unit,
    val deviceFound: () -> Unit) {
    companion object {
        // 權限定義
        private val REQUIRED_PERMISSIONS = mutableListOf(
            Manifest.permission.ACCESS_FINE_LOCATION,
            Manifest.permission.BLUETOOTH,
            Manifest.permission.BLUETOOTH_ADMIN,
        ).apply {
            if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S) {
                add(Manifest.permission.BLUETOOTH_SCAN)
                add(Manifest.permission.BLUETOOTH_CONNECT)
            }
        }.toTypedArray()
    }
        // 權限檢查入口
    fun checkPermissions() {
        initStatus.invoke(INIT_STATUS.NotStart)
        context.requestPermissions(REQUIRED_PERMISSIONS, REQUEST_CODE_PERMISSIONS)
        context.registerReceiver(
            bluetoothStateListener,
            IntentFilter(BluetoothAdapter.ACTION_STATE_CHANGED)
        )
    }}

權限管理流程：
在這裏插入圖片描述

2.1.2 設備掃描實現

// 開始掃描@SuppressLint("MissingPermission")@RequiresPermission(Manifest.permission.BLUETOOTH_SCAN)fun startScan() {
    scanResultMap.clear()
    // 獲取已連接設備
    val connectedList = getConnectedDevices()
    for (device in connectedList) {
        device.name?.let {
            if (it.contains("Glasses", false)) {
                bondedDeviceMap[it] = device
                deviceFound.invoke()
            }
        }
    }

    // 獲取已配對設備
    adapter?.bondedDevices?.forEach { d ->
        d.name?.let {
            if (it.contains("Glasses", false)) {
                if (bondedDeviceMap[it] == null) {
                    bondedDeviceMap[it] = d
                }
            }
            deviceFound.invoke()
        }
    }

    // 開始BLE掃描
    try {
        scanner.startScan(
            listOf<ScanFilter>(
                ScanFilter.Builder()
                    .setServiceUuid(ParcelUuid.fromString("00009100-0000-1000-8000-00805f9b34fb"))
                    .build()
            ), ScanSettings.Builder().build(),
            scanListener
        )
    } catch (e: Exception) {
        Toast.makeText(context, "Scan Failed ${e.message}", Toast.LENGTH_SHORT).show()
    }}

2.2 藍牙初始化與連接

2.2.1 初始化流程

/**
Init Bluetooth
*/fun initDevice(context: Context, device: BluetoothDevice){
 CxrApi.getInstance().initBluetooth(context, device,  object : BluetoothStatusCallback{
     override fun onConnectionInfo(
         socketUuid: String?,
         macAddress: String?,
         rokidAccount: String?,
         glassesType: Int
     ) {
         socketUuid?.let { uuid ->
             macAddress?.let { address->
                 connect(context, uuid, address)
             }?:run {
                 Log.e(TAG, "macAddress is null")
             }
         }?:run{
             Log.e(TAG, "socketUuid is null")
         }
     }
       override fun onConnected() {
           // 連接成功處理
       }
       override fun onDisconnected() {
           // 連接斷開處理
       }
       override fun onFailed(p0: ValueUtil.CxrBluetoothErrorCode?) {
           // 錯誤處理
       }
   })}

2.2.2 連接建立

/**
Connect Bluetooth
*/fun connect(context: Context, socketUuid: String, macAddress: String){
 CxrApi.getInstance().connectBluetooth(context, socketUuid, macAddress, object : BluetoothStatusCallback{
     override fun onConnectionInfo(
         socketUuid: String?,
         macAddress: String?,
         rokidAccount: String?,
         glassesType: Int
     ) {
         // 連接信息更新
     }
       override fun onConnected() {
           Log.d(TAG, "Connected")
       }
       override fun onDisconnected() {
           Log.d(TAG, "Disconnected")
       }
       override fun onFailed(p0: ValueUtil.CxrBluetoothErrorCode?) {
           Log.e(TAG, "Failed")
       }
   })}

藍牙連接狀態機：
在這裏插入圖片描述

2.3 連接狀態管理

2.3.1 狀態查詢

/**
Get Connection Status
*/fun getConnectionStatus(): Boolean{
 return CxrApi.getInstance().isBluetoothConnected}
2.3.2 狀態監聽
// Bluetooth State Listenerval bluetoothStateListener = object : BroadcastReceiver() {
    override fun onReceive(context: Context?, intent: Intent?) {
        val action = intent?.action
        if (action == BluetoothAdapter.ACTION_STATE_CHANGED) {
            val state = intent.getIntExtra(BluetoothAdapter.EXTRA_STATE, BluetoothAdapter.ERROR)
            when (state) {
                BluetoothAdapter.STATE_OFF -> {
                    initStatus.invoke(INIT_STATUS.NotStart)
                    bluetoothEnabled.postValue(false)
                }
            }
        }
    }}

2.4 資源管理與重連機制

2.4.1 資源釋放

/**
DeInit Bluetooth
*/fun deInit(){
 CxrApi.getInstance().deinitBluetooth()}
// Release@SuppressLint("MissingPermission")fun release() {
    context.unregisterReceiver(bluetoothStateListener)
    stopScan()
    permissionResult.postValue(false)
    bluetoothEnabled.postValue(false)}

2.4.2 重連機制

重連使用與初始連接相同的API，但需要保存之前的連接參數：

/**
重連實現
*/fun reconnect(context: Context, savedSocketUuid: String, savedMacAddress: String) {
 connect(context, savedSocketUuid, savedMacAddress)}

三、Wi-Fi連接實現詳解

Wi-Fi連接建立在藍牙連接基礎之上，主要用於高速數據傳輸。由於Wi-Fi模塊功耗較高，建議僅在需要傳輸大量數據時開啓。

3.1 Wi-Fi初始化

3.1.1 初始化流程

/**
Init Wifi
*/fun initWifi(): ValueUtil.CxrStatus?{
 return CxrApi.getInstance().initWifiP2P(object : WifiP2PStatusCallback{
     override fun onConnected() {
         Log.d(TAG, "onConnected")
     }
       override fun onDisconnected() {
           Log.d(TAG, "onDisconnected")
       }
       override fun onFailed(errorCode: ValueUtil.CxrWifiErrorCode?) {
           // 錯誤處理
       }
   })}

Wi-Fi連接狀態圖：
在這裏插入圖片描述

3.2 Wi-Fi狀態管理

3.2.1 連接狀態查詢

/**
Get Wifi Connection Status
*/fun getWiFiConnectionStatus(): Boolean{
 return CxrApi.getInstance().isWifiP2PConnected}

3.2.2 資源釋放

/**
Deinit Wifi
*/private fun deinitWifi(){
 CxrApi.getInstance().deinitWifiP2P()}

四、完整連接流程與最佳實踐

4.1 完整連接時序圖

在這裏插入圖片描述

4.2 錯誤處理策略

4.2.1 藍牙錯誤處理

override fun onFailed(errorCode: ValueUtil.CxrBluetoothErrorCode?) {
    when (errorCode) {
        ValueUtil.CxrBluetoothErrorCode.PARAM_INVALID -> {
            Log.e(TAG, "Invalid parameters provided")
        }
        ValueUtil.CxrBluetoothErrorCode.BLE_CONNECT_FAILED -> {
            Log.e(TAG, "BLE connection failed")
        }
        ValueUtil.CxrBluetoothErrorCode.SOCKET_CONNECT_FAILED -> {
            Log.e(TAG, "Socket connection failed")
        }
        ValueUtil.CxrBluetoothErrorCode.UNKNOWN -> {
            Log.e(TAG, "Unknown bluetooth error")
        }
        else -> {
            Log.e(TAG, "Unhandled error code: $errorCode")
        }
    }}

4.2.2 連接重試機制

建議實現指數退避的重試機制：

class ConnectionManager {
    private var retryCount = 0
    private val maxRetries = 3
    private val baseDelay = 1000L // 1秒
    fun connectWithRetry(context: Context, socketUuid: String, macAddress: String) {
        connect(context, socketUuid, macAddress, object : BluetoothStatusCallback {
            override fun onFailed(errorCode: ValueUtil.CxrBluetoothErrorCode?) {
                if (retryCount < maxRetries) {
                    retryCount++
                    val delay = baseDelay * (2 pow retryCount) // 指數退避
                    Handler(Looper.getMainLooper()).postDelayed({
                        connectWithRetry(context, socketUuid, macAddress)
                    }, delay)
                } else {
                    notifyConnectionFailed()
                }
            }
            override fun onConnected() {
                retryCount = 0
            }
        })
    }}

4.3 性能優化建議

連接策略對比：
在這裏插入圖片描述

五、總結

Rokid CXR_M SDK提供了完整的設備連接解決方案，通過清晰的API設計和回調機制，讓開發者能夠快速實現藍牙和Wi-Fi連接功能。

Kotlin , JAVA

認真的咖啡 Blog

@renzhendekafei

Tags

JAVA (556)

Kotlin (32)