Tworząc aplikacje na Wear OS przeznaczone do Chin, musisz uwzględnić telefony bez Google Play fabrycznie zainstalowanych usług. Ta strona zawiera typowe zmiany, których deweloperzy mogą być zmuszeni do wprowadzenia rynku chińskiego.
Używanie prawidłowej wersji Usług Google Play
Usługi Google Play w wersji 10.2.0 dają pomoc na całym świecie Fused Location Provider API oraz Interfejs API warstwy danych. Jeśli używasz tych interfejsów API, musisz używać tej wersji Usług Google Play zapewnić obsługę szerszej gamy urządzeń z Wear OS w Chinach. W innych przypadkach zależność ta opcjonalnie.
Uwaga: Usługi Google Play zawierają
Interfejsy API dla aplikacji na Wear OS (aplikacje na Wear OS w Chinach powinny być nadal dostępne)
używać interfejsów API związanych z zasadą GoogleApiClient
; zobacz
.
Uzyskaj dostęp do interfejsu Wearable API.
Interfejs Fused Location Provider API
Jeśli używasz interfejsu Fused Location Provider API, uwzględnij tę zależność w
plik build.gradle
modułu Wear OS:
Odlotowe
dependencies { ... implementation 'com.google.android.gms:play-services-location:10.2.0' }
Kotlin
dependencies { ... implementation("com.google.android.gms:play-services-location:10.2.0") }
Interfejs API warstwy danych
Jeśli Twoja aplikacja używa interfejsu Data Layer API, musisz dodać ten wiersz do
Plik build.gradle
modułu Wear OS. Ten wiersz wymaga użycia wersji 10.2.0
z biblioteki klienta.
Odlotowe
dependencies { ... implementation 'com.google.android.gms:play-services-wearable:10.2.0' ... }
Kotlin
dependencies { ... implementation("com.google.android.gms:play-services-wearable:10.2.0") ... }
Dodaj ten wiersz do pliku build.gradle
do modułu mobilnego. Zastąp zależność Usług Google Play odwołaniem do elementu
wersji 10.2.0.
Odlotowe
dependencies { ... implementation 'com.google.android.gms:play-services-wearable:10.2.0' }
Kotlin
dependencies { ... implementation("com.google.android.gms:play-services-wearable:10.2.0") }
Uwierzytelnianie
Przed wdrożeniem uwierzytelniania przejrzyj przypadki użycia i sprawdź, czy uwierzytelnianie niezbędną. Na przykład w aplikacji dostarczającej prognozę pogody prawdopodobnie nie trzeba logowania, a tym samym do uwierzytelniania.
Jeśli wymagasz uwierzytelniania, zalecamy użycie Biblioteka Oauth AndroidaX Wymaga to korzystania z Proces przyznania kodu autoryzacji z PKCE. Możesz też użyć jednej z innych metod opisanych w artykule Uwierzytelnianie na urządzeniach do noszenia. Nie zalecamy korzystania z Biblioteki pomocy do noszenia.
Więcej informacji: Przykładowy protokół OAuth z Wear OS w GitHubie.
Powiadomienia mostkowane
Powiadomienia mostowe nie są obsługiwane w Chinach. Powiadomienia z telefonu są powiązane z Wear OS tylko wtedy, gdy urządzenie z Wear OS jest połączone z telefonem przez Bluetooth.
Zgodność lokalizacji i współrzędnych map
Należy użyć funkcji
FusedLocationProvider
(FLP), aby wykryć lokalizację użytkownika w Chinach – tak jak
dla reszty świata. Dzięki temu aplikacja bierze pod uwagę najlepsze informacje
niezależnie od modelu zegarka i platformy telefonu, z którą jest sparowany zegarek.
Korzystanie z FLP zapewnia też optymalizację baterii wbudowaną w platformę Wear OS.
Podczas integracji FusedLocationProvider
z pakietami SDK map innych firm
uwzględnia zgodność współrzędnych między dostawcami.
FusedLocationProvider
zgłasza lokalizację na podstawie
Standard WGS84.
Pamiętaj, by odpowiednio przekonwertować układy współrzędnych.
Pomoc Google Fit
Google Fit licznik kroków, minuty ruchu i punkty kardio są obsługiwane w Chinach. 7 dni historii. Możesz uzyskać do niego dostęp bez podawania danych logowania użytkownika.
Obsługa komend głosowych
Platforma Wear OS udostępnia kilka intencji głosowych opartych na działaniach użytkownika, np. _"Pokaż tętno"_ lub _"Ustaw alarm"_. Dzięki temu użytkownicy mogą powiedzieć, co chcą zrobić, a system określić najlepszą aktywność na początek.
Gdy użytkownik wypowiada komendę głosową, aplikacja może filtrować wyniki pod kątem wywołanego intencji,
działania. Aby uruchomić usługę w tle, wyświetl aktywność jako sygnał wizualny i uruchom polecenie
w ramach aktywności. Zadzwoń pod numer
finish()
, by pozbyć się sygnału wizualnego.
Oto lista intencji głosowych obsługiwanych przez platformę Wear OS:
Kategoria | Przykład | Specyfikacja intencji |
Grad w samochodzie | 打车去す里屯 | Działanie
Dodatkowe
Opcja dodatkowa jest opcjonalna. |
Ustaw alarm | 设置用明早七点的闹钟 | Działanie
Dodatki
Te dodatki są opcjonalne. Podaj jeden, oba lub żaden z tych dodatków. |
Ustaw minutnik | 设置型號分钟的倒计时 | Działanie
Dodatki
|
Uruchom stoper | 开始计时 | Działanie
|
Rozpoczynanie i zatrzymywanie jazdy rowerem | 开始骑车 | Działanie
Typ MIME
Dodatki
|
Rozpocznij lub zatrzymaj bieg | 开始跑步 | Działanie
Typ MIME
Dodatki
|
Rozpoczynanie lub zatrzymywanie treningu | 开始锻炼 | Działanie
Typ MIME
Dodatki
|
Pokaż tętno | 查看件率 | Działanie
Typ MIME
|
Pokaż liczbę kroków | 查看步数 | Działanie
Typ MIME
|
Nawigacja | 导航去用里屯 | Działanie
Dane geo:szerokość geograficzna,długość geograficzna?q=融科资讯中號 |
Asystent głosowy może też używać Typowe intencje Androida w odpowiednich przypadkach wywoływać określone zachowania.
Obsługa emulatora
Do testowania aplikacji możesz użyć chińskiej wersji obrazu emulatora Wear OS. Ten jest obsługiwana przez Androida Studio 3.0 lub nowszego.
Aby przetestować aplikacje emulatora w chińskiej wersji, wykonaj te czynności:
- Zainstaluj emulator Androida.
- Pobierz obrazy z Wear OS (Chiny) z menedżera pakietów SDK. Używaj wersji Wear OS 3.5 (poziom API 30).
- Podczas tworzenia profilu AVD wybierz obraz z Wear OS dla Chin.
- Na potrzeby programowania możesz uruchomić emulator Wear OS dla Chin.
![](https://developer.android.com/static/wear/images/emulator-ch.png?authuser=0000&hl=pl)
![](https://developer.android.com/static/wear/images/emulator-screen.png?authuser=0000&hl=pl)
Rysunek 1. Przykłady chińskiej wersji emulatora Wear OS.
Ta wersja emulatora Wear OS ma kilka wstępnie zainstalowanych aplikacji:
- Dźwięki otoczenia
- Kontakty
- Pismo odręczne Google
- Usługi Google Play
- Usługi zdrowotne na Wear OS
- Rozpoznawanie słów-kluczy na urządzeniach LE
- Pinyin
- Sklep Play (dostosowane do urządzeń w Chinach)
- Zegarek kieszonkowy
- TalkBack
- Tarcze (zarówno analogowe, jak i cyfrowe)
- Usługi podstawowe Wear
Inicjowanie kanału Bluetooth i Wi-Fi dla określonej aplikacji
Wear OS automatycznie kieruje żądania sieciowe. W większości przypadków nie trzeba , by aplikacja otworzyła własny kanał Bluetooth i Wi-Fi.
Jeśli aplikacja poprosi o połączenie kanału Bluetooth i Wi-Fi związanego z aplikacją w Chinach, żądanie:
po cichu zawiedzie. Zamiast tego pojawi się okno
proszą użytkownika o potwierdzenie. Jeśli użytkownik wyrazi zgodę, kanał zostanie otwarty. Zdarza się to co
o czasie, a nie tylko przy pierwszym użyciu. BluetoothAdapter.enable()
lub
WifiManager.setEnabled(true)
to
.
Uwaga: w przypadku kierowania na aplikację
Android 10 (poziom interfejsu API 29) lub nowszy
WifiManager.setEnabled()
, musi to być aplikacja systemowa lub
kontroler zasad dotyczących urządzeń (DPC).
Tryb sprawdzania uprawnień
W Chinach Wear OS dla urządzeń z Chin działa w trybie sprawdzania uprawnień,
nakłada pewne ograniczenia na sposób korzystania z aplikacji z targetApiLevel
poniżej 23. Sprawdź te limity:
- Mimo że uprawnienia są przyznawane w momencie instalacji, gdy aplikacja z tagiem
Po raz pierwszy zostanie uruchomiona wartość
targetApiLevel
mniejsza niż 23. Pojawi się okno z pytaniem użytkownik powinien potwierdzić uprawnienia dla tej aplikacji. - elementy aplikacji, takie jak odbiorniki, usługi i działania; nie reagują na odpowiednie zdarzenia przed użyciem aplikacji po raz pierwszy.
Dlatego zalecamy korzystanie z targetApiLevel
w wersji 23 lub nowszej
i wdrożyć
uprawnienia aplikacji
sprawdzone metody.
Używanie innych interfejsów API Usług Google Play
Jeśli Twoja aplikacja używa interfejsów API Usług Google Play innych niż Wearable API, aplikacja musi sprawdzić, te interfejsy API są dostępne do użytku w czasie działania i odpowiednio na nie reagują. Dostępność interfejsów API usługi Google Play możesz sprawdzić na 2 sposoby:
- Użyj oddzielnej instancji
GoogleApiClient
do łączenia się z innymi interfejsami API. Ten interfejs zawiera wywołania zwrotne do powiadamiaj aplikację o sukces lub może wystąpić błąd połączenia. W przypadku nieudanego połączeniaConnectionResult
pokazujeAPI_UNAVAILABLE
. Aby dowiedzieć się, jak postępować w przypadku błędów połączenia, zapoznaj się z sekcją Dostęp do interfejsów API Google - Korzystanie z
addApiIfAvailable()
GoogleApiClient.Builder
, aby połączyć się z wymaganymi interfejsami API. PoonConnected()
uruchomi się wywołanie zwrotne, użyjhasConnectedApi()
, aby zapewnić prawidłowe połączenie każdego żądanego interfejsu API.
Dystrybucja aplikacji w Chinach
Aby skutecznie docierać do użytkowników Wear OS w Chinach, możesz rozpowszechniać sklepów z aplikacjami na Wear OS innych firm, takich jak:
- Galaxy Store na urządzeniach Samsung
- Sklep Xiaomi na urządzenia Xiaomi
- Mobvoi w przypadku wszystkich pozostałych urządzeń.