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 melakukan pengujian di emulator yang menjalankan Wear OS 4 (API 33) atau Wear OS 3 (API 30), 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 Wear OS 4.

Perhatian: Panduan ini tidak mencakup kontrol emulator yang diperluas. Kontrol emulator yang diperluas tidak kompatibel dengan pembuatan data Fitur Kesehatan untuk Wear OS 4.

Menggunakan data sintetis di Wear OS 4

Jika melakukan pengujian di emulator yang menjalankan Wear OS 4 (API 33), Anda dapat menggunakan data sintetis yang dihasilkan oleh emulator untuk menguji aplikasi. Langkah ini memperkenalkan sejumlah peningkatan terkait cara data sintetis dihasilkan di Wear OS 3:

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

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

Catatan: Metode ini hanya berfungsi di emulator dan tidak dapat digunakan untuk pengujian pada perangkat fisik yang menjalankan Wear OS 4. Anda harus mengupgrade ke versi terbaru emulator Wear OS 4 untuk menggunakan fitur ini.

Gunakan Panel Sensor Fitur Kesehatan

Update Fitur Android Studio Koala (Canary) mencakup 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 membangun aplikasi kebugaran di Wear OS.

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

Untuk membuka dan menggunakan panel, lakukan hal berikut:

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

Setelah panel terbuka, Anda dapat melakukan hal berikut:

• Beralihlah di antara Kemampuan standar, Semua kemampuan (default), atau Kustom. Pilih Apply untuk mengirim daftar kemampuan saat ini ke perangkat yang diemulasikan, lalu pilih Reset untuk memulihkan daftar kemampuan ke nilai aktif-nonaktif default-nya.
• Picu peristiwa pengguna yang berbeda setelah Anda memilih tombol drop-down Pemicu peristiwa. Dari sini, Anda dapat Memicu jeda/melanjutkan otomatis aktivitas kebugaran, Memicu peristiwa tidur oleh pengguna, dan Memicu tembakan golf yang dilakukan pengguna di lapangan golf atau lapangan golf mini.
• Ganti nilai sensor setelah Anda memulai olahraga di aplikasi yang diinstal di emulator. Setelah memasukkan nilai baru untuk metrik olahraga yang berbeda, pilih Apply untuk menyinkronkan nilai ini dengan emulator. 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 otomatis dibuat oleh emulator.

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

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

Menyimulasikan peristiwa

Anda dapat melakukan simulasi 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

Peristiwa	Kunci
Jeda Otomatis Terdeteksi	whs.AUTO_PAUSE_DETECTED
Lanjutkan Otomatis Terdeteksi	whs.AUTO_RESUME_DETECTED
Jatuh Terdeteksi	whs.FALL_OVER
Tidur Terdeteksi	whs.START_SLEEPING
Berhenti Tidur Terdeteksi	whs.STOP_SLEEPING
Tembakan Golf Terdeteksi	whs.GOLF_SHOT

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 pukulan golf, Anda harus menentukan parameter tambahan untuk jenis ayunan pukulan golf, yang diuraikan di bawah:

Jenis Ayunan Tembakan Golf	Parameter
Jenis Putt Ayunan	putt
Jenis Parsial Ayunan	parsial
Ayunan Tipe Penuh	penuh

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 tembakan golf parsial:

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 melakukan pengujian di emulator yang menjalankan Wear OS 3, Anda juga dapat menggunakan data sintetik untuk menguji aplikasi.

Mengaktifkan pembuatan data sintetis

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

Catatan: Pembuatan data sintetis dinonaktifkan secara default.

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:

Aktivitas	Detak jantung	Kecepatan rata-rata	Perubahan elevasi	Gunakan lokasi
Jalan kaki	120 bpm	1,4 m/dtk	20,0 m/mnt	true
Berjalan	170 bpm	2,3 m/dtk	20,0 m/mnt	true
Mendaki	150 bpm	1,3 m/dtk	20,0 m/mnt	true
Renang	150 bpm	1,6 m/dtk	0,0 m/mnt	true
Lari di treadmill	160 bpm	2,3 m/dtk	20,0 m/mnt	salah

Hentikan

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.