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

رابط‌های برنامه‌نویسی کاربردی گوگل فیت (Google Fit APIs) در سال ۲۰۲۶ منسوخ خواهند شد. گوگل چندین محصول و خدمات سلامت و تندرستی ارائه می‌دهد تا به کاربران شما کمک کند پس از منسوخ شدن، به اهداف خود دست یابند.

دستورالعمل‌های زیر به شما نشان می‌دهند که بر اساس نحوه‌ی استفاده‌تان از APIهای اندروید Google Fit، به کدام سرویس مهاجرت کنید.

ما این صفحه را با آخرین اطلاعات و راهنمایی‌ها به‌روز نگه خواهیم داشت.

ادغام‌های API متناسب

اگر از یک یا چند API مربوط به Fit استفاده می‌کنید اما لینک مستقیمی به برنامه Fit در رابط کاربری خود قرار نمی‌دهید ، این دستورالعمل‌ها برای شما مناسب هستند. اگر Fit را در رابط کاربری خود فعال می‌کنید، به دستورالعمل‌های ادغام برنامه Fit مراجعه کنید.

برنامه‌هایی که از Fit Recording API برای ثبت مراحل استفاده می‌کنند

API ضبط تناسب اندام به برنامه شما اجازه می‌دهد تا با ایجاد اشتراک‌ها، درخواست ذخیره‌سازی خودکار داده‌های حسگر را به شیوه‌ای با مصرف بهینه باتری ارائه دهد. هر اشتراک، یک برنامه اندروید را به یک نوع داده تناسب اندام یا منبع داده خاص متصل می‌کند و نوع داده Step معمولاً برای ثبت گام‌ها استفاده می‌شود.

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

جدول ۱: مراحل مهاجرت از Fit Recording API
تلفن بپوشید
  1. برای ادامه نمایش داده‌های مراحل محلی در برنامه خود، ضبط داده‌ها را با استفاده از Recording API در موبایل پیاده‌سازی کنید.
  2. برای نمایش تعداد کل قدم‌ها، شامل سیستم تجمیعی قدم‌ها از سایر برنامه‌ها و دستگاه‌ها، Health Connect را به برنامه خود اضافه کنید .

از خدمات درمانی استفاده کنید:

  • کلاینت مانیتورینگ غیرفعال
  • کلاینت تمرین

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

برنامه‌هایی که از API تاریخچه برای خواندن یا نوشتن داده‌ها در فروشگاه تناسب اندام استفاده می‌کنند

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

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

جدول ۲: مراحل مهاجرت از Fit History API
تلفن بپوشید

Health Connect را به برنامه خود اضافه کنید .

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

برنامه‌هایی که از API سنسور برای نمایش داده‌های تناسب اندام در لحظه استفاده می‌کنند

رابط برنامه‌نویسی کاربردی حسگر (Sensor API) به شما امکان می‌دهد داده‌های خام حسگر را در برنامه خود به صورت بلادرنگ (real time) بخوانید. رابط برنامه‌نویسی کاربردی حسگر (Sensor API) موارد زیر را انجام می‌دهد:

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

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

جدول ۳: مراحل مهاجرت از API حسگر تناسب
تلفن بپوشید

استفاده از حسگرها ، API ارائه دهنده موقعیت مکانی Fused

استفاده از سرویس‌های سلامت در Wear OS:

  • PassiveMonitoringClient
  • MeasureClient
  • ExerciseClient

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

برنامه‌هایی که از Session API برای ارائه خلاصه فعالیت‌ها استفاده می‌کنند

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

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

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

جدول ۴: مراحل مهاجرت از API جلسه متناسب
تلفن بپوشید

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

خواندن/نوشتن: Health Connect را به برنامه خود اضافه کنید .

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

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

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

  • درج یک جلسه: توسعه‌دهندگان باید از Health Connect به همراه برنامه تلفن همراه خود استفاده کنند و بر اساس آن، یک ExerciseSessionRecord یا یک SleepSessionRecord درج کنند.

برنامه‌هایی که از Goals API استفاده می‌کنند

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

جدول ۵: راهنمای مهاجرت برای Fit Goals API
تلفن بپوشید
هیچ API جایگزینی در دسترس نیست. هیچ API جایگزینی در دسترس نیست.

برنامه‌هایی که از BLE API استفاده می‌کنند

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

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

جدول 6: مراحل مهاجرت از Fit BLE API
تلفن بپوشید
مستقیماً از API های بلوتوث اندروید استفاده کنید. مستقیماً از API های بلوتوث اندروید استفاده کنید.

ادغام برنامه‌های متناسب

در ادامه نحوه ادغام برنامه Fit بسته به اینکه آیا کاربران فعلی یا کاربران جدید برای برنامه خود دارید، نشان داده شده است.

کاربران فعلی برنامه شما

اگر رابط کاربری برنامه شما شامل راهی برای اتصال کاربران به Google Fit باشد (یا اگر برنامه شما در لیست برنامه‌های سازگار با Google Fit قرار داشته باشد)، می‌توانید ادغام برنامه Fit خود را برای کاربران فعلی ادامه دهید.

ما این بخش را با اطلاعاتی در مورد زمان لغو یکپارچه‌سازی برنامه Fit شما و بهترین گزینه‌های شما برای حفظ تجربه کاربری‌تان، به‌روزرسانی خواهیم کرد. در عین حال، می‌توانید با ما در ارتباط باشید .

جدول ۷: توصیه‌هایی برای کاربران فعلی که از یکپارچه‌سازی با برنامه Fit استفاده می‌کنند
این کار را انجام دهید این کار را نکن
Health Connect را به عنوان یک گزینه جدید در برنامه خود ارائه دهید .

روی مزایای کاربر مانند داده‌ها و بینش‌های غنی‌تر، حریم خصوصی و امنیت تمرکز کنید.

همگام‌سازی با Health Connect

از کاربران بخواهید که از Google Fit جدا شوند.

قطع ارتباط از Health Connect

کاربران جدید برنامه شما

برای ارائه تجربه‌ای مشابه به کاربران جدید برنامه‌تان، توصیه می‌کنیم یکپارچه‌سازی Health Connect را ایجاد کنید .

Health Connect به شما امکان دسترسی به منابع و انواع جدید داده را می‌دهد تا تجربه‌ای غنی‌تر برای کاربران فراهم شود. داده‌ها روی دستگاه ذخیره می‌شوند و به طور ایمن بین برنامه‌هایی که کاربر اجازه می‌دهد به اشتراک گذاشته می‌شوند و این امر باعث خصوصی و ایمن شدن داده‌ها می‌شود.

جدول ۸: توصیه‌هایی برای کاربران جدید با ادغام برنامه Fit
این کار را انجام دهید این کار را نکن
Health Connect را در جریان راه‌اندازی برنامه خود بگنجانید. Fit را به عنوان اپلیکیشنی ارائه دهید که کاربران می‌توانند پس از در دسترس قرار گرفتن Health Connect به آن متصل شوند.