برنامه‌های Wear OS را برای چین ایجاد کنید

هنگام ایجاد برنامه‌های Wear OS برای چین، باید گوشی‌هایی را که سرویس‌های Google Play از پیش نصب نشده‌اند حساب کنید. این صفحه شامل تغییرات رایجی است که توسعه دهندگان ممکن است برای بازار چین نیاز داشته باشند.

از نسخه صحیح سرویس های Google Play استفاده کنید

خدمات Google Play نسخه 10.2.0 پشتیبانی جهانی از Fused Location Provider API و Data Layer API ارائه می دهد. اگر از این APIها برای اطمینان از پشتیبانی از مجموعه وسیع‌تری از دستگاه‌های Wear OS در چین استفاده می‌کنید، باید از این نسخه از خدمات Google Play استفاده کنید. در موارد دیگر این وابستگی اختیاری است.

توجه: اگرچه سرویس‌های Google Play حاوی API برای برنامه‌های Wear OS هستند، برنامه‌های Wear OS برای چین باید به استفاده از APIهای مرتبط با GoogleApiClient ادامه دهند. دسترسی به Wearable API را ببینید.

Fused Location Provider API

اگر از Fused Location Provider API استفاده می کنید، وابستگی زیر را در فایل build.gradle ماژول Wear OS خود قرار دهید:

شیار

dependencies {
    ...
    implementation 'com.google.android.gms:play-services-location:10.2.0'
}

کاتلین

dependencies {
    ...
    implementation("com.google.android.gms:play-services-location:10.2.0")
}

API لایه داده

توجه: Data Layer API فقط با تلفن‌های Android و ساعت‌های Wear OS می‌تواند پیام ارسال کند و داده‌ها را همگام‌سازی کند. اگر دستگاه Wear OS شما با دستگاه iOS جفت شده باشد، Data Layer API کار نخواهد کرد.

به همین دلیل، از API لایه داده به عنوان راه اصلی برای برقراری ارتباط با شبکه استفاده نکنید. در عوض، در برنامه Wear OS خود از همان الگوی برنامه تلفن همراه پیروی کنید، با برخی تفاوت‌های جزئی که در دسترسی به شبکه و همگام‌سازی در Wear OS توضیح داده شده است.

اگر برنامه شما از Data Layer API استفاده می کند، باید خط زیر را به فایل build.gradle ماژول Wear OS خود اضافه کنید. خط نیاز به استفاده از نسخه 10.2.0 کتابخانه مشتری دارد.

شیار

dependencies {
    ...
    implementation 'com.google.android.gms:play-services-wearable:10.2.0'
    ...
}

کاتلین

dependencies {
    ...
    implementation("com.google.android.gms:play-services-wearable:10.2.0")
    ...
}

خط زیر را به فایل build.gradle ماژول موبایل خود اضافه کنید. وابستگی خدمات Google Play را با ارجاع به نسخه 10.2.0 جایگزین کنید.

شیار

dependencies {
    ...
    implementation 'com.google.android.gms:play-services-wearable:10.2.0'
}

کاتلین

dependencies {
    ...
    implementation("com.google.android.gms:play-services-wearable:10.2.0")
}

احراز هویت

قبل از اجرای احراز هویت، موارد استفاده خود را بررسی کنید تا ببینید آیا واقعاً احراز هویت مورد نیاز است یا خیر. به عنوان مثال، برای برنامه ای که پیش بینی آب و هوا را ارائه می دهد، احتمالاً نیازی به ورود به سیستم و در نتیجه احراز هویت نیست.

اگر به احراز هویت نیاز دارید، توصیه می کنیم از کتابخانه AndroidX Oauth استفاده کنید. این امر مستلزم استفاده از مجوز کد مجوز با جریان PKCE است. همچنین می‌توانید از یکی از روش‌های توضیح داده شده در تأیید هویت در پوشیدنی‌ها استفاده کنید. استفاده از کتابخانه پشتیبانی پوشیدنی توصیه نمی شود.

برای اطلاعات بیشتر، Wear OS OAuth Sample را در GitHub ببینید.

اعلان های پل شده

اعلان‌های پل‌شده در چین پشتیبانی نمی‌شوند. اعلان‌های تلفن تنها در صورتی به Wear OS متصل می‌شوند که دستگاه Wear OS با استفاده از بلوتوث به تلفن متصل باشد.

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

از FusedLocationProvider (FLP) برای شناسایی موقعیت کاربر در چین استفاده کنید، همانطور که برای سایر نقاط جهان انجام می دهید. این تضمین می کند که برنامه شما بدون در نظر گرفتن سخت افزار ساعت و پلت فرم تلفنی که ساعت با آن جفت شده است، بهترین اطلاعات را در نظر می گیرد. استفاده از FLP همچنین بهینه سازی باتری را اضافه می کند که در پلت فرم Wear OS تعبیه شده است.

هنگام ادغام FusedLocationProvider با SDK های نقشه شخص ثالث، سازگاری مختصات بین ارائه دهندگان را در نظر بگیرید. FusedLocationProvider مکان را طبق استاندارد WGS84 گزارش می کند. حتما سیستم های مختصات را در صورت لزوم تبدیل کنید.

پشتیبانی از Google Fit

شمارشگر گام‌های انباشته، دقیقه‌های حرکت و نقاط قلب Google Fit با حداکثر هفت روز سابقه در چین پشتیبانی می‌شود. شما می توانید بدون ارائه اعتبار کاربری به این مورد دسترسی داشته باشید.

پشتیبانی از اقدام صوتی

پلت فرم Wear OS چندین هدف صوتی را ارائه می دهد که بر اساس اقدامات کاربر مانند _"نمایش ضربان قلب"_ یا _"تنظیم زنگ هشدار"_ است. این به کاربران امکان می‌دهد آنچه را که می‌خواهند انجام دهند بگویند و به سیستم اجازه می‌دهد بهترین فعالیت را برای شروع مشخص کند.

وقتی کاربران یک کنش صوتی را بیان می‌کنند، برنامه شما می‌تواند هدفی را که برای شروع یک فعالیت اجرا می‌شود فیلتر کند. برای شروع یک سرویس در پس‌زمینه، یک فعالیت را به عنوان نشانه بصری نشان دهید و سرویس را در فعالیت شروع کنید. حتماً finish() فراخوانی کنید تا از نشانه بصری خلاص شوید.

در اینجا لیستی از اهداف صوتی پشتیبانی شده توسط پلتفرم Wear OS آمده است:

دسته بندی	مثال	مشخصات هدف
تگرگ ماشین	打车去三里屯	اقدام com.google.android.gms.actions.RESERVE_TAXI_RESERVATION اضافی to : مقصد شناخته شده اضافی اختیاری است.
تنظیم زنگ	设置一个明早七点的闹钟	اقدام android.intent.action.SET_ALARM موارد اضافی android.provider.AlarmClock.EXTRA_HOUR : یک عدد صحیح با ساعت زنگ هشدار android.provider.AlarmClock.EXTRA_MINUTES : یک عدد صحیح با دقیقه زنگ هشدار این موارد اضافی اختیاری هستند. یکی، هر دو یا هیچ یک از این موارد اضافی را ارائه کنید.
تنظیم تایمر	设置一个三分钟的倒计时	اقدام android.intent.action.SET_TIMER موارد اضافی android.provider.AlarmClock.EXTRA_LENGTH : یک عدد صحیح در محدوده 1 تا 86400 (تعداد ثانیه در 24 ساعت) که نشان دهنده طول تایمر است.
کرونومتر را شروع کنید	开始计时	اقدام com.google.android.wearable.action.STOPWATCH
دوچرخه سواری را شروع یا متوقف کنید	开始骑车	اقدام vnd.google.fitness.TRACK نوع میم vnd.google.fitness.activity/biking موارد اضافی actionStatus : رشته ای با مقدار ActiveActionStatus هنگام شروع و CompletedActionStatus هنگام توقف
یک دویدن را شروع یا متوقف کنید	开始跑步	اقدام vnd.google.fitness.TRACK نوع میم vnd.google.fitness.activity/running موارد اضافی actionStatus : رشته ای با مقدار ActiveActionStatus هنگام شروع، و CompletedActionStatus هنگام توقف
یک تمرین را شروع یا متوقف کنید	开始锻炼	اقدام vnd.google.fitness.TRACK نوع میم vnd.google.fitness.activity/other موارد اضافی actionStatus : رشته ای با مقدار ActiveActionStatus هنگام شروع، و CompletedActionStatus هنگام توقف
نمایش ضربان قلب	查看心率	اقدام vnd.google.fitness.VIEW نوع میم vnd.google.fitness.data_type/com.google.heart_rate.bpm
نمایش تعداد گام ها	查看步数	اقدام vnd.google.fitness.VIEW نوع میم vnd.google.fitness.data_type/com.google.step_count.cumulative
ناوبری	导航去三里屯	اقدام android.intent.action.VIEW داده ها جغرافیا: عرض جغرافیایی، طول جغرافیایی؟q=融科资讯中心

دستیار صوتی همچنین می‌تواند از اهداف رایج Android موجود برای تحریک رفتارهای خاص در صورت لزوم استفاده کند.

پشتیبانی شبیه ساز

می توانید از نسخه چینی تصویر شبیه ساز Wear OS برای آزمایش برنامه های خود استفاده کنید. این توسط Android Studio 3.0 و بالاتر پشتیبانی می شود.

برای آزمایش برنامه های خود در نسخه چینی شبیه ساز، مراحل زیر را دنبال کنید:

1. شبیه ساز اندروید را نصب کنید.
2. تصاویر Wear OS for China را از مدیر SDK دانلود کنید. از نسخه Wear OS 3.5 (سطح API 30) استفاده کنید.
3. هنگام ایجاد نمایه AVD، تصویر Wear OS for China را انتخاب کنید.
4. شبیه ساز Wear OS for China را برای توسعه اجرا کنید.


شکل 1. نمونه هایی از نسخه چینی شبیه ساز Wear OS.

این نسخه از شبیه ساز Wear OS دارای چندین برنامه از پیش نصب شده است:

• حالت محیطی
• مخاطبین
• ورودی دست خط گوگل
• خدمات گوگل پلی
• خدمات بهداشتی برای Wear OS
• تشخیص کلید واژه برای دستگاه های LE
• پینیین
• Play Store (اقتباس شده برای دستگاه‌ها در چین)
• ساعت جیبی
• TalkBack
• صفحه های ساعت (هر دو نسخه آنالوگ و دیجیتال)
• از خدمات اصلی استفاده کنید

یک کانال بلوتوث و وای فای مخصوص برنامه را راه اندازی کنید

Wear OS به طور خودکار درخواست های شبکه را مسیریابی می کند. در بیشتر موارد، برنامه نیازی به باز کردن کانال بلوتوث و وای فای مخصوص برنامه ندارد.

اگر برنامه‌ای درخواست یک کانال بلوتوث و وای‌فای ویژه برنامه در چین کند، درخواست بی‌صدا انجام نمی‌شود. در عوض، یک گفتگو نمایش داده می شود که از کاربر برای تأیید درخواست می کند. در صورت تایید کاربر، کانال باز می شود. این هر بار اتفاق می افتد، نه فقط در اولین استفاده. BluetoothAdapter.enable() یا WifiManager.setEnabled(true) فراخوانی می شود.

توجه: برای برنامه‌ای که Android 10 (سطح API 29) یا بالاتر را هدف قرار می‌دهد تا با WifiManager.setEnabled() تماس بگیرد، باید یک برنامه سیستم یا یک کنترل‌کننده خط‌مشی دستگاه (DPC) باشد.

حالت بررسی مجوز

در چین، Wear OS برای دستگاه‌های چینی در حالت بررسی مجوز اجرا می‌شود، که محدودیت‌هایی را برای نحوه استفاده از برنامه‌هایی با targetApiLevel کمتر از ۲۳ اعمال می‌کند. محدودیت‌های زیر را مرور کنید:

• حتی اگر مجوزها در زمان نصب اعطا می‌شوند، وقتی برنامه‌ای با targetApiLevel کمتر از 23 برای اولین بار شروع می‌شود، یک گفتگو ظاهر می‌شود که از کاربر می‌خواهد مجوزهای این برنامه را تأیید کند.
• اجزای برنامه، مانند گیرنده‌های پخش، سرویس‌ها و فعالیت‌ها قبل از استفاده از برنامه برای اولین بار به رویدادهای مربوطه پاسخ نمی‌دهند.

در نتیجه، توصیه می‌کنیم از targetApiLevel 23 یا بالاتر استفاده کنید و بهترین شیوه‌های مجوزهای برنامه را بپذیرید.

از سایر APIهای خدمات Google Play استفاده کنید

اگر برنامه شما از API های خدمات Google Play به غیر از Wearable API استفاده می کند، برنامه شما باید بررسی کند که آیا این API ها برای استفاده در طول زمان اجرا در دسترس هستند یا خیر و به درستی پاسخ می دهد. دو راه برای بررسی در دسترس بودن API های سرویس Google Play وجود دارد:

1. از یک نمونه GoogleApiClient جداگانه برای اتصال به سایر APIها استفاده کنید. این رابط شامل تماس‌هایی است که برنامه شما را از موفقیت یا عدم موفقیت اتصال آگاه می‌کند. در صورت اتصال ناموفق، ConnectionResult API_UNAVAILABLE نشان می‌دهد. برای آشنایی با نحوه رسیدگی به خرابی‌های اتصال، به دسترسی به APIهای Google مراجعه کنید.
2. از متد addApiIfAvailable() GoogleApiClient.Builder برای اتصال به APIهای مورد نیاز استفاده کنید. پس از روشن شدن فراخوانی onConnected() ، از متد hasConnectedApi() استفاده کنید تا مطمئن شوید که هر یک از API های درخواستی به درستی متصل شده اند.

برنامه ها را در چین توزیع کنید

برای دسترسی مؤثر به کاربران Wear OS برای چین، می‌توانید از طریق فروشگاه‌های برنامه Wear OS شخص ثالث مانند موارد زیر توزیع کنید:

• فروشگاه گلکسی برای دستگاه های سامسونگ
• فروشگاه شیائومی برای دستگاه های شیائومی
• Mobvoi برای همه دستگاه های دیگر