توفير أنشطة الضبط على نظام التشغيل 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 لعرض تغيير الإعدادات في نشاط خلفية شاشة الساعة.

ارجع إلى الموارد التالية ذات الصلة: