لكل نقطة بيانات في 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();
اطّلِع على المزيد من المعلومات عن كيفية استخدام فلاتر الأهداف والغايات.