توفير أنشطة الضبط على نظام التشغيل Wear OS

تتوافق بعض خلفيات شاشة الساعة مع مَعلمات الإعدادات للسماح للمستخدمين بتخصيص كيفية تخصيص خلفية شاشة الساعة. مظهره وسلوكه. على سبيل المثال، تتيح بعض خلفيات شاشة الساعة للمستخدمين اختيار لون خلفية مخصّص. مشاكل أخرى خلفيات شاشة ساعة تحدِّد الوقت في منطقتَين زمنيتَين مختلفتَين تتيح للمستخدمين اختيار المناطق الزمنية التي يهتمون بها.

خلفيات شاشة الساعة التي تتيح مَعلمات الإعدادات تسمح للمستخدمين بتخصيص خلفية شاشة ساعة باستخدام أي نشاط. يمكن للمستخدمين بدء نشاط إعداد الجهاز القابل للارتداء على الجهاز القابل للارتداء. يمكنه ابدأ أيضًا نشاط الإعداد المصاحب من التطبيق المحمول باليد، إذا كان مثبتًا. بالإضافة إلى ذلك، يمكن للمستخدمين ضبط خلفية شاشة الساعة في التطبيق المصاحب للجهاز على نظام التشغيل Wear OS 3. الأجهزة.

ملاحظة: تتوفّر إعدادات الضبط في التطبيق المصاحب للجهاز على الأجهزة التي تستهدف المستوى 30 أو أعلى لواجهة برمجة التطبيقات. تتوفّر الإعدادات في التطبيقات المحمولة باليد على جميع الأجهزة.

استخدام جلسة المحرّر

ننصحك بشدة بدعم عملية الإعداد على الساعة الذكية يمكن للمستخدم تخصيص خلفية شاشة الساعة بدون الحاجة إلى جهاز مصاحب.

لإتاحة ذلك، يمكن لخلفية شاشة الساعة توفير الإعدادات Activity والسماح يغيِّر المستخدِم الإعدادات باستخدام EditorSession تم إرجاعه من EditorSession.createOnWatchEditorSession وعندما يقوم المستخدم بإجراء تغييرات، فإن الاتصال EditorSession.renderWatchFaceToBitmap يتيح معاينة مباشرة لخلفية شاشة الساعة في المحرِّر Activity.

تحديد هدف لأنشطة الضبط

إذا كانت خلفية شاشة الساعة تتضمّن أنشطة ضبط وكنت بصدد إعداد خلفية شاشة الساعة من التطبيق المصاحب للجهاز، عليك إضافة إدخالات البيانات الوصفية التالية إلى بيان الخدمة في ملف البيان للتطبيق القابل للارتداء:

<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>

تسجِّل أنشطة الإعداد فلاتر الأهداف لهذا الغرض، وينشّط النظام هذه. النية بالشراء عندما يريد المستخدمون ضبط خلفية شاشة الساعة.

إذا كانت خلفية شاشة الساعة تتضمن رفيقًا فقط أو نشاط ضبط للجهاز القابل للارتداء، يمكنك فقط إلى تضمين إدخال البيانات الوصفية المقابل من المثال السابق.

إنشاء نشاط إعداد الجهاز القابل للارتداء

توفّر أنشطة الإعداد للأجهزة القابلة للارتداء مجموعة محدودة من خيارات التخصيص خلفية شاشة الساعة بسبب صعوبة التنقل في القوائم المعقدة على الشاشات الأصغر. في الجهاز القابل للارتداء نشاط الضبط، وتوفير خيارات ثنائية وبعض الاختيارات فقط لتخصيصها الجوانب الرئيسية لخلفية شاشة الساعة.

لإنشاء نشاط إعداد للأجهزة القابلة للارتداء، أضِف نشاطًا جديدًا إلى وحدة تطبيق الأجهزة القابلة للارتداء. مع تضمين فلتر الأهداف التالي في ملف البيان للتطبيق القابل للارتداء:

<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>

يجب أن يكون اسم الإجراء في فلتر الأهداف هذا androidx.wear.watchface.editor.action.WATCH_FACE_EDITOR

في نشاط الضبط، أنشِئ واجهة مستخدم بسيطة توفِّر اختيارات للمستخدمين تخصيص خلفية شاشة الساعة.

إنشاء نشاط إعداد مصاحب

تمنح أنشطة الضبط المصاحب المستخدمين إذن الوصول إلى المجموعة الكاملة من خيارات الإعداد. في خلفية شاشة الساعة، لأنه من الأسهل التفاعل مع القوائم المعقدة على الشاشة الأكبر جهاز محمول باليد. على سبيل المثال، يمكّنك نشاط التهيئة على جهاز محمول باليد من تزويد المستخدمين بمنتقي ألوان متقن لاختيار لون خلفية خلفية شاشة الساعة.

ملاحظة: لا يمكن كتابة أنشطة الإعداد إلا على الأجهزة المحمولة باليد. أجهزة Android، مثل الهواتف والأجهزة اللوحية والأجهزة القابلة للطي.

لإنشاء نشاط إعداد مصاحب، أضِف نشاطًا جديدًا إلى وحدة التطبيق المحمول. اذكر فلتر الأهداف التالي في ملف البيان للتطبيق المحمول باليد:

<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>

في نشاط التهيئة، صمم واجهة مستخدم توفر خيارات لتخصيص جميع والعناصر القابلة للتهيئة لخلفية شاشة الساعة. بعد أن يحدّد المستخدمون المحتوى، استخدِم Wearable Data Layer API لتنفيذ ما يلي: إبلاغ تغيير التهيئة بنشاط خلفية شاشة الساعة.

يمكنك الاطّلاع على المراجع التالية ذات الصلة: