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

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

أخطاء الجهاز

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