أفضل الممارسات المتعلّقة بدوّلة Awareness API
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
إشعار بشأن إيقاف واجهة برمجة التطبيقات نهائيًا: تم إيقاف Awareness API نهائيًا.
تمنحك Awareness API إمكانية الاستجابة للتغييرات في سياق المستخدم، ولكن هذه الإمكانية الكبيرة تفرض مسؤولية كبيرة. لتقديم أفضل تجربة ممكنة للمستخدمين، يُرجى مراعاة الإرشادات التالية.
مراعاة توقّعات المستخدمين
يجب أن يفهم المستخدم ما يمكن توقّعه من تطبيقك. على سبيل المثال، لنفترض أنّ تطبيقك مصمّم لتشغيل الموسيقى فورًا عندما يوصل المستخدم سماعات الرأس. قد يؤدي ذلك إلى تجربة سيئة إذا لم يكن المستخدم يتوقّع هذا السلوك.
الاعتدال في إرسال الإشعارات
إذا كان تطبيقك يرسل إشعارات، عليك إبلاغ المستخدم بذلك بوضوح.
يجب إرسال الإشعارات ذات الصلة بالمستخدم فقط. يُرجى العِلم أنّ تطبيقك يجب أن يتعايش مع العديد من التطبيقات الأخرى التي قد ترسل إشعارات أيضًا.
الحفاظ على سلامة النظام
على الرغم من بذل جهد كبير لجعل Awareness API فعّالة، لا يزال من المحتمل أن تستهلك كميات كبيرة من عمر البطارية إذا تم استخدامها بإهمال. تتولى Awareness API إدارة سلامة النظام نيابةً عنك. ومع ذلك، إذا سجّلت عددًا كبيرًا جدًا من الحدود الجغرافية، ستعمل Awareness API على تنظيم عمليات معاودة الاتصال لمنع استنزاف البطارية بشكل غير ضروري. وبالمثل، يمكن أن تؤدي طلبات اللقطات المفرطة أيضًا إلى استنزاف عمر البطارية.
استخدام Awareness API لزيادة الوعي
إذا كان تطبيقك بحاجة إلى تنفيذ مهام غير حساسة للوقت، مثل مزامنة البيانات أو عمليات التنظيف، ننصحك باستخدام JobScheduler API لتنفيذ هذه المهام.
تاريخ التعديل الأخير: 2026-05-22 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2026-05-22 (حسب التوقيت العالمي المتفَّق عليه)"],[],[]]