สร้างแอป Wear OS สําหรับจีน

เมื่อสร้างแอป Wear OS สำหรับประเทศจีน คุณต้องคำนึงถึงโทรศัพท์มือถือที่ไม่มี Google Play บริการที่ติดตั้งไว้ล่วงหน้า หน้านี้มีการเปลี่ยนแปลงทั่วไปที่นักพัฒนาแอปอาจต้องทำ ตลาดจีน

ใช้บริการ Google Play เวอร์ชันที่ถูกต้อง

บริการ Google Play เวอร์ชัน 10.2.0 รองรับ Fused Location Provider API และ Data Layer API ทั่วโลก คุณต้องใช้บริการ Google Play เวอร์ชันนี้หากใช้ API เหล่านี้เพื่อให้มั่นใจว่าอุปกรณ์ Wear OS หลากหลายรุ่นในจีนจะได้รับการรองรับ ในกรณีอื่นๆ คุณจะระบุการพึ่งพานี้หรือไม่ก็ได้

หมายเหตุ: แม้ว่าบริการ Google Play จะมี API สําหรับแอป Wear OS และแอป Wear OS สําหรับจีนควรดําเนินการต่อ ใช้ API ที่เกี่ยวข้องกับ GoogleApiClient ดู เข้าถึง Wearable API

Fused Location Provider API

หากคุณใช้ Fused Location Provider API ให้ใส่ทรัพยากร Dependency ต่อไปนี้ใน ไฟล์ build.gradle ของโมดูล Wear OS

Groovy

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")
}

Data Layer API

หมายเหตุ: Data Layer API จะส่งข้อความและซิงค์ข้อมูลกับโทรศัพท์ Android ได้เท่านั้น และนาฬิกา Wear OS หากอุปกรณ์ Wear OS จับคู่กับอุปกรณ์ iOS ข้อมูล Layer API จะไม่ทำงาน

ด้วยเหตุนี้ คุณจึงไม่ควรใช้ Data Layer 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'
    ...
}

Kotlin

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'
}

Kotlin

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

การตรวจสอบสิทธิ์

ก่อนใช้การตรวจสอบสิทธิ์ ให้ตรวจสอบ Use Case เพื่อดูว่าจำเป็นต้องใช้การตรวจสอบสิทธิ์จริงหรือไม่ ตัวอย่างเช่น แอปที่แสดงการพยากรณ์อากาศอาจไม่จำเป็นต้องมีการลงชื่อเข้าใช้และการตรวจสอบสิทธิ์

ถ้าคุณต้องการให้มีการตรวจสอบสิทธิ์ เราขอแนะนำให้ใช้ ไลบรารี 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 จะมอบคำสั่งเสียง Intent หลายเวอร์ชันที่อิงตามการกระทำของผู้ใช้ เช่น _"แสดง อัตราการเต้นของหัวใจ"_ หรือ _"ตั้งปลุก"_ ซึ่งจะช่วยให้ผู้ใช้พูดสิ่งที่ต้องการทำและช่วยให้ระบบค้นหากิจกรรมที่ดีที่สุดที่จะเริ่มต้น

เมื่อผู้ใช้พูดคำสั่งเสียง แอปจะกรอง Intent ที่เริ่มทํางานเพื่อเริ่มกิจกรรมได้ หากต้องการเริ่มบริการในเบื้องหลัง ให้แสดงกิจกรรมเป็นสัญญาณภาพและเริ่ม ในกิจกรรม อย่าลืมเรียกใช้ finish() เพื่อเลิกใช้องค์ประกอบภาพ

ต่อไปนี้คือรายการเสียง Intent ที่แพลตฟอร์ม Wear OS รองรับ

หมวดหมู่	ตัวอย่าง	ข้อกําหนดของ Intent
บริการเรียกรถ	打车去三里屯	การดำเนินการ 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 ประเภท MIME vnd.google.fitness.activity/biking เพิ่มเติม actionStatus: สตริงที่มีค่า ActiveActionStatus เมื่อเริ่มต้น และ CompletedActionStatus เมื่อหยุดรถ
เริ่มหรือหยุดการวิ่ง	开始跑步	การดำเนินการ vnd.google.fitness.TRACK ประเภท MIME vnd.google.fitness.activity/running เพิ่มเติม actionStatus: สตริงที่มีค่า ActiveActionStatus เมื่อเริ่มต้น และ CompletedActionStatus เมื่อหยุดรถ
เริ่มหรือหยุดการออกกำลังกาย	开始锻炼	การดำเนินการ vnd.google.fitness.TRACK ประเภท MIME vnd.google.fitness.activity/other เพิ่มเติม actionStatus: สตริงที่มีค่า ActiveActionStatus เมื่อเริ่มต้น และ CompletedActionStatus เมื่อหยุดรถ
แสดงอัตราการเต้นของหัวใจ	查看心率	การดำเนินการ vnd.google.fitness.VIEW ประเภท MIME vnd.google.fitness.data_type/com.google.heart_rate.bpm
แสดงจำนวนก้าว	查看步数	การดำเนินการ vnd.google.fitness.VIEW ประเภท MIME vnd.google.fitness.data_type/com.google.step_count.cumulative
การไปยังรายการต่างๆ	导航去三里屯	การดำเนินการ android.intent.action.VIEW ข้อมูล geo:latitude,longitude?q=融科资讯中心

Voice Assistant ยังใช้Intent ทั่วไปของ Android ที่มีอยู่เพื่อเรียกใช้ลักษณะการทำงานบางอย่างได้หากมี

การรองรับโปรแกรมจำลอง

คุณใช้ภาพโปรแกรมจำลอง Wear OS เวอร์ชันจีนเพื่อทดสอบแอปได้ ช่วงเวลานี้ รองรับ Android Studio 3.0 ขึ้นไป

หากต้องการทดสอบแอปของคุณในโปรแกรมจำลองเวอร์ชันจีน ให้ทำตามขั้นตอนต่อไปนี้

1. ติดตั้ง Android Emulator
2. ดาวน์โหลดรูปภาพของ Wear OS สำหรับจีนจากเครื่องมือจัดการ SDK ใช้เวอร์ชันสำหรับ Wear OS 3.5 (API ระดับ 30)
3. เลือกรูปภาพ Wear OS for China เมื่อสร้างโปรไฟล์ AVD
4. เรียกใช้โปรแกรมจำลอง Wear OS สำหรับประเทศจีนเพื่อการพัฒนา


รูปที่ 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) ขึ้นไปจะต้องเป็นแอประบบหรือเครื่องมือควบคุมนโยบายอุปกรณ์ (DPC) จึงจะเรียกใช้WifiManager.setEnabled()ได้

โหมดตรวจสอบสิทธิ์

ในจีน อุปกรณ์ Wear OS สำหรับจีนจะทำงานในโหมดการตรวจสอบสิทธิ์ ซึ่งจะจำกัดวิธีใช้แอปที่มี targetApiLevel ต่ำกว่า 23 โปรดดูขีดจํากัดต่อไปนี้

• แม้ว่าจะมีการให้สิทธิ์ ณ เวลาที่ติดตั้ง แต่เมื่อแอปที่มีtargetApiLevelต่ำกว่า 23 เริ่มทำงานเป็นครั้งแรก กล่องโต้ตอบจะปรากฏขึ้นเพื่อขอให้ผู้ใช้ยืนยันสิทธิ์สำหรับแอปนี้
• คอมโพเนนต์ในแอป เช่น เครื่องรับสัญญาณประกาศ บริการ และกิจกรรม ไม่ตอบสนองต่อเหตุการณ์ที่เกี่ยวข้องก่อนการใช้แอปเป็นครั้งแรก

เราจึงขอแนะนำให้ใช้ targetApiLevel 23 ขึ้นไปและใช้แนวทางปฏิบัติแนะนำเกี่ยวกับสิทธิ์ของแอป

ใช้ API อื่นๆ ของบริการ Google Play

หากแอปของคุณใช้ Google Play Services API อื่นนอกเหนือจาก Wearable API แอปจะต้องตรวจสอบว่า API เหล่านี้พร้อมใช้งานในระหว่างรันไทม์หรือไม่ และตอบสนองอย่างเหมาะสม การตรวจสอบความพร้อมใช้งานของ API บริการ Google Play มี 2 วิธีดังนี้

1. ใช้อินสแตนซ์ GoogleApiClient แยกต่างหากเพื่อเชื่อมต่อกับ API อื่นๆ อินเทอร์เฟซนี้มีคอลแบ็กเพื่อแจ้งให้แอปทราบถึงการเชื่อมต่อที่สำเร็จหรือล้มเหลว ในกรณีที่เชื่อมต่อไม่สำเร็จ ConnectionResult จะแสดง API_UNAVAILABLE ดูวิธีจัดการการเชื่อมต่อที่ไม่สําเร็จได้ที่ เข้าถึง Google API
2. ใช้เมธอด addApiIfAvailable() ของ GoogleApiClient.Builder เพื่อเชื่อมต่อกับ API ที่จําเป็น หลังจากการเรียกกลับ onConnected() เริ่มทํางาน ให้ใช้เมธอด hasConnectedApi() เพื่อให้มั่นใจว่า API แต่ละรายการที่ขอเชื่อมต่ออย่างถูกต้อง

เผยแพร่แอปในจีน

หากต้องการเข้าถึงผู้ใช้ Wear OS สำหรับจีนอย่างมีประสิทธิภาพ คุณสามารถเผยแพร่ผ่าน App Store ของ Wear OS ของบุคคลที่สาม เช่น

• Galaxy Store สำหรับอุปกรณ์ Samsung
• ร้านค้า Xiaomi สำหรับอุปกรณ์ Xiaomi
• Mobvoi สำหรับอุปกรณ์อื่นๆ ทั้งหมด