تفويض الحساب على Android

قبل المتابعة في تفويض الحساب، تأكَّد من توفّر ما يلي:

  1. تثبيت Google Home app (GHA) على جهاز Android الجوّال
  2. يجب توفُّر نوع واحد على الأقل من أنواع الأجهزة المتوافقة مع نموذج التطبيق في المنزل:
    • إضاءة درجة حرارة الألوان (تشغيل وإيقاف، سطوع)
    • أداة استشعار الاتصال (حالة منطقية)
    • مصباح قابل للتعتيم (تشغيل وإيقاف، سطوع)
    • قفل الباب
    • مصباح ملوّن متقدّم (تشغيل وإيقاف، سطوع)
    • مفتاح تحكّم عام
    • جهاز توجيه الحدود من Google
    • كاميرا Google
    • جرس الباب من Google
    • جهاز استشعار التواجد (استشعار التواجد)
    • مصباح يمكن تشغيله وإطفاؤه (تشغيل وإطفاء، سطوع)
    • مفتاح تشغيل/إيقاف الإضاءة
    • وحدة المكوّن الإضافي للتشغيل/الإيقاف (تشغيل وإيقاف)
    • أداة استشعار التشغيل/الإيقاف
  3. جهازان لاختبار نموذج التشغيل الآلي

قبل استخدام الأجهزة من خلال واجهات برمجة تطبيقات Home، يجب أن تكون قابلة للتحكّم من خلال GHA.

تشغيل نموذج تطبيق Android

قبل منح الإذن لحساب، تأكَّد من ضبط تطبيق Sample App باستخدام نطاق OAuth المناسب لمشروعك. يستخدم الرمز المصدر لنموذج التطبيق تلقائيًا النطاق https://www.googleapis.com/auth/home.platform.v2. تتطلّب العديد من الميزات في "التطبيق التجريبي" الحصول على إذن من الشريك للوصول إليها، وهي محصورة بنطاق home.platform.v2. للسماح باستخدام نموذج التطبيق مع نطاق https://www.googleapis.com/auth/home.platform.selected.devices العادي، يجب تبديل homePlatformScope يدويًا إلى HOME_PLATFORM_SCOPE_VERSION_1 في HomeModule.kt كما هو موضّح في إنشاء التطبيق.

شغِّل نموذج تطبيق Android. عند تشغيله لأول مرة، سيُطلب منك السماح بالوصول إلى منزل في حساب Google الخاص بك. يمنح هذا الإجراء "نموذج التطبيق" الإذن بالوصول إلى البُنى والأجهزة في ذلك المنزل والتحكّم فيها.

إذا لم يكن لديك منزل، يمكن للمستخدم إنشاء منزل أثناء عملية منح الأذونات بدون الحاجة إلى استخدام GHA.

سيختلف السلوك التلقائي لأذونات التطبيق حسب ما إذا كان التطبيق مسجَّلاً على Google Home Developer Console أم لا.

إذا لم يكن التطبيق مسجَّلاً في Developer Console، ستكون حالته غير متحقق منه. يُنصح باستخدام ما يلي لاختبار استخدام واجهات برمجة التطبيقات الخاصة بمنصة Home:

  • يمكن فقط للمستخدمين المسجَّلين كمستخدمين تجريبيين في وحدة تحكّم OAuth منح أذونات للتطبيق. ويبلغ الحد الأقصى لعدد المستخدمين التجريبيين 100 مستخدم للتطبيق غير المتحقَّق منه.

  • سيتمكّن التطبيق الذي لم يتم التحقّق منه من الوصول إلى الأجهزة من أي نوع متوافق مع OAuth لواجهات Home API (قائمة أنواع الأجهزة في Developer Console). سيتم منح الإذن بالوصول إلى جميع الأجهزة في المنزل.

إذا كان التطبيق مسجَّلاً في Developer Console وتمت الموافقة على وصوله إلى نوع واحد أو أكثر من الأجهزة، وتم إكمال عملية التحقّق من العلامة التجارية لبروتوكول OAuth، سيكون في حالة تم التحقّق منه. هذه الحالة مطلوبة لإطلاق تطبيق في قناة الإصدار العلني:

  • لن يتم تطبيق حدود المستخدمين الاختباريين بعد الآن. يمكن لأي مستخدم منح الإذن للتطبيق.
  • يمكن للمستخدم منح الإذن لأنواع الأجهزة التي تمت الموافقة عليها في Developer Console فقط.

انقر على السماح بالوصول إلى منزل محدّد:

  • إذا كانت هناك أي منازل مرتبطة بحسابك، اختَر منزلاً لمنحه الإذن. إذا لم يتم العثور على أي أجهزة في المنزل المحدّد، يمكنك إجراء أحد الإجراءَين التاليَين:
    1. انقر على السماح بالوصول إلى منزل آخر لاختيار منزل مختلف.
    2. يمكنك إعداد جهاز من اختيارك في ذلك المنزل باستخدام Google Home app (GHA). يُرجى العِلم أنّ أنواع الأجهزة التالية فقط تتوافق مع عناصر التحكّم في هذا التطبيق النموذجي:
      • إضاءة درجة حرارة الألوان (تشغيل وإيقاف، سطوع)
      • أداة استشعار الاتصال (حالة منطقية)
      • مصباح قابل للتعتيم (تشغيل وإيقاف، سطوع)
      • قفل الباب
      • مصباح ملوّن متقدّم (تشغيل وإيقاف، سطوع)
      • مفتاح تحكّم عام
      • جهاز توجيه الحدود من Google
      • كاميرا Google
      • جرس الباب من Google
      • جهاز استشعار التواجد (استشعار التواجد)
      • مصباح يمكن تشغيله وإطفاؤه (تشغيل وإطفاء، سطوع)
      • مفتاح تشغيل/إيقاف الإضاءة
      • وحدة المكوّن الإضافي للتشغيل/الإيقاف (تشغيل وإيقاف)
      • أداة استشعار التشغيل/الإيقاف
  • إذا لم تكن هناك منازل مرتبطة بحسابك، ستظهر لك شاشة تتضمّن رسالة ما مِن مبانٍ للحساب المحدّد.
    1. مرِّر سريعًا للرجوع إلى طريقة العرض الرئيسية في "تطبيق العيّنة".
    2. لإعداد منزل، استخدِم GHA. بعد ذلك، حاوِل منح الإذن لتطبيق Sample App مرة أخرى.

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

اختيار بنية لتشغيل نموذج التطبيق فيها
الشكل 1: اختيار منزل
البنية المحدّدة، التي تعرض الأجهزة المتاحة
الشكل 2: المنزل والأجهزة
التحكّم في إعدادات الجهاز
الشكل 3: عناصر التحكّم في الجهاز
البنية المحدَّدة التي تعرض عمليات التشغيل الآلي المتاحة
الشكل 4: المنزل وعمليات التشغيل الآلي

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