ระบุกิจกรรมการกำหนดค่าใน Wear OS

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

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

หมายเหตุ: การกำหนดค่าในแอปที่ใช้ร่วมกันของอุปกรณ์จะพร้อมใช้งานใน อุปกรณ์ที่กำหนดเป้าหมายเป็น API ระดับ 30 ขึ้นไป การกําหนดค่าในแอปแบบพกพาจะพร้อมใช้งานสําหรับผู้ใช้ทุกราย อุปกรณ์

ใช้เซสชันของเครื่องมือแก้ไข

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

เพื่อรองรับการใช้งานนี้ หน้าปัดสามารถกำหนดค่า Activity และให้ ผู้ใช้เปลี่ยนการตั้งค่าโดยใช้ EditorSession ที่แสดงผลจาก EditorSession.createOnWatchEditorSession ขณะที่ผู้ใช้ทำการเปลี่ยนแปลง การโทร EditorSession.renderWatchFaceToBitmap แสดงตัวอย่างแบบสดของหน้าปัดในเครื่องมือแก้ไข Activity

ระบุ Intent สำหรับกิจกรรมการกำหนดค่า

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

<service>
    <meta-data
        android:name="com.google.android.wearable.watchface.wearableConfigurationAction"
        android:value="androidx.wear.watchface.editor.action.WATCH_FACE_EDITOR" />
    <meta-data
        android:name="com.google.android.wearable.watchface.companionBuiltinConfigurationEnabled"
        android:value="true" />
</service>

กิจกรรมการกำหนดค่าจะบันทึกตัวกรอง Intent สำหรับ Intent นี้ แล้วระบบจะเริ่มการทำงานนี้ ความตั้งใจเมื่อผู้ใช้ต้องการกำหนดค่าหน้าปัดของคุณ

หากหน้าปัดมีเฉพาะกิจกรรมที่แสดงร่วมหรือกิจกรรมการกำหนดค่าอุปกรณ์ที่สวมใส่ได้ คุณจะ จำเป็นต้องใส่รายการข้อมูลเมตาที่เกี่ยวข้องจากตัวอย่างก่อนหน้านี้

สร้างกิจกรรมการกำหนดค่าที่สวมใส่ได้

กิจกรรมการกำหนดค่าที่สวมใส่ได้จะมีชุดตัวเลือกการปรับแต่งที่จำกัดสำหรับ เพราะเมนูที่ซับซ้อนจะไปยังส่วนต่างๆ ได้ยากในหน้าจอขนาดเล็ก ในอุปกรณ์ที่สวมใส่ได้ กิจกรรมการกำหนดค่า ให้ไบนารีออปชัน และเลือกปรับแต่งแค่ 2-3 รายการ ด้านหลักๆ ของหน้าปัด

หากต้องการสร้างกิจกรรมการกำหนดค่าที่สวมใส่ได้ ให้เพิ่มกิจกรรมใหม่ลงในโมดูลแอปที่สวมใส่ได้ และประกาศตัวกรอง Intent ต่อไปนี้ในไฟล์ Manifest ของแอปที่สวมใส่ได้

<activity
    android:name=".DigitalWatchFaceWearableConfigActivity"
    android:label="@string/digital_config_name">
    <intent-filter>
        <action android:name="androidx.wear.watchface.editor.action.WATCH_FACE_EDITOR" />
        <category android:name=
        "com.google.android.wearable.watchface.category.WEARABLE_CONFIGURATION" />
        <category android:name="android.intent.category.DEFAULT" />
    </intent-filter>
</activity>

ชื่อของการดำเนินการในตัวกรอง Intent นี้ต้องเป็น androidx.wear.watchface.editor.action.WATCH_FACE_EDITOR

ในกิจกรรมการกำหนดค่า ให้สร้าง UI แบบง่ายที่ให้ตัวเลือกแก่ผู้ใช้ ปรับแต่งหน้าปัดได้ด้วย

สร้างกิจกรรมการกำหนดค่าโฆษณาที่แสดงร่วม

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

หมายเหตุ: เขียนกิจกรรมการกำหนดค่าได้แบบพกพาเท่านั้น อุปกรณ์ที่ใช้ Android เช่น โทรศัพท์ แท็บเล็ต และอุปกรณ์แบบพับได้

หากต้องการสร้างกิจกรรมการกำหนดค่าโฆษณาที่แสดงร่วม ให้เพิ่มกิจกรรมใหม่ลงในโมดูลแอปมือถือและ ประกาศตัวกรอง Intent ต่อไปนี้ในไฟล์ Manifest ของแอปมือถือ

<activity
    android:name=".DigitalWatchFaceCompanionConfigActivity"
    android:label="@string/app_name">
    <intent-filter>
        <action android:name=
            "com.example.android.wearable.watchface.CONFIG_DIGITAL" />
        <category android:name=
        "com.google.android.wearable.watchface.category.COMPANION_CONFIGURATION" />
        <category android:name="android.intent.category.DEFAULT" />
    </intent-filter>
</activity>

ในกิจกรรมการกำหนดค่า ให้สร้าง UI ที่มีตัวเลือกในการปรับแต่ง องค์ประกอบที่กำหนดค่าได้ของหน้าปัด หลังจากที่ผู้ใช้เลือกแล้ว ให้ใช้ API ชั้นข้อมูลที่สวมใส่ได้เพื่อ สื่อสารการเปลี่ยนแปลงการกำหนดค่ากับกิจกรรมของหน้าปัด

โปรดดูแหล่งข้อมูลที่เกี่ยวข้องต่อไปนี้