تحديد مصدر البيانات

لكل نقطة بيانات في Google Fit مصدر بيانات مرتبط بها. مصادر البيانات سيحتوي على معلومات تحدِّد التطبيق أو الجهاز الذي يجمع أو تقوم بتحويل البيانات. يتوفّر اسم حزمة التطبيق لمصادر البيانات التي لا تمثل أداة استشعار مادية.

يتيح لك Google Fit إجراء ما يلي:

• استدعاء غرض لعرض البيانات المرتبطة بتطبيق معين.
• تلقّي أهداف لعرض البيانات باستخدام تطبيقك
• التعرّف على التطبيق الذي أدرج جلسة. لمزيد من المعلومات، يُرجى الاطّلاع على التعامل مع الجلسات.

تحديد التطبيق الذي أدرج نقطة بيانات

للحصول على اسم حزمة التطبيق الذي أدخل نقطة بيانات، أولاً الاتصال بالرقم DataPoint.getOriginalDataSource للحصول على مصدر البيانات، ثم قم باستدعاء DataSource.getAppPackageName :

KotlinJava

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

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>

ملاحظة: لا تضمِّن الفئة DEFAULT في فلتر الأهداف ما لم تدرج يريد أن يتلقّى تطبيقك أهدافًا تتعلّق بالبيانات التي أنشأتها تطبيقات أخرى.

فكل هدف يتلقاه تطبيقك من Google Fit هو من نوع واحد فقط، ولكن يمكنك الفلترة بحثًا عن أنواع MIME متعددة في فلتر أهداف واحد. المعلومات عن تطبيقك يجب أن يشمل فلتر الأهداف جميع أنواع البيانات التي تتوافق مع تطبيقك بما في ذلك أنواع البيانات المخصصة.

تتضمن أغراض اللياقة البدنية العناصر الإضافية التالية:

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

يمكنك الحصول على بيانات من هذه العناصر الإضافية على النحو التالي:

KotlinJava

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

@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 الثابت:

KotlinJava

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

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

استدعاء نية لعرض البيانات

لاستدعاء نية عرض البيانات باستخدام تطبيق آخر، استخدم HistoryApi.ViewIntentBuilder الفئة:

KotlinJava

// 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()

// 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();

مزيد من المعلومات حول كيفية استخدام الأهداف والنية والفلاتر.