整合 Wear OS 模組

將更多應用程式導入穿戴式裝置，進一步提升應用程式的健康與健身體驗 搭載 Wear OS 的裝置。

新增 Wear OS 模組

Android Studio 提供便利的精靈，方便您在應用程式中新增 Wear OS 模組。於 [檔案] >「新模組」選單，選取 Wear OS，如下所示 圖片：

Android Studio 中的 Wear OS 模組精靈
圖 1：建立 Wear OS 模組

請特別注意，「Minimum SDK」必須設為 API 30 以上版本 才能使用最新版本的健康照護服務。健康照護服務 您可以設定健康狀態，更輕鬆地追蹤指標和記錄資料 感應器。

完成精靈後，請同步處理專案。下列 Run 設定會出現：

顯示 Wear OS 應用程式執行按鈕的圖片
圖 2：新 Wear OS 模組的執行按鈕

這樣一來，您就可以在穿戴式裝置上執行 Wear OS 模組。方法有以下兩種：

執行設定會將應用程式部署至 Wear OS 模擬器，或 裝置會顯示「Hello World」無須專人管理這是基本 UI 設定，使用 Compose for Wear OS：瞭解如何開始使用應用程式。

新增健康照護服務和 Hilt

將下列程式庫整合至 Wear OS 模組：

  • 健康照護服務：存取手錶上的感應器和資料 便利性和能源效率更高
  • Hilt：可讓您有效插入及管理依附元件。

建立健康照護服務管理員

為了讓健康照護服務變得更方便，並將 讓 API 更順暢，您可以建立如下的包裝函式：

private const val TAG = "WATCHMAIN"

class HealthServicesManager(context: Context) {
    private val measureClient = HealthServices.getClient(context).measureClient

    suspend fun hasHeartRateCapability() = runCatching {
        val capabilities = measureClient.getCapabilities()
        (DataType.HEART_RATE_BPM in capabilities.supportedDataTypesMeasure)
    }.getOrDefault(false)

    /**
     * Returns a cold flow. When activated, the flow will register a callback for heart rate data
     * and start to emit messages. When the consuming coroutine is canceled, the measure callback
     * is unregistered.
     *
     * [callbackFlow] creates a  bridge between a callback-based API and Kotlin flows.
     */
    @ExperimentalCoroutinesApi
    fun heartRateMeasureFlow(): Flow<MeasureMessage> = callbackFlow {
        val callback = object : MeasureCallback {
            override fun onAvailabilityChanged(dataType: DeltaDataType<*, *>, availability: Availability) {
                // Only send back DataTypeAvailability (not LocationAvailability)
                if (availability is DataTypeAvailability) {
                    trySendBlocking(MeasureMessage.MeasureAvailability(availability))
                }
            }

            override fun onDataReceived(data: DataPointContainer) {
                val heartRateBpm = data.getData(DataType.HEART_RATE_BPM)
                Log.d(TAG, "💓 Received heart rate: ${heartRateBpm.first().value}")
                trySendBlocking(MeasureMessage.MeasureData(heartRateBpm))
            }
        }

        Log.d(TAG, "⌛ Registering for data...")
        measureClient.registerMeasureCallback(DataType.HEART_RATE_BPM, callback)

        awaitClose {
            Log.d(TAG, "👋 Unregistering for data")
            runBlocking {
                measureClient.unregisterMeasureCallback(DataType.HEART_RATE_BPM, callback)
            }
        }
    }
}

sealed class MeasureMessage {
    class MeasureAvailability(val availability: DataTypeAvailability) : MeasureMessage()
    class MeasureData(val data: List<SampleDataPoint<Double>>) : MeasureMessage()
}

建立 Hilt 模組以進行管理後，請使用下列程式碼片段：

@Module
@InstallIn(SingletonComponent::class)
internal object DataModule {
    @Provides
    @Singleton
    fun provideHealthServices(@ApplicationContext context: Context): HealthServicesManager = HealthServicesManager(context)
}

可以插入 HealthServicesManager 做為任何其他 Hilt 依附元件。

新的 HealthServicesManager 提供 heartRateMeasureFlow() 方法，可 會註冊心臟監測器的事件監聽器，並發出接收的資料。

允許穿戴式裝置更新資料

如要更新健身相關資料，必須具備 BODY_SENSORS 權限。如果發生以下情況： 請在您的命令中宣告 BODY_SENSORS 權限， 應用程式的資訊清單檔案接著要求權限，如以下程式碼片段所示：

val permissionState = rememberPermissionState(
    permission = Manifest.permission.BODY_SENSORS,
    onPermissionResult = { granted -> /* do something */ }
)

[...]

if (permissionState.status.isGranted) {
    // do something
} else {
    permissionState.launchPermissionRequest()
}

如果您在實體裝置上測試應用程式，資料應該會開始更新。

從 Wear OS 4 開始，模擬器也會自動顯示測試資料。位於上一個項目 也能從感應器模擬資料串流在終端機中 視窗中執行以下 ADB 指令：

adb shell am broadcast \
-a "whs.USE_SYNTHETIC_PROVIDERS" \
com.google.android.wearable.healthservices

如要查看不同的心率值，請嘗試模擬不同的運動。 這個指令會模擬步行：

adb shell am broadcast \
-a "whs.synthetic.user.START_WALKING" \
com.google.android.wearable.healthservices

這個指令會模擬執行結果：

adb shell am broadcast \
-a "whs.synthetic.user.START_RUNNING" \
com.google.android.wearable.healthservices

如要停止模擬資料，請執行下列指令：

adb shell am broadcast -a \
"whs.USE_SENSOR_PROVIDERS" \
com.google.android.wearable.healthservices

讀取心率資料

授予 BODY_SENSORS 權限後，即可讀取使用者的心率 在 HealthServicesManager 中 (heartRateMeasureFlow())。透過 Wear OS 應用程式的 使用者介面顯示目前的心率值，由感應器上的感應器測量到 穿戴式裝置

在 ViewModel 中，開始使用心率流物件收集資料。 如以下程式碼片段所示：

val hr: MutableState<Double> = mutableStateOf(0.0)

[...]

healthServicesManager
    .heartRateMeasureFlow()
    .takeWhile { enabled.value }
    .collect { measureMessage ->
        when (measureMessage) {
            is MeasureData -> {
                val latestHeartRateValue = measureMessage.data.last().value
                hr.value = latestHeartRateValue
            }

            is MeasureAvailability -> availability.value =
                    measureMessage.availability
        }
    }

使用類似以下的可組合物件，顯示即時資料 應用程式的使用者介面：

val heartRate by viewModel.hr

Text(
  text = "Heart Rate: $heartRate",
  style = MaterialTheme.typography.display1
)

將資料傳送到手持裝置

如要將健康與健身資料傳送到手持裝置，請使用 DataClient 類別下列程式碼片段顯示如何傳送愛心 為應用程式先前收集的資料評分：

class HealthServicesManager(context: Context) {
    private val dataClient by lazy { Wearable.getDataClient(context) }

[...]

    suspend fun sendToHandheldDevice(heartRate: Int) {
        try {
            val result = dataClient
                .putDataItem(PutDataMapRequest
                    .create("/heartrate")
                    .apply { dataMap.putInt("heartrate", heartRate) }
                    .asPutDataRequest()
                    .setUrgent())
                .await()

            Log.d(TAG, "DataItem saved: $result")
        } catch (cancellationException: CancellationException) {
            throw cancellationException
        } catch (exception: Exception) {
            Log.d(TAG, "Saving DataItem failed: $exception")
        }
    }
}

在手機上接收資料

如要在手機上接收資料，請建立 WearableListenerService:

@AndroidEntryPoint
class DataLayerListenerService : WearableListenerService() {

    @Inject
    lateinit var heartRateMonitor: HeartRateMonitor

    override fun onDataChanged(dataEvents: DataEventBuffer) {

        dataEvents.forEach { event ->
            when (event.type) {
                DataEvent.TYPE_CHANGED -> {
                    event.dataItem.run {
                        if (uri.path?.compareTo("/heartrate") == 0) {
                            val heartRate = DataMapItem.fromDataItem(this)
                                    .dataMap.getInt(HR_KEY)
                            Log.d("DataLayerListenerService",
                                    "New heart rate value received: $heartRate")
                            heartRateMonitor.send(heartRate)
                        }
                    }
                }

                DataEvent.TYPE_DELETED -> {
                    // DataItem deleted
                }
            }
        }
    }
}

完成這個步驟後，請注意一些有趣的細節：

  • @AndroidEntryPoint 註解讓我們能在這個類別中使用 Hilt
  • @Inject lateinit var heartRateMonitor: HeartRateMonitor 確實存在 在此類別中插入依附元件
  • 該類別會實作 onDataChanged()，並接收一系列 您就能剖析及使用

下列 HeartRateMonitor 邏輯可讓您傳送收到的心率 指定值加入應用程式程式碼集的其他部分：

class HeartRateMonitor {
    private val datapoints = MutableSharedFlow<Int>(extraBufferCapacity = 10)

    fun receive(): SharedFlow<Int> = datapoints.asSharedFlow()

    fun send(hr: Int) {
        datapoints.tryEmit(hr)
    }
}

資料匯流排從 onDataChanged() 方法接收事件，然後進行 提供給資料觀察器使用 SharedFlow。

最後一個位元是手機應用程式中的 Service 宣告 AndroidManifest.xml:

<service
    android:name=".DataLayerListenerService"
    android:exported="true">
    <intent-filter>
        <!-- listeners receive events that match the action and data filters -->
        <action android:name="com.google.android.gms.wearable.DATA_CHANGED" />
        <data
            android:host="*"
            android:pathPrefix="/heartrate"
            android:scheme="wear" />
    </intent-filter>
</service>

在手持裝置上顯示即時資料

在應用程式於手持裝置上執行的應用程式部分，插入 HeartRateMonitor 傳入檢視模型的建構函式。此HeartRateMonitor 物件會觀察心率資料，並視需要發出 UI 更新。