راهنمای مهاجرت

گوگل محصولات و خدمات بهداشتی زیادی را در مجموعه خود دارد، از جمله Health Connect. APIهای Google Fit منسوخ شده‌اند و تا 30 ژوئن 2025 پشتیبانی می‌شوند، زمانی که رد می‌شوند. دستورالعمل‌های زیر به شما نشان می‌دهد که از هر Google Fit Android API به کدام API یا پلتفرم مهاجرت کنید.

انتقال از Fit Android API به Health Connect API

3 مرحله کلیدی وجود دارد که باید برای مهاجرت به Health Connect API طی کنید.

مرحله 1: یکپارچه سازی

اولین گام برای ادغام این است که Health Connect را به برنامه خود اضافه کنید. این شامل موارد زیر خواهد بود:

  • با دنبال کردن این مراحل شروع با Health Connect یکپارچه شوید.
  • انواع داده و حالت دسترسی مورد نیاز را در مانیفست برنامه اعلام کنید.
  • برای دسترسی به Health Connect از کاربر اجازه بگیرید.
  • خواندن/نوشتن داده ها با توجه به موارد استفاده خاص یا گردش کار شما.

مرحله 2: مهاجرت

توصیه می کنیم هر دو ادغام Google Fit Android API و Health Connect API خود را در زمانی که کاربران از یک پلتفرم به پلتفرم دیگر مهاجرت می کنند، فعال نگه دارید. در حالی که Google Fit Android API را منسوخ کرده‌ایم، می‌خواهیم API را زودتر از 30 ژوئن 2025 رد کنیم. این به کاربران زمان کافی برای تغییر به Health Connect و ادامه خدمات خود می دهد.

مرحله 3: تمیز کردن

برای حذف Google Fit SDK این مراحل را دنبال کنید:

  1. کد مرتبط با Google Fit Android API را حذف کنید.
  2. وابستگی های خدمات Google Play را حذف کنید.

سنسور API

Sensor API به شما امکان می‌دهد داده‌های خام حسگر را در برنامه خود در زمان واقعی بخوانید. Sensor API کارهای زیر را انجام می دهد:

  • منابع داده موجود در دستگاه و دستگاه های همراه را فهرست می کند.
  • شنوندگان را برای دریافت داده های حسگر خام ثبت می کند.
  • شنوندگان را لغو ثبت می کند تا دیگر داده های حسگر خام را دریافت نکنند.

از Sensor API به API ها یا پلتفرم های زیر مهاجرت کنید:

تلفن بپوشید

از SensorManager، FusedLocationProvider استفاده کنید

از خدمات بهداشتی استفاده کنید

  • PassiveMonitoringClient
  • MeasureClient
  • ExerciseClient

    یا از SensorManager، FusedLocationProvider استفاده کنید

Session API

جلسات بازه زمانی را نشان می دهد که در طی آن کاربران یک فعالیت تناسب اندام را انجام می دهند.

Session API به برنامه شما اجازه می‌دهد جلساتی را در فروشگاه تناسب اندام ایجاد کند.

از Session API به API ها یا پلتفرم های زیر مهاجرت کنید:

تلفن بپوشید

شروع/توقف: قابل اجرا نیست. برنامه باید وضعیت جلسات در حال انجام را به صورت داخلی پیگیری کند.

خواندن/نوشتن: از Health Connect استفاده کنید.

شروع/توقف: استفاده از خدمات بهداشتی (ExerciseClient)

خواندن/نوشتن: از Health Connect از طریق برنامه تلفن همراه استفاده کنید.

برای گردش های کاری خاص، موارد زیر را توصیه می کنیم:

  • درج جلسه: توسعه دهندگان باید از Health Connect از طریق برنامه تلفن همراه استفاده کنند و بر این اساس یک رکورد ExerciseSession یا یک رکورد SleepSession را وارد کنند.

API ضبط

Recording API به برنامه شما این امکان را می‌دهد تا با ایجاد اشتراک، ذخیره خودکار داده‌های حسگر را به روشی کم‌توان از باتری درخواست کند. یک اشتراک با یک برنامه Android مرتبط است و شامل یک نوع داده تناسب اندام یا یک منبع داده خاص است.

از Recording API به API ها یا پلتفرم های زیر مهاجرت کنید:

تلفن بپوشید

برای مهاجرت از Recording API این مراحل را دنبال کنید:

  1. ضبط داده را با استفاده از Recording API در تلفن همراه پیاده سازی کنید.
  2. داده های گرفته شده را در Health Connect یا پایگاه داده برنامه خود بنویسید.

از خدمات بهداشتی استفاده کنید

  • PassiveMonitoringClient
  • ExerciseClient

برای اطلاعات بیشتر در مورد تفاوت های بین PassiveMonitoringClient و ExerciseClient به مستندات خدمات بهداشتی مراجعه کنید.

History API

History API به برنامه شما امکان می‌دهد عملیات‌های انبوه را در فروشگاه تناسب اندام انجام دهد، از جمله خواندن، درج، به‌روزرسانی، و حذف داده‌های مربوط به سلامت و تندرستی.

از History API به API ها یا پلتفرم های زیر مهاجرت کنید:

تلفن بپوشید

از Health Connect استفاده کنید

از Health Connect از برنامه تلفن همراه استفاده کنید و نه از پوشیدنی.

API اهداف

اهداف اهدافی در برنامه Google Fit هستند که کاربران می توانند برای خود تعیین کنند. آنها به کاربران انگیزه می دهند تا هر روز فعال بمانند. از داخل نمایه خود، کاربران می توانند تعداد قدم ها و نقاط قلبی را که می خواهند برای هر روز هدف قرار دهند، تنظیم کنند. پلتفرم Fit با استفاده از Goals API اهداف آنها را ثبت می کند و فعالیت روزانه آنها را در برابر آنها ردیابی می کند.

تلفن بپوشید
API جایگزینی موجود نیست. API جایگزینی موجود نیست.

BLE API

برنامه شما می‌تواند دستگاه‌های موجود با انرژی کم‌مصرف بلوتوث (BLE) را پیدا کند و داده‌های حسگر را با استفاده از BLE API در پلتفرم Google Fit وارد کند.

از BLE API به API ها یا پلتفرم های زیر مهاجرت کنید:

تلفن بپوشید
مستقیماً از APIهای بلوتوث اندروید استفاده کنید. مستقیماً از APIهای بلوتوث اندروید استفاده کنید.
،

گوگل محصولات و خدمات بهداشتی زیادی را در مجموعه خود دارد، از جمله Health Connect. APIهای Google Fit منسوخ شده‌اند و تا 30 ژوئن 2025 پشتیبانی می‌شوند، زمانی که رد می‌شوند. دستورالعمل‌های زیر به شما نشان می‌دهد که از هر Google Fit Android API به کدام API یا پلتفرم مهاجرت کنید.

انتقال از Fit Android API به Health Connect API

3 مرحله کلیدی وجود دارد که باید برای مهاجرت به Health Connect API طی کنید.

مرحله 1: یکپارچه سازی

اولین گام برای ادغام این است که Health Connect را به برنامه خود اضافه کنید. این شامل موارد زیر خواهد بود:

  • با دنبال کردن این مراحل شروع با Health Connect یکپارچه شوید.
  • انواع داده و حالت دسترسی مورد نیاز را در مانیفست برنامه اعلام کنید.
  • برای دسترسی به Health Connect از کاربر اجازه بگیرید.
  • خواندن/نوشتن داده ها با توجه به موارد استفاده خاص یا گردش کار شما.

مرحله 2: مهاجرت

توصیه می کنیم هر دو ادغام Google Fit Android API و Health Connect API خود را در زمانی که کاربران از یک پلتفرم به پلتفرم دیگر مهاجرت می کنند، فعال نگه دارید. در حالی که Google Fit Android API را منسوخ کرده‌ایم، می‌خواهیم API را زودتر از 30 ژوئن 2025 رد کنیم. این به کاربران زمان کافی برای تغییر به Health Connect و ادامه خدمات خود می دهد.

مرحله 3: تمیز کردن

برای حذف Google Fit SDK این مراحل را دنبال کنید:

  1. کد مرتبط با Google Fit Android API را حذف کنید.
  2. وابستگی های خدمات Google Play را حذف کنید.

سنسور API

Sensor API به شما امکان می‌دهد داده‌های خام حسگر را در برنامه خود در زمان واقعی بخوانید. Sensor API کارهای زیر را انجام می دهد:

  • منابع داده موجود در دستگاه و دستگاه های همراه را فهرست می کند.
  • شنوندگان را برای دریافت داده های حسگر خام ثبت می کند.
  • شنوندگان را لغو ثبت می کند تا دیگر داده های حسگر خام را دریافت نکنند.

از Sensor API به API ها یا پلتفرم های زیر مهاجرت کنید:

تلفن بپوشید

از SensorManager، FusedLocationProvider استفاده کنید

از خدمات بهداشتی استفاده کنید

  • PassiveMonitoringClient
  • MeasureClient
  • ExerciseClient

    یا از SensorManager، FusedLocationProvider استفاده کنید

Session API

جلسات بازه زمانی را نشان می دهد که در طی آن کاربران یک فعالیت تناسب اندام را انجام می دهند.

Session API به برنامه شما اجازه می‌دهد جلساتی را در فروشگاه تناسب اندام ایجاد کند.

از Session API به API ها یا پلتفرم های زیر مهاجرت کنید:

تلفن بپوشید

شروع/توقف: قابل اجرا نیست. برنامه باید وضعیت جلسات در حال انجام را به صورت داخلی پیگیری کند.

خواندن/نوشتن: از Health Connect استفاده کنید.

شروع/توقف: استفاده از خدمات بهداشتی (ExerciseClient)

خواندن/نوشتن: از Health Connect از طریق برنامه تلفن همراه استفاده کنید.

برای گردش های کاری خاص، موارد زیر را توصیه می کنیم:

  • درج جلسه: توسعه دهندگان باید از Health Connect از طریق برنامه تلفن همراه استفاده کنند و بر این اساس یک رکورد ExerciseSession یا یک رکورد SleepSession را وارد کنند.

API ضبط

Recording API به برنامه شما این امکان را می‌دهد تا با ایجاد اشتراک، ذخیره خودکار داده‌های حسگر را به روشی کم‌توان از باتری درخواست کند. یک اشتراک با یک برنامه Android مرتبط است و شامل یک نوع داده تناسب اندام یا یک منبع داده خاص است.

از Recording API به API ها یا پلتفرم های زیر مهاجرت کنید:

تلفن بپوشید

برای مهاجرت از Recording API این مراحل را دنبال کنید:

  1. ضبط داده را با استفاده از Recording API در تلفن همراه پیاده سازی کنید.
  2. داده های گرفته شده را در Health Connect یا پایگاه داده برنامه خود بنویسید.

از خدمات بهداشتی استفاده کنید

  • PassiveMonitoringClient
  • ExerciseClient

برای اطلاعات بیشتر در مورد تفاوت های بین PassiveMonitoringClient و ExerciseClient به مستندات خدمات بهداشتی مراجعه کنید.

History API

History API به برنامه شما امکان می‌دهد عملیات‌های انبوه را در فروشگاه تناسب اندام انجام دهد، از جمله خواندن، درج، به‌روزرسانی، و حذف داده‌های مربوط به سلامت و تندرستی.

از History API به API ها یا پلتفرم های زیر مهاجرت کنید:

تلفن بپوشید

از Health Connect استفاده کنید

از Health Connect از برنامه تلفن همراه استفاده کنید و نه از پوشیدنی.

API اهداف

اهداف اهدافی در برنامه Google Fit هستند که کاربران می توانند برای خود تعیین کنند. آنها به کاربران انگیزه می دهند تا هر روز فعال بمانند. از داخل نمایه خود، کاربران می توانند تعداد قدم ها و نقاط قلبی را که می خواهند برای هر روز هدف قرار دهند، تنظیم کنند. پلتفرم Fit با استفاده از Goals API اهداف آنها را ثبت می کند و فعالیت روزانه آنها را در برابر آنها ردیابی می کند.

تلفن بپوشید
API جایگزینی موجود نیست. API جایگزینی موجود نیست.

BLE API

برنامه شما می‌تواند دستگاه‌های موجود با انرژی کم‌مصرف بلوتوث (BLE) را پیدا کند و داده‌های حسگر را با استفاده از BLE API در پلتفرم Google Fit وارد کند.

از BLE API به API ها یا پلتفرم های زیر مهاجرت کنید:

تلفن بپوشید
مستقیماً از APIهای بلوتوث اندروید استفاده کنید. مستقیماً از APIهای بلوتوث اندروید استفاده کنید.