إحالة البيانات

لكل نقطة بيانات في 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>

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

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

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

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

اطّلِع على مزيد من المعلومات عن كيفية استخدام النية بالشراء وفلاتر الأهداف.