สร้างแอป 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 คุณต้องเพิ่มบรรทัดต่อไปนี้ลงในไฟล์ build.gradle ของโมดูล Wear OS บรรทัดนี้ต้องใช้ไลบรารีไคลเอ็นต์เวอร์ชัน 10.2.0

Groovy

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

Groovy

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: จำนวนเต็มที่มีนาทีการปลุก

คุณจะใช้ส่วนเสริมเหล่านี้หรือไม่ก็ได้ ระบุข้อมูลเสริมเหล่านี้อย่างใดอย่างหนึ่งหรือทั้ง 2 อย่าง หรือไม่ต้องระบุเลย

ตั้งเวลา ตั้งค่าการนับถอยหลัง 3 นาที การดำเนินการ

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 สำหรับจีนเมื่อสร้างโปรไฟล์ AVD
  4. เรียกใช้โปรแกรมจำลอง Wear OS สำหรับประเทศจีนเพื่อการพัฒนา

    5. รูปที่ 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 Store สำหรับอุปกรณ์ Xiaomi
  • Mobvoi สำหรับอุปกรณ์อื่นๆ ทั้งหมด