แอป Wear OS แบบสแตนด์อโลนเทียบกับแอป Wear OS ที่ไม่สแตนด์อโลน

เราขอแนะนำให้แอป 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 จากนาฬิกา

แอปสมาร์ทวอทช์สามารถตรวจจับได้ว่าโทรศัพท์ที่ใช้ร่วมกันของผู้ใช้มีแอปโทรศัพท์ของคุณหรือไม่ โดยทำตามขั้นตอนต่อไปนี้

  1. ใช้ CapabilityClient เพื่อตรวจสอบว่ามีการติดตั้งแอปโทรศัพท์ในโทรศัพท์ที่จับคู่ไว้หรือไม่ ดูข้อมูลเพิ่มเติมได้ที่ตัวอย่างตัวช่วยของชั้นข้อมูลใน GitHub
  2. หากไม่ได้ติดตั้งแอปโทรศัพท์ในโทรศัพท์ ให้ใช้วิธี PhoneDeviceType.getPhoneDeviceType() เพื่อตรวจสอบประเภทของโทรศัพท์ ดูรายละเอียดได้ในส่วนต่อไปนี้
  3. หากระบบแสดงผลเป็น 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
  4. หากระบบแสดงผลเป็น 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 ของผู้ใช้มีแอปสมาร์ทวอทช์ของคุณหรือไม่ โดยทำตามขั้นตอนต่อไปนี้

  1. ใช้NodeClientเพื่อค้นหานาฬิกาทั้งหมดที่เชื่อมต่อกับโทรศัพท์ของผู้ใช้ ดูข้อมูลเพิ่มเติมได้ที่ตัวอย่างตัวช่วยของชั้นข้อมูลใน GitHub
  2. ใช้ CapabilityClient เพื่อตรวจสอบว่านาฬิกาเรือนใดของผู้ใช้ที่ติดตั้งแอปของคุณไว้
  3. หากไม่ได้ติดตั้งแอปในนาฬิกาทั้งหมดของผู้ใช้ ให้ผู้ใช้เปิด 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 ที่ครอบคลุมในหน้านี้เพิ่มเติม