資料出處

Google Fit 中的每個資料點都有相關聯的資料來源。資料來源 包含的資訊，可用於識別應用程式/裝置會收集或 並轉換資料。應用程式的套件名稱可用於資料來源 不是實體感應器的呈現方式

Google Fit 提供下列功能：

  • 叫用意圖即可查看與特定應用程式相關聯的資料。
  • 接收意圖以使用應用程式顯示資料。
  • 找出哪個應用程式插入工作階段。如要 相關資訊，請參閱「使用工作階段」一文。

判斷哪個應用程式插入資料點

如要取得插入資料點的應用程式套件名稱，請先 呼叫 DataPoint.getOriginalDataSource 取得資料來源，接著呼叫 DataSource.getAppPackageName。 方法：

Kotlin

val dataPoint : DataPoint = ...
val dataSource = dataPoint.originalDataSource
val appPkgName = dataSource.appPackageName

Java

DataPoint dataPoint = ...
DataSource dataSource = dataPoint.getOriginalDataSource();
String appPkgName = dataSource.getAppPackageName();

接收其他應用程式的意圖

如要註冊應用程式以接收來自其他健康與保健應用程式的意圖， 在資訊清單中宣告意圖篩選器，如下所示：

<intent-filter>
    <action android:name="vnd.google.fitness.VIEW" />
    <data android:mimeType="vnd.google.fitness.data_type/com.google.step_count.cumulative" />
    <data android:mimeType="vnd.google.fitness.data_type/com.google.step_count.delta" />
</intent-filter>

應用程式從 Google Fit 收到的每個意圖都只屬於一種類型。 但您可以在單一意圖篩選器中篩選多個 MIME 類型。應用程式的 意圖篩選器必須包含應用程式支援的所有資料類型 包括自訂資料類型

健身意圖包括以下額外項目：

  • vnd.google.gms.fitness.start_time
  • vnd.google.gms.fitness.end_time
  • vnd.google.gms.fitness.data_source

您可以透過下列方式取得這些額外項目的資料：

Kotlin

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    ...
    val supportedType = DataType.getMimeType(DataType.TYPE_STEP_COUNT_DELTA)

    if (Intent.ACTION_VIEW == intent.action && supportedType == intent.type) {
        // Get the intent extras
        val startTime = Fitness.getStartTime(intent, TimeUnit.MILLISECONDS);
        val endTime = Fitness.getEndTime(intent, TimeUnit.MILLISECONDS)
        val dataSource = DataSource.extract(intent)
    }
}

Java

@Override
public void onCreate(@Nullable Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    ...
    String supportedType = DataType.getMimeType(DataType.TYPE_STEP_COUNT_DELTA);

    if (Intent.ACTION_VIEW.equals(getIntent().getAction()) && supportedType.equals(getIntent().getType())
    {
        // Get the intent extras
        long startTime = Fitness.getStartTime(getIntent(), TimeUnit.MILLISECONDS);
        long endTime = Fitness.getEndTime(getIntent(), TimeUnit.MILLISECONDS);
        DataSource dataSource = DataSource.extract(getIntent());
    }
}

如要取得自訂資料類型的 MIME 類型，請使用 MIME_TYPE_PREFIX敬上 常數：

Kotlin

val supportedType = DataType.MIME_TYPE_PREFIX + "com.company.customdatatype"

Java

String supportedType = DataType.MIME_TYPE_PREFIX + "com.company.customdatatype";

如要查看資料，請叫用意圖

如要叫用意圖以便透過其他應用程式查看資料，請使用 HistoryApi.ViewIntentBuilder敬上 類別：

Kotlin

// Inside your activity
val startTime = ...
val endTime = ...
val dataSource = ...
val dataType = ...

val fitIntent = HistoryApi.ViewIntentBuilder(this, dataType)
    .setTimeInterval(startTime, endTime, TimeUnit.MILLISECONDS)
    .setDataSource(dataSource) // Optional if a specific data source is desired
    .setPreferredApplication("com.example.app") // Optional if you'd like a
    // specific app to handle the intent if that app is installed on the device
    .build()

Java

// Inside your activity
long startTime = ...
long endTime = ...
DataSource dataSource = ...
DataType dataType = ...

Intent fitIntent = new HistoryApi.ViewIntentBuilder(this, dataType)
    .setTimeInterval(startTime, endTime, TimeUnit.MILLISECONDS)
    .setDataSource(dataSource) // Optional if a specific data source is desired
    .setPreferredApplication("com.example.app") // Optional if you'd like a
    // specific app to handle the intent if that app is installed on the device
    .build();

進一步瞭解如何使用意圖和意圖 篩選器。