Menyimulasikan data sensor dengan Fitur Kesehatan

Gunakan data sintetis yang dihasilkan dari Fitur Kesehatan di Wear OS untuk menguji aplikasi Anda seolah-olah olahraga benar-benar terjadi.

Jika menguji di emulator yang menjalankan Wear OS 3 (level API 30) atau yang lebih tinggi, Anda dapat menggunakan data sintetis yang dihasilkan oleh emulator. Lihat panduan berikut untuk mempelajari lebih lanjut perbedaan antara pembuatan data sintetis untuk Wear OS 3 dan yang lebih baru.

Menggunakan data sintetis di Wear OS 4 dan yang lebih baru

Jika menguji di emulator yang menjalankan Wear OS 4 (level API 33) atau yang lebih tinggi, Anda dapat menggunakan data sintetis yang dihasilkan oleh emulator untuk menguji aplikasi. Hal ini memperkenalkan sejumlah peningkatan pada cara data sintetis dihasilkan di versi Wear OS sebelumnya:

• Pembuatan data sintetis di Wear OS 4 dan yang lebih baru terintegrasi dengan siklus proses Health Services API. Artinya, tidak perlu perintah adb untuk memulai atau menghentikan olahraga. Sebagai gantinya, Anda dapat memulai atau menghentikan olahraga dalam aplikasi seperti yang dilakukan pengguna.

• Dukungan yang diperluas untuk peristiwa olahraga: Anda dapat menyimulasikan penerimaan peristiwa jeda dan lanjutkan otomatis, peristiwa jatuh, deteksi tidur, dan deteksi pukulan golf.

Menggunakan Panel Sensor Fitur Kesehatan

Update Fitur Baru Android Studio Koala (Canary) menyertakan Fitur Kesehatan di panel sensor Wear OS. Panel ini dapat digunakan untuk menyimulasikan perangkat yang memiliki atau tidak memiliki kemampuan sensor tertentu, yang penting untuk diuji saat mem-build aplikasi kebugaran di Wear OS.

Anda juga dapat menggunakan panel untuk mengubah nilai metrik dan mengamati cara aplikasi menyesuaikan.

Untuk membuka dan menggunakan panel, lakukan tindakan berikut:

1. Buat atau buka Perangkat Virtual Android (AVD) dan jalankan aplikasi Anda di emulator.
2. Di panel emulator, pilih Wear Health Services. Panel Fitur Kesehatan Wear akan terbuka, menampilkan daftar sensor yang tersedia di berbagai perangkat yang didukung Android.

Setelah panel terbuka, Anda dapat melakukan hal berikut:

• Alihkan antara Kemampuan standar, dan Semua kemampuan (default) untuk memilih kumpulan kemampuan yang diaktifkan selama latihan berikutnya. Anda dapat mengaktifkan atau menonaktifkan kemampuan individual dengan memilih kotak centang. Pilih Terapkan untuk mengirim daftar kemampuan saat ini ke perangkat yang diemulasi, dan pilih Reset untuk memulihkan daftar kemampuan ke nilai aktif-nonaktif default.
• Memicu peristiwa pengguna yang berbeda setelah Anda memilih tombol drop-down Memicu peristiwa. Dari sini, Anda dapat Memicu jeda/lanjutkan otomatis aktivitas kebugaran, Memicu peristiwa tidur oleh pengguna, dan Memicu tembakan golf yang diambil pengguna di lapangan golf atau lapangan golf mini.
• Ganti nilai sensor setelah Anda memulai olahraga di aplikasi yang diinstal di emulator. Setelah Anda memasukkan nilai baru untuk metrik olahraga yang berbeda, pilih Terapkan untuk menyinkronkan nilai ini dengan emulator. Hal ini berguna untuk menguji cara aplikasi Anda menangani berbagai kondisi olahraga dan kecenderungan kebugaran pengguna.

Membuat data sintetis dengan emulator

Anda juga dapat menjalankan aplikasi tanpa panel sensor dan membuat data dibuat secara otomatis oleh emulator.

Gunakan kontrol dalam aplikasi untuk memulai, menjeda, dan mengakhiri pembuatan data sintetis.

Perhatikan juga bahwa emulator menghasilkan nilai data yang sama untuk setiap latihan.

Menyimulasikan peristiwa

Anda dapat menyimulasikan berbagai peristiwa di emulator seperti AUTO_PAUSE_DETECTED. Perintah berikut dapat digunakan untuk memicu peristiwa tersebut:

adb shell am broadcast -a "whs.event-key" com.google.android.wearable.healthservices

Peristiwa sintetis

Misalnya, Anda dapat menggunakan perintah berikut untuk memicu peristiwa jeda otomatis:

​​adb shell am broadcast -a "whs.AUTO_PAUSE_DETECTED" com.google.android.wearable.healthservices

Untuk peristiwa tembakan golf, Anda harus menentukan parameter tambahan untuk jenis ayunan tembakan golf, yang diuraikan di bawah:

Tambahkan jenis ayunan pukulan golf setelah menentukan peristiwa pukulan golf:

adb shell am broadcast -a "whs.GOLF_SHOT" --es golf_shot_swing_type \
  "golf-swing-type-parameter" com.google.android.wearable.healthservices

Misalnya, perintah berikut memicu pukulan golf sebagian:

adb shell am broadcast -a "whs.GOLF_SHOT" --es golf_shot_swing_type "partial" \
  com.google.android.wearable.healthservices

Menggunakan data sintetis di Wear OS 3

Jika menguji di emulator yang menjalankan Wear OS 3, Anda juga dapat menggunakan data sintetis untuk menguji aplikasi.

Mengaktifkan pembuatan data sintetis

Selesaikan langkah-langkah berikut untuk mengaktifkan pembuatan data sintetis di Wear OS 3.

1. Aktifkan opsi developer.

2. Berikan perintah adb berikut untuk mengaktifkan mode sintetis:

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

Setelah pembuatan data sintetis diaktifkan, berikan perintah yang dijelaskan di halaman ini untuk mengontrol perilaku "pengguna sintetis".

Menonaktifkan pembuatan data sintetis

Untuk beralih kembali menggunakan sensor sebenarnya, jalankan perintah berikut:

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

Olahraga sintetis

Fitur Kesehatan mendukung jenis olahraga berikut:

• Jalan kaki: whs.synthetic.user.START_WALKING
• Lari: whs.synthetic.user.START_RUNNING
• Mendaki: whs.synthetic.user.START_HIKING
• Berenang: whs.synthetic.user.START_SWIMMING
• Berlari di atas treadmill: whs.synthetic.user.START_RUNNING_TREADMILL

Olahraga ini menghasilkan data sintetis yang realistis untuk jenis data berikut:

• Detak jantung
• Jumlah langkah per menit
• Lokasi GPS, menggunakan satu rute default
• Durasi aktivitas
• Elevasi dan lantai

Selain itu, status berikut dapat dibuat:

• Status tidur—tidur atau bangun
• Deteksi jatuh

Memulai

Untuk mulai menyimulasikan olahraga, berikan siaran yang sesuai ke com.google.android.wearable.healthservices:

# start the "walking" synthetic exercise
$ adb shell am broadcast \
-a "whs.synthetic.user.START_WALKING" \
com.google.android.wearable.healthservices

Setiap aktivitas memiliki preset untuk metrik yang didukung:

Menghentikan

Untuk menghentikan aktivitas sintetis, gunakan perintah berikut:

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

Kustom

Untuk kontrol yang lebih akurat terhadap metrik yang dihasilkan, mulai aktivitas olahraga kustom menggunakan string tindakan whs.synthetic.user.START_EXERCISE. Berikan kombinasi flag berikut:

• --ei exercise_options_duration_secs <int>: durasi olahraga dalam hitungan detik. Default: 0.
• --ei exercise_options_heart_rate <int>: detak jantung dalam denyut per menit. Rata-rata: 70.
• --ef exercise_options_average_speed <float>: kecepatan rata-rata dalam meter per detik. Juga memengaruhi langkah per menit, atau irama. Default: 0.
• --ez exercise_options_use_location <boolean>: apakah memunculkan data lokasi selama olahraga atau tidak, menggunakan rute default. Default: false.
• --ef exercise_options_max_elevation_rate <float>: tingkat perubahan elevasi maksimum yang dimungkinkan dalam meter per menit. Default: 0.

Misalnya, tetapkan opsi olahraga dengan cara berikut:

adb shell am broadcast \
-a "whs.synthetic.user.START_EXERCISE" \
--ei exercise_options_heart_rate 90 \
--ef exercise_options_average_speed 1.2 \
--ez exercise_options_use_location true \
com.google.android.wearable.healthservices

Anda juga dapat mengubah jenis data yang tersedia, terlepas dari apakah hardware sungguhan atau yang diemulasikan mendukung jenis data tertentu atau tidak. Misalnya, Anda dapat mengaktifkan atau menonaktifkan elevasi absolut, seperti yang ditunjukkan dalam cuplikan berikut:

# enable synthetic mode and enable absolute elevation
$ adb shell am broadcast \
-a "whs.CONFIGURE_SYNTHETIC_DEVICE" \
--ez absolute_elevation true \
com.google.android.wearable.healthservices

# enable synthetic mode and disable absolute elevation
$ adb shell am broadcast \
-a "whs.CONFIGURE_SYNTHETIC_DEVICE" \
--ez absolute_elevation false \
com.google.android.wearable.healthservices

Status dan peristiwa lainnya

Status tidur

Anda juga dapat memicu status tidur untuk pengguna sintetis. Dua status didukung: tidur dan bangun.

Untuk memasuki status tidur, jalankan perintah ini:

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

Untuk memasuki status bangun, jalankan perintah ini:

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

Deteksi jatuh

Untuk menyimulasikan peristiwa jatuh, jalankan perintah ini:

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

Mungkin perlu waktu hingga satu menit bagi fitur kesehatan untuk mengirimkan peristiwa jatuh.