เมื่อสร้างแอป Wear OS สำหรับประเทศจีน คุณต้องคำนึงถึงโทรศัพท์มือถือที่ไม่มี Google Play บริการที่ติดตั้งไว้ล่วงหน้า หน้านี้มีการเปลี่ยนแปลงทั่วไปที่นักพัฒนาแอปอาจต้องทำ ตลาดจีน
ใช้บริการ Google Play เวอร์ชันที่ถูกต้อง
บริการ Google Play เวอร์ชัน 10.2.0 ให้การสนับสนุนทั่วโลกสำหรับ Fused Location Provider API และ Data Layer API คุณต้องใช้บริการ Google Play เวอร์ชันนี้หากใช้ API เหล่านี้เพื่อ เพื่อดูแลให้มีการรองรับอุปกรณ์ Wear OS ที่หลากหลายในจีน ในกรณีอื่นๆ ทรัพยากร Dependency คือ ไม่บังคับ
หมายเหตุ: แม้ว่าบริการ Google Play จะมี
API สําหรับแอป Wear OS และแอป Wear OS สําหรับจีนควรดําเนินการต่อ
ใช้ API ที่เกี่ยวข้องกับ GoogleApiClient
ดู
เข้าถึง Wearable API
API ผู้ให้บริการตำแหน่งที่ตั้ง Fused
หากคุณใช้ Fused Location Provider API ให้ใส่ทรัพยากร Dependency ต่อไปนี้ใน
ไฟล์ build.gradle
ของโมดูล Wear OS
ดึงดูด
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") }
API ชั้นข้อมูล
หากแอปของคุณใช้ Data Layer API คุณจะต้องเพิ่มบรรทัดต่อไปนี้ในส่วน
build.gradle
ไฟล์ของโมดูล Wear OS เวอร์ชันนี้ต้องใช้เวอร์ชัน 10.2.0
ไลบรารีของไคลเอ็นต์
ดึงดูด
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") ... }
เพิ่มบรรทัดต่อไปนี้ลงในไฟล์ build.gradle
ของ
โมดูลอุปกรณ์เคลื่อนที่ของคุณ แทนที่ทรัพยากร Dependency ของบริการ Google Play ด้วยการอ้างอิง
เวอร์ชัน 10.2.0
ดึงดูด
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") }
การตรวจสอบสิทธิ์
ก่อนใช้การตรวจสอบสิทธิ์ ให้ดูกรณีการใช้งานเพื่อดูว่าการตรวจสอบสิทธิ์นั้น ที่จำเป็น ตัวอย่างเช่น สำหรับแอปที่ส่งพยากรณ์อากาศ คุณไม่จำเป็นต้อง ลงชื่อเข้าใช้ รวมถึงสำหรับการตรวจสอบสิทธิ์
ถ้าคุณต้องการให้มีการตรวจสอบสิทธิ์ เราขอแนะนำให้ใช้ ไลบรารี AndroidX OAuth ซึ่งจำเป็นต้องใช้ ขั้นตอนการให้สิทธิ์รหัสการให้สิทธิ์ด้วย PKCE คุณยังสามารถใช้วิธีการอื่นๆ ที่อธิบายไว้ใน การตรวจสอบสิทธิ์ในอุปกรณ์ที่สวมใส่ได้ ไม่แนะนำให้ใช้ไลบรารีการสนับสนุนอุปกรณ์ที่สวมใส่ได้
สำหรับข้อมูลเพิ่มเติม โปรดดู ตัวอย่าง OAuth ของ Wear OS ใน GitHub
การแจ้งเตือนที่เชื่อมโยง
การแจ้งเตือนที่เชื่อมโยงใช้ไม่ได้ในจีน การแจ้งเตือนทางโทรศัพท์จะเชื่อมโยงกับ Wear OS เมื่ออุปกรณ์ Wear OS เชื่อมต่อกับโทรศัพท์โดยใช้บลูทูธเท่านั้น
ความเข้ากันได้ของตำแหน่งและพิกัดการแมป
ใช้
FusedLocationProvider
(FLP) เพื่อตรวจหาตำแหน่งของผู้ใช้ในจีน เช่นเดียวกับที่คุณทำ
สำหรับส่วนที่เหลือของโลก วิธีนี้ช่วยให้มั่นใจได้ว่าแอปจะพิจารณาข้อมูลที่ดีที่สุด
โดยไม่คำนึงถึงฮาร์ดแวร์ของนาฬิกาและแพลตฟอร์มโทรศัพท์ที่จับคู่กับนาฬิกา
การใช้ FLP ยังเพิ่มการเพิ่มประสิทธิภาพแบตเตอรี่ที่มีอยู่ในแพลตฟอร์ม Wear OS ด้วย
เมื่อผสานรวม FusedLocationProvider
กับ SDK แผนที่ของบุคคลที่สาม
โดยคำนึงถึงความเข้ากันได้ระหว่างผู้ให้บริการต่างๆ ด้วย
FusedLocationProvider
รายงานสถานที่ตาม
WGS84
โปรดแปลงระบบพิกัดตามความเหมาะสม
การสนับสนุนสำหรับ Google Fit
ของ Google Fit รองรับตัวนับจำนวนก้าว นาทีที่เคลื่อนไหว และคะแนนคาร์ดิโอในจีน ซึ่งสามารถใช้ได้สูงสุดถึง เป็นเวลา 7 วัน คุณเข้าถึงได้โดยไม่ต้องให้ข้อมูลเข้าสู่ระบบของผู้ใช้
รองรับการสั่งงานด้วยเสียง
แพลตฟอร์ม Wear OS มอบการใช้คำสั่งเสียงหลายอย่างตามการดำเนินการของผู้ใช้ เช่น _"แสดง อัตราการเต้นของหัวใจ"_ หรือ _"ตั้งปลุก"_ ซึ่งจะช่วยให้ผู้ใช้บอกสิ่งที่ต้องการทำ แล้วปล่อยให้ระบบ หาวิธีทำกิจกรรมที่ดีที่สุดเพื่อเริ่มต้น
เมื่อผู้ใช้พูดการสั่งงานด้วยเสียง แอปจะกรองเอาเจตนาที่จะเริ่มทำงานเพื่อเริ่ม
กิจกรรม หากต้องการเริ่มบริการในเบื้องหลัง ให้แสดงกิจกรรมเป็นตัวบ่งชี้ภาพและเริ่ม
ในกิจกรรม อย่าลืมเรียกใช้
finish()
เพื่อเลิกใช้องค์ประกอบภาพ
ต่อไปนี้คือรายการเสียง Intent ที่แพลตฟอร์ม Wear OS รองรับ
หมวดหมู่ | ตัวอย่าง | ข้อกำหนดของ Intent |
บริการเรียกรถ | 打车去三里屯 | การดำเนินการ
เพิ่มเติม
โดยจะเพิ่มหรือไม่ก็ได้ |
ตั้งปลุก | 设置个明早七点的闹钟 | การดำเนินการ
เพิ่มเติม
บริการเสริมเหล่านี้เป็นตัวเลือก ระบุส่วนเสริมเหล่านี้อย่างใดอย่างหนึ่ง ทั้งคู่ หรือไม่ใช่เลย |
ตั้งเวลา | 设置个三分钟的倒计时 | การดำเนินการ
เพิ่มเติม
|
เริ่มต้นจับเวลา | 开始计时 | การดำเนินการ
|
เริ่มหรือหยุดขี่จักรยาน | 开始骑车 | การดำเนินการ
ประเภท MIME
เพิ่มเติม
|
เริ่มหรือหยุดการวิ่ง | 开始跑步 | การดำเนินการ
ประเภท MIME
เพิ่มเติม
|
เริ่มหรือหยุดการออกกำลังกาย | 开始锻炼 | การดำเนินการ
ประเภท MIME
เพิ่มเติม
|
แสดงอัตราการเต้นของหัวใจ | 查看心率 | การดำเนินการ
ประเภท MIME
|
แสดงจำนวนก้าว | 查看步数 | การดำเนินการ
ประเภท MIME
|
การไปยังรายการต่างๆ | 导航去三里屯 | การดำเนินการ
ข้อมูล ภูมิศาสตร์:ละติจูด,ลองจิจูด?q=融科资讯中心 |
Voice Assistant ยังสามารถใช้ Intent ทั่วไปของ Android เพื่อทำให้เกิดพฤติกรรมบางอย่างที่เกี่ยวข้อง
การรองรับโปรแกรมจำลอง
คุณใช้รูปภาพโปรแกรมจำลอง Wear OS เวอร์ชันจีนเพื่อทดสอบแอปได้ ช่วงเวลานี้ รองรับ Android Studio 3.0 ขึ้นไป
หากต้องการทดสอบแอปของคุณในโปรแกรมจำลองเวอร์ชันจีน ให้ทำตามขั้นตอนต่อไปนี้
- ติดตั้ง Android Emulator
- ดาวน์โหลดรูปภาพของ Wear OS for China จากเครื่องมือจัดการ SDK ใช้เวอร์ชันสำหรับ Wear OS 3.5 (API ระดับ 30)
- เลือกรูปภาพ Wear OS for China เมื่อสร้างโปรไฟล์ AVD
- เรียกใช้โปรแกรมจำลอง Wear OS for China เพื่อพัฒนาซอฟต์แวร์
![](https://developer.android.com/static/wear/images/emulator-ch.png?hl=th)
![](https://developer.android.com/static/wear/images/emulator-screen.png?hl=th)
รูปที่ 1 ตัวอย่างโปรแกรมจำลอง Wear OS เวอร์ชันจีน
โปรแกรมจำลอง Wear OS เวอร์ชันนี้มาพร้อมกับแอปที่ติดตั้งไว้ล่วงหน้าหลายรายการ
- โหมดแอมเบียนท์
- รายชื่อติดต่อ
- การป้อนข้อมูลด้วยลายมือของ Google
- บริการ Google Play
- บริการด้านสุขภาพสำหรับ Wear OS
- การจดจำคำสั่งให้ดำเนินการสำหรับอุปกรณ์ LE
- พินอิน
- Play Store (ปรับให้เข้ากับอุปกรณ์ในประเทศจีน)
- นาฬิกาพกพา
- TalkBack
- หน้าปัด (ทั้งเวอร์ชันแอนะล็อกและดิจิทัล)
- บริการหลักของ Wear
เริ่มช่องบลูทูธและ Wi-Fi สำหรับแอปโดยเฉพาะ
Wear OS จะกำหนดเส้นทางคำขอเครือข่ายโดยอัตโนมัติ ในกรณีส่วนใหญ่ จะไม่มีข้อกำหนด เพื่อให้แอปเปิดช่องบลูทูธและ Wi-Fi เฉพาะแอป
หากแอปขอช่องบลูทูธและ Wi-Fi เฉพาะแอปในประเทศจีน คำขอนั้น
ล้มเหลวอย่างสิ้นเชิง แต่กล่องโต้ตอบจะแสดงขึ้นมาแทน
ที่ขอให้คุณยืนยันจากผู้ใช้ หากผู้ใช้ยืนยัน ช่องจะเปิดขึ้น ปัญหานี้จะเกิดขึ้นทุก
ไม่ใช่แค่การใช้งานครั้งแรก BluetoothAdapter.enable()
หรือ
WifiManager.setEnabled(true)
คือ
โทรออก
หมายเหตุ: สำหรับการกำหนดเป้าหมายแอป
Android 10 (API ระดับ 29) ขึ้นไปสำหรับการโทร
WifiManager.setEnabled()
จะต้องเป็นแอประบบหรือ
เครื่องมือควบคุมนโยบายด้านอุปกรณ์ (DPC)
โหมดตรวจสอบสิทธิ์
ในประเทศจีน อุปกรณ์ Wear OS สําหรับจีนทำงานในโหมดตรวจสอบสิทธิ์
กำหนดขีดจำกัดเกี่ยวกับวิธีใช้แอปที่มี targetApiLevel
ต่ำกว่า 23 โปรดตรวจสอบขีดจำกัดต่อไปนี้
- แม้ว่าระบบจะให้สิทธิ์ ณ เวลาที่ติดตั้ง แต่เมื่อแอปที่มี
targetApiLevel
ต่ำกว่า 23 สตาร์ทเป็นครั้งแรก กล่องโต้ตอบจะปรากฏขึ้นเพื่อขอ ให้ผู้ใช้ยืนยันสิทธิ์ สำหรับแอปนี้ - คอมโพเนนต์ในแอป เช่น เครื่องรับสัญญาณประกาศ บริการ และกิจกรรม ไม่ตอบสนองต่อเหตุการณ์ที่เกี่ยวข้องก่อนการใช้แอปเป็นครั้งแรก
ด้วยเหตุนี้ เราขอแนะนำให้คุณใช้ targetApiLevel
เวอร์ชัน 23 ขึ้นไป
และนำ
สิทธิ์ของแอป
แนวทางปฏิบัติแนะนำ
ใช้ API บริการ Google Play อื่นๆ
หากแอปของคุณใช้ API ของบริการ Google Play นอกเหนือจาก API ที่สวมใส่ได้ จากนั้นแอปของคุณต้องตรวจสอบว่า API เหล่านี้จะพร้อมใช้งานในระหว่างรันไทม์และตอบสนองอย่างเหมาะสม คุณตรวจสอบความพร้อมใช้งานของ API บริการ Google Play ได้ 2 วิธีดังนี้
- ใช้อินสแตนซ์
GoogleApiClient
แยกต่างหากสำหรับเชื่อมต่อกับ API อื่นๆ อินเทอร์เฟซนี้มี Callback ไปยัง แจ้งเตือนแอปของคุณให้ success หรือ ไม่สำเร็จของการเชื่อมต่อ ในกรณีที่เชื่อมต่อไม่สำเร็จConnectionResult
จะแสดงAPI_UNAVAILABLE
หากต้องการเรียนรู้วิธีจัดการความล้มเหลวในการเชื่อมต่อ โปรดดู เข้าถึง Google APIs - ใช้
addApiIfAvailable()
ของGoogleApiClient.Builder
เพื่อเชื่อมต่อกับ API ที่จำเป็น หลังจากonConnected()
Callback เริ่มทำงาน ให้ใช้hasConnectedApi()
เมธอดเพื่อให้มั่นใจว่า API ที่ขอแต่ละรายการเชื่อมต่ออย่างถูกต้อง
จัดจำหน่ายแอปในจีน
คุณสามารถเผยแพร่แอปผ่าน เพื่อให้เข้าถึงผู้ใช้ Wear OS ในประเทศจีนได้อย่างมีประสิทธิภาพ App Store ของบุคคลที่สามสำหรับ Wear OS เช่น
- Galaxy Store สำหรับอุปกรณ์ Samsung
- ร้านค้า Xiaomi สำหรับอุปกรณ์ Xiaomi
- Mobvoi สำหรับอุปกรณ์อื่นๆ ทั้งหมด