مخطط سمة قناة المنزل الذكية

action.devices.traits.Channel: تنتمي هذه السمة إلى أجهزة متوافقة مع قنوات تلفزيونية على جهاز وسائط.

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

سمات الجهاز

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

السمات	Type	الوصف
availableChannels	مصفوفة	مطلوب: قائمة بالعناصر التي تصف قنوات الوسائط المتاحة لهذا الجهاز بالتحديد. يصف كل عنصر القناة التي يمكن للمستخدم اختيارها على هذا الجهاز.
[item, ...]	العنصر	قناة الوسائط المتاحة
key	String	مطلوب: المعرّف الفريد لهذه القناة لا تظهر للمستخدمين.
names	مصفوفة	مطلوب: قائمة الأسماء المرئية للمستخدم لهذه القناة.
[item, ...]	String	اسم القناة.
number	String	معرّف رقمي اختياري لهذه القناة
commandOnlyChannels	منطقي	(تلقائي: false) تشير إلى ما إذا كان الجهاز يتيح استخدام الاتصال الأحادي (صحيح) أو الثنائي (خطأ). اضبط هذه السمة على "صحيح" إذا تعذّر على الجهاز استجابة هدف QUERY أو حالة التقرير لهذه السمة.

أمثلة

جهاز يتوافق مع قناتين

{
  "availableChannels": [
    {
      "key": "ktvu2",
      "names": [
        "Fox",
        "KTVU"
      ],
      "number": "2"
    },
    {
      "key": "abc1",
      "names": [
        "ABC",
        "ABC East"
      ],
      "number": "4-11"
    }
  ]
}

حالات الجهاز

غير مسموح بأي رسائل

حوالات الجهاز

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

action.devices.commands.selectChannel

اضبط القناة الحالية على قيمة محدّدة.

المَعلمات

تحتوي الحمولة على أحد العناصر التالية:

اختيار القناة حسب رقم التعريف

المَعلمات	Type	الوصف
channelCode	String	مطلوب: معرّف فريد للقناة المطلوبة مع تطابق أحد availableChannels.
channelName	String	اسم المستخدم بسهولة للقناة المطلوبة.
channelNumber	String	المعرّف الرقمي للقناة المطلوبة

اختيار القناة حسب الرقم

المَعلمات	Type	الوصف
channelNumber	String	مطلوب: المعرّف الرقمي للقناة المطلوبة

أمثلة

التغيير إلى KTVU

{
  "command": "action.devices.commands.selectChannel",
  "params": {
    "channelCode": "ktvu2",
    "channelName": "KTVU"
  }
}

الانتقال إلى القناة الثالثة

{
  "command": "action.devices.commands.selectChannel",
  "params": {
    "channelNumber": "3"
  }
}

أخطاء ذات صلة

حدث خطأ أثناء اختيار قناة جديدة على الجهاز.

القيم المسموح بها:

noAvailableChannel

noChannelSubscription

channelSwitchFailed

action.devices.commands.relativeChannel

عدِّل القناة الحالية بمبلغ نسبي.

المَعلمات

المَعلمات	Type	الوصف
relativeChannelChange	عدد صحيح	مطلوب: عدد القنوات المطلوب زيادتها أو خفضها.

أمثلة

الانتقال إلى القناة التالية

{
  "command": "action.devices.commands.relativeChannel",
  "params": {
    "relativeChannelChange": 1
  }
}

التبديل إلى القناة السابقة

{
  "command": "action.devices.commands.relativeChannel",
  "params": {
    "relativeChannelChange": -1
  }
}

أخطاء ذات صلة

حدث خطأ أثناء تعديل قناة الجهاز.

القيم المسموح بها:

channelSwitchFailed

action.devices.commands.returnChannel

الرجوع إلى آخر قناة/قناة سابقة للمستخدم

المَعلمات

المَعلمات	Type	الوصف
ما من مواقع

أمثلة

الرجوع إلى القناة الأخيرة

{
  "command": "action.devices.commands.returnChannel",
  "params": {}
}

أخطاء ذات صلة

حدث خطأ أثناء العودة إلى القناة الأخيرة من الجهاز.

القيم المسموح بها:

channelSwitchFailed

أخطاء الجهاز

راجِع القائمة الكاملة للأخطاء والاستثناءات.