將更多應用程式導入穿戴式裝置,進一步提升應用程式的健康與健身體驗 搭載 Wear OS 的裝置。
新增 Wear OS 模組
Android Studio 提供便利的精靈,方便您在應用程式中新增 Wear OS 模組。於 [檔案] >「新模組」選單,選取 Wear OS,如下所示 圖片:
![Android Studio 中的 Wear OS 模組精靈](https://developer.android.google.cn/static/health-and-fitness/guides/basic-fitness-app/images/basic_fitness_app_img_8.png?authuser=19&hl=zh-tw)
請特別注意,「Minimum SDK」必須設為 API 30 以上版本 才能使用最新版本的健康照護服務。健康照護服務 您可以設定健康狀態,更輕鬆地追蹤指標和記錄資料 感應器。
完成精靈後,請同步處理專案。下列 Run 設定會出現:
![顯示 Wear OS 應用程式執行按鈕的圖片](https://developer.android.google.cn/static/health-and-fitness/guides/basic-fitness-app/images/basic_fitness_app_img_5.png?authuser=19&hl=zh-tw)
這樣一來,您就可以在穿戴式裝置上執行 Wear OS 模組。方法有以下兩種:
執行設定會將應用程式部署至 Wear OS 模擬器,或 裝置會顯示「Hello World」無須專人管理這是基本 UI 設定,使用 Compose for Wear OS:瞭解如何開始使用應用程式。
新增健康照護服務和 Hilt
將下列程式庫整合至 Wear OS 模組:
建立健康照護服務管理員
為了讓健康照護服務變得更方便,並將 讓 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 更新。