إرسال خلفية شاشة الساعة

يقدّم نظام التشغيل Wear OS 6 واجهة برمجة تطبيقات جديدة، وهي Watch Face Push، التي توفّر فرصًا لتطبيق حالات استخدام أكثر تقدمًا لنشر خلفيات شاشة الساعة.

تحديد حالات استخدام ميزة "عرض خلفية شاشة الساعة"

‫Watch Face Push هي واجهة برمجة تطبيقات على نظام التشغيل Wear OS تسمح للمطوّر بإضافة خلفيات شاشة الساعة أو تعديلها أو إزالتها مباشرةً. ولا يلزم استخدامها لتطوير خلفية شاشة ساعة عادية.

يجب كتابة خلفيات شاشة الساعة المستخدَمة مع ميزة "عرض خلفية شاشة الساعة" باستخدام تنسيق خلفية شاشة الساعة. ويمكن أن يشمل ذلك خلفيات شاشة الساعة المصمّمة باستخدام Watch Face Studio أو أي أداة أخرى تُنشئ خلفيات شاشة ساعة تستخدم "تنسيق خلفية شاشة الساعة".

على الرغم من أنّه يمكن استخدام Watch Face Push API بعدة طرق، يجب استخدام الجدول التالي كدليل لحالات الاستخدام الرئيسية:

سرد قصة الحل المقترح التعقيد
أريد إنشاء خلفيات شاشة ساعات فردية ونشرها. استخدام تنسيق خلفية شاشة الساعة، إما مباشرةً أو من خلال أداة مثل Watch Face Studio، ونشرها على Google Play ضعيفة
أريد إنشاء تطبيق هاتف يتيح للمستخدمين اختيار خلفيات شاشة الساعة من مجموعة منتقاة، أو تصميم خلفيات شاشة الساعة وتخصيصها لتثبيتها مباشرةً على ساعة Wear OS. أنشئ تطبيقًا لكل من الساعة والهاتف باستخدام Watch Face Push API على الساعة. عالية

الغرض

إنّ حالة الاستخدام الأساسية لواجهة برمجة التطبيقات Watch Face Push API هي إنشاء تطبيق سوق. ومن هذا التطبيق، يمكن للمستخدمين اختيار خلفيات شاشة الساعة من مجموعة منظَّمة على هواتفهم، والتحكّم مباشرةً في تثبيت هذه خلفيات شاشة الساعة على ساعتهم المتصلة.

الاعتبارات

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

عند إنشاء خلفية شاشة الساعة، يُرجى مراعاة النقاط التالية:

أسماء الحِزم

يجب أن تكون خلفيات شاشة الساعة التي يتم تثبيتها باستخدام Watch Face Push متوافقة مع الخطوات التالية:

<app name>.watchfacepush.<watchface name>

حيث يكون <app name> هو اسم حزمة التطبيق الذي يستدعي Watch Face Push API.

على سبيل المثال، بالنسبة إلى تطبيق يحمل اسم الحزمة com.example.mymarketplace، يليه أسماء حِزم صالحة لخلفيات شاشة الساعة:

  • com.example.mymarketplace.watchfacepush.watchface1
  • com.example.mymarketplace.watchfacepush.watchface2
  • com.example.mymarketplace.watchfacepush.another_watchface

ترفض واجهة برمجة التطبيقات خلفيات شاشات الساعة التي لا تتوافق مع هذا الاصطلاح.

محتوى الحزمة

يتم فرض محتوى حزمة APK بشكل صارم. يجب توخّي الحذر للتأكّد من أنّ تنسيق خلفية شاشة الساعة متوافق مع القيود التالية: من الناحية الفنية، يمكن إنشاء حِزم APK بتنسيق خلفية شاشة الساعة تحتوي على ملفات بيانات وصفية غير ضارة وعناصر أخرى، وقد تكون مقبولة على Google Play ولكنها لا تجتاز عملية التحقّق من إرسال خلفية شاشة الساعة (راجِع المعلومات أدناه).

لا يُسمح إلا بالملفات/المسارات التالية في كل ملف APK لخلفية شاشة الساعة:

  • /AndroidManifest.xml
  • /resources.arsc
  • /res/**
  • /META-INF/**

بالإضافة إلى ذلك، يُسمح فقط بالعلامات التالية في ملف AndroidManifest.xml:

  • <manifest>
  • <uses-feature>
  • <uses-sdk>
  • <application>
  • <property>
  • <meta-data>

أخيرًا، يجب أن تحدّد الحزمة قيمة minSdk لا تقل عن 33، ويجب أن تحدّد العلامة <application> السمة android:hasCode="false".

التحقُّق

على عكس خلفيات شاشة الساعة العادية التي يتم توزيعها من خلال Google Play، تقع على عاتق تطبيق Marketplace مهمة التحقّق من أنّ كل خلفية شاشة ساعة جيدة التصميم وذات أداء جيد.

يستخدم Google Play عمليات التحقّق التالية للتحقّق من جودة كل خلفية شاشة ساعة تستخدم ميزة "عرض خلفية شاشة الساعة":

  1. يجب أن تجتاز جميع خلفيات شاشة الساعة التي تم تثبيتها أو تحديثها من خلال Watch Face Push API اختبار أداة التحقّق من Watch Face Push.
  2. لا يجوز استخدام سوى أداة التحقّق الرسمية لإنشاء الرموز المميّزة للتحقّق لاستخدامها مع واجهة برمجة التطبيقات.
  3. يجب أن تكون أداة التحقّق المستخدَمة محدّثة في وقت تنفيذ عملية التحقّق.

  4. ولا يلزم إعادة التحقّق من صحة حزمة APK التي لم تتغيّر. لا تنتهي صلاحية الرموز المميّزة، حتى في حال تم استبدال إصدار أداة التحقّق المستخدَمة.

    في الوقت نفسه، ننصحك بإعادة إجراء عملية التحقّق مرة واحدة في حين، لأنّ مدقّق الصحة يتم تعديله بشكل دوري.

تشغيل أداة التحقّق

لتشغيل مدقّق التطبيق على حزمة APK لخلفية شاشة الساعة، اتّبِع الخطوات التالية:

  1. يمكنك الحصول على مدقّق الصحة من مستودع Maven في Google.

  2. شغِّل الأداة على النحو التالي:

    java -jar validator-push-cli-1.0.0-alpha01.jar \
    --apk_path=youwatchface.apk \
    --package_name=<your marketplace package name>

    في حال نجاح العملية، تتضمّن النتيجة رمزًا مميّزًا للتحقّق، والذي يجب تقديمه إلى Watch Face Push API عند إضافة شاشة ساعة أو تعديلها.

    في حال حدوث خطأ، تتضمّن النتيجة تفاصيل عن الفحص الذي تعذّر إجراؤه.

    للحصول على مثال على دمج أداة سطر الأوامر الخاصة بالمدقق في عملية إنشاء Gradle، اطّلِع على نموذج دفع خلفية شاشة الساعة على GitHub.

حجم حزمة APK

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

قد يستغرق نقل حِزمة APK كبيرة جدًا وقتًا طويلاً، ما يؤدي إلى تقديم تجربة سيئة للمستخدمين وإلى استنزاف البطارية.

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

راجِع إرشادات تحسين استخدام الذاكرة للحصول على مزيد من الاقتراحات حول تقليل حجم حِزم APK إلى الحد الأدنى.

توقيع حِزم APK

ويجب توقيع جميع خلفيات شاشات الساعة، لأنّها حِزم APK عادية. أنشئ مفتاحًا مختلفًا عن المفتاح المستخدَم مع تطبيقك الرئيسي واستخدِم المفتاح المختلف لجميع خلفيات شاشات الساعة.

هندسة معمارية

وننصحك بالاطّلاع على المكونات الرئيسية الثلاثة للنظام:

  1. مساحة التخزين المستندة إلى السحابة الإلكترونية: في تطبيق Marketplace الأساسي، يتم إنشاء خلفيات شاشة الساعة وتخزينها في السحابة الإلكترونية، وتكون جاهزة للاستخدام من قِبل المستخدمين. خلفيات شاشة الساعة هي:
    1. تم إنشاؤها مسبقًا كحِزم APK عادية بتنسيق خلفية شاشة الساعة
    2. أن تحتوي كل حزمة على خلفية شاشة ساعة واحدة فقط تستند إلى تنسيق خلفية شاشة الساعة
    3. تم إثبات صحتها باستخدام عملية إثبات صحة Watch Face Push ويتم تخزينها مع رمز التفعيل المرتبط بها.
    4. تكون البيانات جاهزة لاستردادها من خلال تطبيق هاتفك عند الحاجة.
  2. تطبيق الهاتف: تطبيق الهاتف هو الطريقة الرئيسية التي يتفاعل بها المستخدمون مع نظامك. ويتيح لهم ذلك ما يلي:
    1. تصفُّح كتالوج خلفيات شاشة الساعة والبحث فيه
    2. تثبيت خلفية شاشة ساعة أو استبدالها على الساعة
  3. تطبيق الساعة: قد لا يتضمّن تطبيق الساعة عادةً واجهة مستخدم مهمة. وهي تُعدّ في الأساس رابطًا بين تطبيق الهاتف وواجهات برمجة التطبيقات لعرض التطبيقات على شاشة الساعة Push APIs، مع الوظائف التالية:
    1. استخدام Watch Face Push API لتثبيت خلفيات شاشة الساعة أو تحديثها أو استبدالها
    2. طلب الأذونات اللازمة وطلب موافقة المستخدم
    3. توفير خلفية شاشة ساعة تلقائية
    4. توفير مساحة تخزين مؤقتة صغيرة لخلفيات الشاشة
  4. التواصل بين الهاتف والساعة: إنّ التواصل بين تطبيق الهاتف والساعة هو عامل أساسي لنجاح التجربة بشكل عام. استخدِم واجهات برمجة تطبيقات "طبقة البيانات" في Wear OS، والتي تتيح ما يلي:
    1. رصد التثبيت: باستخدام Capabilities وCapabilityClient، يمكن لتطبيق الهاتف رصد عدم توفّر تطبيق الساعة والعكس صحيح. ويمكن أن يلي ذلك بدء نية الانتقال إلى "متجر Play" لتثبيت شكل الجهاز المفقود.
    2. إدارة الحالة: باستخدام DataClient أو MessageClient، يمكن مزامنة الهاتف مع حالة الساعة، على سبيل المثال، التأكّد من أنّ الهاتف على دراية بوجه الساعة الذي تم ضبطه.
    3. إرسال حِزم APK: باستخدام ChannelClient أو MessageClient، يمكن إرسال حِزم APK من الهاتف إلى الساعة
    4. الاستدعاء عن بُعد: باستخدام Messageclient، يمكن للهاتف توجيه الساعة إلى طلب بيانات من Watch Face Push API، على سبيل المثال، ل تثبيت خلفية شاشة ساعة.

يُرجى الرجوع إلى إرشادات Data Layer API للحصول على مزيد من التفاصيل.