เราขอแนะนำให้แอป Wear OS ทำงานโดยไม่ขึ้นอยู่กับโทรศัพท์ เพื่อให้ผู้ใช้ทำงานต่างๆ บนนาฬิกาได้โดยไม่ต้องเข้าถึงโทรศัพท์ Android หรือ iOS หากแอปสมาร์ทวอทช์ต้องมีการโต้ตอบทางโทรศัพท์ คุณต้องทำเครื่องหมายแอป Wear OS เป็นแบบไม่สแตนด์อโลนและทำตามขั้นตอนเพื่อให้แน่ใจว่าผู้ใช้มีแอปโทรศัพท์พร้อมใช้งาน
วางแผนแอป
คุณใช้ Android App Bundle เพื่อสร้าง Android Package Kit (APK) ที่เพิ่มประสิทธิภาพโดยอัตโนมัติสำหรับการกำหนดค่าอุปกรณ์ของผู้ใช้แต่ละรายภายใต้ข้อมูลแอปพลิเคชันเดียวกันได้ ซึ่งจะช่วยให้ผู้ใช้ดาวน์โหลดเฉพาะโค้ดและทรัพยากรที่จำเป็นต่อการเรียกใช้แอปของคุณ
ดูข้อมูลเกี่ยวกับการตั้งค่าแอปเพื่อจัดจำหน่ายผ่าน Google Play Store ได้ที่จัดแพ็กเกจและจัดจำหน่ายแอป Wear OS และคู่มือการเริ่มต้นใช้งาน Android App Bundle
สำหรับแอปใหม่ ระดับ API เป้าหมายต้องเป็น 34 ขึ้นไป ดูข้อมูลเพิ่มเติมได้ที่ปฏิบัติตามข้อกำหนดระดับ API เป้าหมายของ Google Play การกำหนดเป้าหมายระดับ API ล่าสุดที่พร้อมใช้งานจะช่วยให้มั่นใจได้ว่าแอปจะทำงานได้ดีในแพลตฟอร์มเวอร์ชันปัจจุบัน
ดูข้อมูลเกี่ยวกับคำขอเครือข่ายและการเข้าถึงเครือข่ายที่มีแบนด์วิดท์สูงได้ที่การเข้าถึงเครือข่ายและการซิงค์ใน Wear OS
กำหนดแอปเป็นแอป Wear OS
คุณต้องกำหนดแท็ก
<uses-feature> ในไฟล์ Manifest สำหรับ Android ของแอป
หากต้องการระบุว่าเป็นแอปสมาร์ทวอทช์ ให้เพิ่มรายการดังต่อไปนี้
<uses-feature android:name="android.hardware.type.watch" />
ระบุว่าแอปเป็นแบบสแตนด์อโลนหรือไม่สแตนด์อโลน
แอปสมาร์ทวอทช์ถือเป็นแอปแบบสแตนด์อโลนหรือแบบไม่สแตนด์อโลน ดังนี้
- สแตนด์อโลน: แอปที่ทำงานแยกต่างหากโดยสมบูรณ์ซึ่งไม่ต้องใช้แอปโทรศัพท์สำหรับฟีเจอร์หลัก แม้ว่าข้อความแจ้ง "เปิดในโทรศัพท์" จะเป็นที่ยอมรับได้ แต่แอปต้องมีวิธีอื่นให้ผู้ใช้ดำเนินการฟังก์ชันของแอปให้เสร็จสมบูรณ์ เช่น Short Link หรือคิวอาร์โค้ด โดยไม่ต้องอาศัยโทรศัพท์ที่เชื่อมต่ออยู่
- ไม่สแตนด์อโลน: แอปที่ต้องพึ่งพาแอปในโทรศัพท์หรืออุปกรณ์อื่นสำหรับฟีเจอร์หลัก ตัวเลือกนี้เหมาะที่สุดสำหรับแอปที่ไม่สามารถระบุวิธีการอื่นได้โดยง่าย เช่น คิวอาร์โค้ดหรือลิงก์แบบย่อ เพื่อให้ฟังก์ชันหลักของแอปเสร็จสมบูรณ์ เช่น การตรวจสอบสิทธิ์
หมายเหตุ: แม้จะเป็นแอปที่ไม่ใช่แบบสแตนด์อโลน ผู้ใช้ก็สามารถติดตั้งแอป Wear OS ก่อนแอปบนมือถือได้ ดังนั้น หากแอป Wear OS ตรวจพบว่าอุปกรณ์พกพาที่อยู่ใกล้เคียงไม่มีแอปที่ใช้ร่วมกันที่จำเป็น ให้แจ้งให้ผู้ใช้ติดตั้งแอปที่ใช้ร่วมกัน
Google จะตรวจสอบความถูกต้องของสถานะสแตนด์อโลนของแอปในระหว่างการแสดงแอป ค่านี้ส่งผลต่อระดับการมองเห็นแอปภายใน Play Store บนอุปกรณ์ที่ไม่ได้เชื่อมต่อ เช่น อุปกรณ์ Wear OS ที่ไม่ได้จับคู่กับอุปกรณ์พกพา แอปที่ไม่สแตนด์อโลน รวมถึงแอปที่นักพัฒนาแอประบุอย่างไม่ถูกต้องว่าเป็น "สแตนด์อโลน" จะไม่พร้อมให้บริการแก่ผู้ใช้ในอุปกรณ์ที่ไม่เชื่อมต่อเหล่านี้
ในแอป Wear OS ให้ตั้งค่าองค์ประกอบ
meta-data com.google.android.wearable.standalone ในไฟล์ Manifest ของ Android เพื่อประกาศว่าแอปเป็นแบบสแตนด์อโลนหรือไม่ใช่สแตนด์อโลน
หากแอปสมาร์ทวอทช์เป็นแอปแบบสแตนด์อโลนที่ทำงานแยกต่างหากโดยสมบูรณ์ ให้ระบุข้อมูลนี้แก่ Google Play Store โดยตั้งค่า com.google.android.wearable.standalone เป็น true ดังนี้
<meta-data android:name="com.google.android.wearable.standalone" android:value="true" />
หากแอปสมาร์ทวอทช์ของคุณไม่ใช่แบบสแตนด์อโลนและต้องใช้แอปอื่นสำหรับฟีเจอร์หลัก ให้ตั้งค่า com.google.android.wearable.standalone เป็น false ซึ่งหมายความว่าแอปสมาร์ทวอทช์ต้องใช้อุปกรณ์อื่น แต่จะไม่ส่งผลต่อการโปรโมตแอปใน Google Play Store
หมายเหตุ:
แม้ว่าค่าของ com.google.android.wearable.standalone จะเป็น false แต่แอปสมาร์ทวอทช์ก็สามารถติดตั้งก่อนแอปโทรศัพท์ได้
ดังนั้น หากแอปสมาร์ทวอทช์ตรวจพบว่าโทรศัพท์ที่ใช้ร่วมกันไม่มีแอปโทรศัพท์ที่จำเป็นตามที่อธิบายไว้ในหน้านี้ ให้แจ้งให้ผู้ใช้ติดตั้งแอปโทรศัพท์
พื้นที่เก็บข้อมูลโค้ดและข้อมูลที่ใช้ร่วมกัน
คุณสามารถแชร์โค้ดระหว่างแอป Wear OS กับแอปโทรศัพท์ได้ เช่น โค้ดทั่วไปสำหรับเครือข่ายอาจอยู่ในคลังที่ใช้ร่วมกัน
หรือจะใส่โค้ดที่เจาะจงสำหรับรูปแบบของอุปกรณ์ไว้ในโมดูลแยกต่างหากก็ได้
คุณสามารถใช้ Storage API ของ Android มาตรฐานเพื่อจัดเก็บข้อมูลในเครื่องได้เหมือนกับที่ทำในโทรศัพท์ คุณสามารถใช้ DataStore เพื่อจัดเก็บคู่คีย์-ค่าและออบเจ็กต์ที่พิมพ์ หรือจะใช้ไลบรารี Persistence Room ก็ได้
ตรวจหาแอปของคุณในอุปกรณ์อื่น
แอปสมาร์ทวอทช์และแอปโทรศัพท์ที่เกี่ยวข้องจะตรวจหาได้ว่าแอปอีกแอปหนึ่งพร้อมใช้งานหรือไม่
แอปในโทรศัพท์และแอปสมาร์ทวอทช์สามารถใช้ CapabilityClient เพื่อโฆษณาการมีอยู่ของแอปไปยังอุปกรณ์ที่จับคู่แล้วได้ โดยอาจทำแบบคงที่หรือแบบไดนามิกก็ได้
เมื่อแอปอยู่บนโหนดในเครือข่าย Wear OS ของผู้ใช้ เช่น ในโทรศัพท์ นาฬิกาที่จับคู่ หรือในระบบคลาวด์ CapabilityClient จะช่วยให้แอปอื่นๆ ตรวจพบแอปดังกล่าวได้ ดูข้อมูลเพิ่มเติมได้ที่ค้นหาอุปกรณ์ที่เฉพาะเจาะจงโดยใช้ไคลเอ็นต์ความสามารถ
หากแอปหนึ่งตรวจไม่พบอีกแอปหนึ่ง คุณสามารถแจ้งให้ผู้ใช้เปิดข้อมูลผลิตภัณฑ์ใน Play Store บนอุปกรณ์ที่ได้รับผลกระทบได้ โซลูชันนี้เหมาะสำหรับแอปสมาร์ทวอทช์ที่ต้องใช้แอปที่ใช้ร่วมกันในโทรศัพท์จึงจะทำงานได้อย่างถูกต้อง
คุณต้องตรวจสอบว่า Play Store พร้อมใช้งานในอุปกรณ์หรือไม่ เนื่องจากโทรศัพท์บางรุ่น เช่น iPhone ไม่รองรับ Play Store
ส่วนต่อไปนี้จะอธิบายแนวทางปฏิบัติแนะนำสำหรับ 2 สถานการณ์ ได้แก่
- แอปสมาร์ทวอทช์แบบสแตนด์อโลนต้องใช้แอปโทรศัพท์
- แอปโทรศัพท์ต้องใช้แอปสมาร์ทวอทช์แบบสแตนด์อโลน
นอกจากนี้ คุณยังดูตัวอย่างตัวช่วยของ Datalayer ซึ่งแสดงวิธีใช้ไลบรารีตัวช่วยของ Datalayer ซึ่งเป็นส่วนหนึ่งของ Horologist ได้ด้วย ตัวช่วยเหล่านี้ช่วยให้คุณตรวจสอบการเชื่อมต่อระหว่างอุปกรณ์พกพากับอุปกรณ์ Wear OS ได้
ดูข้อมูลเพิ่มเติมเกี่ยวกับคลาสที่อธิบายไว้ในส่วนต่อไปนี้ได้ที่เอกสารอ้างอิง Wear OS API
ข้อมูลอ้างอิงดังกล่าวยังมีข้อมูลเกี่ยวกับคลาส PhoneTypeHelper ซึ่งมีเมธอด getPhoneDeviceType() ที่ช่วยให้แอป Wear OS ตรวจสอบได้ว่าโทรศัพท์ที่ใช้ร่วมกันเป็นอุปกรณ์ Android หรือ iOS
ระบุชื่อความสามารถในการตรวจหาแอปของคุณ
สำหรับแอปที่สอดคล้องกับอุปกรณ์แต่ละประเภท ไม่ว่าจะเป็นนาฬิกาหรือโทรศัพท์ ให้ระบุสตริงที่ไม่ซ้ำกันสำหรับชื่อความสามารถในไฟล์ res/values/wear.xml
ตัวอย่างเช่น ในโมดูลอุปกรณ์เคลื่อนที่ ไฟล์ wear.xml อาจมีข้อมูลต่อไปนี้
<resources xmlns:tools="http://schemas.android.com/tools" tools:keep="@array/android_wear_capabilities"> <string-array name="android_wear_capabilities"> <item>verify_remote_example_phone_app</item> </string-array> </resources>
ในโมดูล Wear OS ไฟล์ wear.xml จะมีค่าที่แตกต่างกันสำหรับชื่อความสามารถ เช่น ค่าต่อไปนี้
<resources xmlns:tools="http://schemas.android.com/tools" tools:keep="@array/android_wear_capabilities"> <string-array name="android_wear_capabilities"> <item>verify_remote_example_wear_app</item> </string-array> </resources>
ดูข้อมูลเพิ่มเติมได้ที่ค้นหาอุปกรณ์ที่เฉพาะเจาะจงโดยใช้ไคลเอ็นต์ความสามารถ
การตรวจหาแอปและการเปิด URL จากนาฬิกา
แอปสมาร์ทวอทช์สามารถตรวจจับได้ว่าโทรศัพท์ที่ใช้ร่วมกันของผู้ใช้มีแอปโทรศัพท์ของคุณหรือไม่ โดยทำตามขั้นตอนต่อไปนี้
-
ใช้
CapabilityClientเพื่อตรวจสอบว่ามีการติดตั้งแอปโทรศัพท์ในโทรศัพท์ที่จับคู่ไว้หรือไม่ ดูข้อมูลเพิ่มเติมได้ที่ตัวอย่างตัวช่วยของชั้นข้อมูลใน GitHub -
หากไม่ได้ติดตั้งแอปโทรศัพท์ในโทรศัพท์ ให้ใช้วิธี
PhoneDeviceType.getPhoneDeviceType()เพื่อตรวจสอบประเภทของโทรศัพท์ ดูรายละเอียดได้ในส่วนต่อไปนี้ -
หากระบบแสดงผลเป็น
PhoneDeviceType.DEVICE_TYPE_ANDROIDแสดงว่าโทรศัพท์เป็นโทรศัพท์ Android เรียกใช้RemoteActivityHelper.startRemoteActivity()ในอุปกรณ์ Wear OS เพื่อ เปิด Play Store ในโทรศัพท์ ใช้ URI ของ Market สำหรับแอปโทรศัพท์ ซึ่งอาจแตกต่างจาก URI ของแอป Wear เช่น ใช้ URI ของตลาด เช่นmarket://details?id=com.example.android.wearable.wear.finddevices -
หากระบบแสดงผลเป็น
PhoneDeviceType.DEVICE_TYPE_IOSแสดงว่าโทรศัพท์เป็น iOS ที่ไม่มี Play Store เปิด App Store ใน iPhone โดยเรียกใช้RemoteActivityHelper.startRemoteActivity()บนอุปกรณ์ Wear OS คุณสามารถระบุ URL ของ iTunes ของแอป เช่นhttps://itunes.apple.com/us/app/yourappnameจาก Wear OS คุณไม่สามารถระบุแบบเป็นโปรแกรมได้ว่าแอปโทรศัพท์ของคุณติดตั้งอยู่ในอุปกรณ์ iOS หรือไม่ แนวทางปฏิบัติแนะนำคือให้จัดเตรียมกลไกให้ผู้ใช้เรียกให้เปิด App Store ด้วยตนเอง
หมายเหตุ: ใช้ RemoteActivityHelper API ตามที่อธิบายไว้ในส่วนก่อนหน้าเพื่อระบุว่าให้เปิด URL ใดก็ได้ในโทรศัพท์จากนาฬิกา และไม่จำเป็นต้องใช้แอปโทรศัพท์
รายละเอียดสำหรับการตรวจหาประเภทของโทรศัพท์ที่จับคู่ไว้
ต่อไปนี้คือข้อมูลโค้ดที่ใช้เมธอด getPhoneDeviceType() เพื่อตรวจสอบประเภทโทรศัพท์ที่จับคู่กับนาฬิกา
var phoneDeviceType: Int = PhoneTypeHelper.getPhoneDeviceType(this)
ค่าที่แสดงผลโดยเมธอด getPhoneDeviceType() จะเป็นค่าใดค่าหนึ่งต่อไปนี้
| ค่าที่ส่งคืน | คำอธิบาย |
|---|---|
DEVICE_TYPE_ANDROID
|
โทรศัพท์ที่ใช้ร่วมกันเป็นอุปกรณ์ที่ใช้ Android |
DEVICE_TYPE_IOS
|
โทรศัพท์ที่ใช้ร่วมกันเป็นอุปกรณ์ iOS |
DEVICE_TYPE_UNKNOWN
|
โทรศัพท์ที่ใช้ร่วมกันเป็นอุปกรณ์ที่ไม่รู้จัก |
DEVICE_TYPE_ERROR
|
เกิดข้อผิดพลาดในการระบุประเภทของโทรศัพท์ที่จับคู่ ควรตรวจสอบอีกครั้งในภายหลัง |
การตรวจหาแอปที่เริ่มจากโทรศัพท์ Android
โทรศัพท์ Android สามารถตรวจจับได้ว่าอุปกรณ์ Wear OS ของผู้ใช้มีแอปสมาร์ทวอทช์ของคุณหรือไม่ โดยทำตามขั้นตอนต่อไปนี้
-
ใช้
NodeClientเพื่อค้นหานาฬิกาทั้งหมดที่เชื่อมต่อกับโทรศัพท์ของผู้ใช้ ดูข้อมูลเพิ่มเติมได้ที่ตัวอย่างตัวช่วยของชั้นข้อมูลใน GitHub -
ใช้
CapabilityClientเพื่อตรวจสอบว่านาฬิกาเรือนใดของผู้ใช้ที่ติดตั้งแอปของคุณไว้ -
หากไม่ได้ติดตั้งแอปในนาฬิกาทั้งหมดของผู้ใช้ ให้ผู้ใช้เปิด Play Store ในอุปกรณ์ Wear OS ที่เหลือจากโทรศัพท์โดยใช้เมธอด
RemoteActivityHelper.startRemoteActivity()ใช้ URI ของ Market สำหรับแอป Wear OS ซึ่งอาจแตกต่างจาก URI ของแอปโทรศัพท์ เช่น ใช้ URI ของตลาด เช่นmarket://details?id=com.example.android.wearable.wear.finddevices
ข้อมูลตำแหน่งสำหรับนาฬิกาที่จับคู่กับ iPhone
สำหรับนาฬิกาที่จับคู่กับ iPhone ให้ใช้ผู้ให้บริการ Fused Location (FLP) เพื่อรับข้อมูลตำแหน่งในนาฬิกา ดูข้อมูลเพิ่มเติมได้ที่ตรวจหาตำแหน่งใน Wear OS
หากโทรศัพท์ที่ใช้ร่วมกันพร้อมใช้งาน FLP จะใช้โทรศัพท์ที่ใช้ร่วมกันเพื่อรับข้อมูลตำแหน่ง
รับเฉพาะข้อมูลที่จำเป็น
โดยทั่วไป เมื่อรับข้อมูลจากอินเทอร์เน็ต ให้รับเฉพาะข้อมูลที่จำเป็นเท่านั้น ไม่เช่นนั้น คุณอาจทำให้เกิดเวลาในการตอบสนอง การใช้หน่วยความจำ และการใช้แบตเตอรี่โดยไม่จำเป็น
เมื่อเชื่อมต่อนาฬิกาผ่านการเชื่อมต่อบลูทูธ LE แอปของคุณอาจเข้าถึงแบนด์วิดท์ได้เพียง 4 กิโลไบต์ต่อวินาที ทั้งนี้ขึ้นอยู่กับนาฬิกา ดังนั้น เราขอแนะนำให้ทำตามขั้นตอนต่อไปนี้
- ตรวจสอบคำขอและการตอบกลับของเครือข่ายเพื่อหาข้อมูลเพิ่มเติมที่จำเป็นสำหรับแอปโทรศัพท์เท่านั้น
- ลดขนาดรูปภาพขนาดใหญ่ก่อนส่งผ่านเครือข่ายไปยังนาฬิกา
สำหรับกรณีที่จำเป็นต้องใช้เครือข่ายแบนด์วิดท์สูง โปรดดูหัวข้อการเข้าถึงเครือข่ายแบนด์วิดท์สูง
ตัวอย่างโค้ดเพิ่มเติม
ตัวอย่างตัวช่วยของ Datalayer จะสาธิตการใช้ API ที่ครอบคลุมในหน้านี้เพิ่มเติม