Sensors API ให้คุณอ่านข้อมูลดิบของเซ็นเซอร์ในแอปได้แบบเรียลไทม์ ใช้ API นี้เพื่อให้ทำสิ่งต่อไปนี้ได้
- แสดงรายการแหล่งข้อมูลที่มีอยู่ในอุปกรณ์และในอุปกรณ์ที่ใช้ร่วมกัน
- ลงทะเบียน Listener เพื่อรับข้อมูลดิบของเซ็นเซอร์
- ยกเลิกการลงทะเบียน Listener เพื่อไม่ให้พวกเขาได้รับข้อมูลเซ็นเซอร์ดิบอีกต่อไป
แสดงรายการแหล่งข้อมูลที่มี
วิธีดูรายการแหล่งข้อมูลที่มีอยู่ทั้งหมดในอุปกรณ์และในโฆษณาที่แสดงร่วม
ให้ใช้
SensorsClient.findDataSources
วิธีการ:
Kotlin
private val fitnessOptions = FitnessOptions.builder().addDataType(DataType.TYPE_STEP_COUNT_DELTA).build() // Note: Fitness.SensorsApi.findDataSources() requires the // ACCESS_FINE_LOCATION permission. Fitness.getSensorsClient(requireContext(), GoogleSignIn.getAccountForExtension(requireContext(), fitnessOptions)) .findDataSources( DataSourcesRequest.Builder() .setDataTypes(DataType.TYPE_STEP_COUNT_DELTA) .setDataSourceTypes(DataSource.TYPE_RAW) .build()) .addOnSuccessListener { dataSources -> dataSources.forEach { Log.i(TAG, "Data source found: ${it.streamIdentifier}") Log.i(TAG, "Data Source type: ${it.dataType.name}") if (it.dataType == DataType.TYPE_STEP_COUNT_DELTA) { Log.i(TAG, "Data source for STEP_COUNT_DELTA found!") ... } } } .addOnFailureListener { e -> Log.e(TAG, "Find data sources request failed", e) }
Java
FitnessOptions fitnessOptions = FitnessOptions.builder().addDataType(DataType.TYPE_STEP_COUNT_DELTA).build(); // Note: Fitness.SensorsApi.findDataSources() requires the // ACCESS_FINE_LOCATION permission. Fitness.getSensorsClient(getApplicationContext(), GoogleSignIn.getAccountForExtension(getApplicationContext(), fitnessOptions)) .findDataSources( new DataSourcesRequest.Builder() .setDataTypes(DataType.TYPE_STEP_COUNT_DELTA) .setDataSourceTypes(DataSource.TYPE_RAW) .build()) .addOnSuccessListener(dataSources -> { dataSources.forEach(dataSource -> { Log.i(TAG, "Data source found: ${it.streamIdentifier}"); Log.i(TAG, "Data Source type: ${it.dataType.name}"); if (dataSource.getDataType() == DataType.TYPE_STEP_COUNT_DELTA) { Log.i(TAG, "Data source for STEP_COUNT_DELTA found!"); ... } })}) .addOnFailureListener(e -> Log.e(TAG, "Find data sources request failed", e));
หากต้องการรับข้อมูลเกี่ยวกับอุปกรณ์สำหรับแหล่งข้อมูล ให้ใช้
DataSource.getDevice
ข้อมูลอุปกรณ์มีประโยชน์ในการแยกความแตกต่างจาก
เซ็นเซอร์ของอุปกรณ์อื่น จะแสดงข้อมูลอุปกรณ์จากเซ็นเซอร์ไปยัง
ผู้ใช้ หรือประมวลผลข้อมูลแตกต่างกันไปตามอุปกรณ์ ตัวอย่างเช่น คุณอาจ
สนใจในการอ่านข้อมูลโดยเฉพาะจากเซ็นเซอร์ในอุปกรณ์ที่สวมใส่ได้
อุปกรณ์ แต่ไม่ใช่จากเซ็นเซอร์ประเภทเดียวกันบนโทรศัพท์
หากต้องการซื้อ Device
สำหรับอุปกรณ์ที่เรียกใช้กิจกรรมของคุณ ให้ใช้
Device.getLocalDevice
ซึ่งจะเป็นประโยชน์เมื่อคุณต้องการตรวจสอบว่าแหล่งข้อมูลอยู่ใน
อุปกรณ์ที่แอปของคุณใช้อยู่
เพิ่มผู้ฟัง
ในการเพิ่มผู้ฟังเพื่อรับข้อมูลดิบของข้อมูลการออกกำลังกายประเภทใดประเภทหนึ่ง หรือจาก
แหล่งข้อมูลเฉพาะ
SensorsClient.add
วิธีการ:
Kotlin
val listener = OnDataPointListener { dataPoint -> for (field in dataPoint.dataType.fields) { val value = dataPoint.getValue(field) Log.i(TAG, "Detected DataPoint field: ${field.name}") Log.i(TAG, "Detected DataPoint value: $value") } } Fitness.getSensorsClient(this, GoogleSignIn.getAccountForExtension(this, fitnessOptions)) .add( SensorRequest.Builder() .setDataSource(dataSource) // Optional but recommended for custom // data sets. .setDataType(dataType) // Can't be omitted. .setSamplingRate(10, TimeUnit.SECONDS) .build(), listener ) .addOnSuccessListener { Log.i(TAG, "Listener registered!") } .addOnFailureListener { Log.e(TAG, "Listener not registered.", task.exception) }
Java
OnDataPointListener listener = dataPoint -> { for (Field field : dataPoint.getDataType().getFields()) { Value value = dataPoint.getValue(field); Log.i(TAG, "Detected DataPoint field: ${field.getName()}"); Log.i(TAG, "Detected DataPoint value: $value"); } }; Fitness.getSensorsClient(this, GoogleSignIn.getAccountForExtension(this, fitnessOptions)) .add( new SensorRequest.Builder() .setDataSource(dataSource) // Optional but recommended // for custom data sets. .setDataType(dataType) // Can't be omitted. .setSamplingRate(10, TimeUnit.SECONDS) .build(), listener ) .addOnSuccessListener(unused -> Log.i(TAG, "Listener registered!")) .addOnFailureListener(task -> Log.e(TAG, "Listener not registered.", task.getCause())); }
นำ Listener ออก
ในการนำ Listener ออกจากการอัปเดตข้อมูลดิบ ให้ใช้
SensorsClient.remove
วิธีการ:
Kotlin
Fitness.getSensorsClient(this, GoogleSignIn.getAccountForExtension(this, fitnessOptions)) .remove(listener) .addOnSuccessListener { Log.i(TAG, "Listener was removed!") } .addOnFailureListener { Log.i(TAG, "Listener was not removed.") }
Java
Fitness.getSensorsClient(this, GoogleSignIn.getAccountForExtension(this, fitnessOptions)) .remove(listener) .addOnSuccessListener(unused -> Log.i(TAG, "Listener was removed!")) .addOnFailureListener(e -> Log.i(TAG, "Listener was not removed."));