สร้างแอป 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 ที่หลากหลายในจีน ในกรณีอื่นๆ ทรัพยากร 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 จะส่งข้อความและซิงค์ข้อมูลกับโทรศัพท์ 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 ของ โมดูลอุปกรณ์เคลื่อนที่ของคุณ แทนที่ทรัพยากร 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
บริการเรียกรถ	打车去三里屯	การดำเนินการ 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 ข้อมูล ภูมิศาสตร์:ละติจูด,ลองจิจูด?q=融科资讯中心

Voice Assistant ยังสามารถใช้ Intent ทั่วไปของ Android เพื่อทำให้เกิดพฤติกรรมบางอย่างที่เกี่ยวข้อง

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

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

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

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


รูปที่ 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 วิธีดังนี้

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

จัดจำหน่ายแอปในจีน

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

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