เข้าถึงข้อมูลเซ็นเซอร์ดิบ

Sensors API ให้คุณอ่านข้อมูลดิบของเซ็นเซอร์ในแอปได้แบบเรียลไทม์ ใช้ API นี้เพื่อทำสิ่งต่อไปนี้

• แสดงรายการแหล่งข้อมูลที่มีอยู่ในอุปกรณ์และอุปกรณ์เสริม
• ลงทะเบียน Listener เพื่อรับข้อมูลดิบของเซ็นเซอร์
• ยกเลิกการลงทะเบียน Listener เพื่อไม่ให้พวกเขาได้รับข้อมูลเซ็นเซอร์ดิบอีกต่อไป

ข้อควรระวัง: Sensors API จะไม่จัดเก็บค่าที่อ่านได้จากเซ็นเซอร์ในที่จัดเก็บข้อมูลการออกกำลังกายโดยอัตโนมัติ และการลงทะเบียนเซ็นเซอร์ที่สร้างด้วย Sensors API จะไม่คงอยู่เมื่อระบบรีสตาร์ท โดยทั่วไปแล้วจะใช้ Recording API เพื่อบันทึกข้อมูลในเบื้องหลังด้วยการสมัครใช้บริการแบบถาวร และใช้ Sensors API เพื่อแสดงหรือประมวลผลค่าที่อ่านได้จากเซ็นเซอร์แบบเรียลไทม์ ในหลายกรณี คุณต้องใช้ API ทั้ง 2 รายการนี้ในแอป

หมายเหตุ: ดูแนวทางปฏิบัติแนะนำเมื่อจัดการข้อมูลผู้ใช้ได้ที่นโยบายสำหรับนักพัฒนาแอป Google Fit และข้อมูลผู้ใช้

แสดงรายการแหล่งข้อมูลที่มี

วิธีดูรายการแหล่งข้อมูลที่มีอยู่ทั้งหมดในอุปกรณ์และในโฆษณาที่แสดงร่วม ให้ใช้ SensorsClient.findDataSources วิธีการ:

KotlinJava

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)
    }

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 วิธีการ:

KotlinJava

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)
    }

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 ออก

หากต้องการนำผู้ฟังออกจากการอัปเดตข้อมูลดิบ ให้ใช้วิธีต่อไปนี้ SensorsClient.remove

KotlinJava

Fitness.getSensorsClient(this, GoogleSignIn.getAccountForExtension(this, fitnessOptions))
    .remove(listener)
    .addOnSuccessListener {
        Log.i(TAG, "Listener was removed!")
    }
    .addOnFailureListener {
        Log.i(TAG, "Listener was not removed.")
    }

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."));