مخطّط سمة القناة الرئيسية الذكية

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

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

الجهاز ATTRIBUTES

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

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

أمثلة

الجهاز يدعم قناتين.

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

حالة الجهاز STATES

بلا عري

مفاتيح COMMAND

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

action.devices.commands.selectChannel

تعيين القناة الحالية إلى قيمة محددة.

المَعلمات

تحتوي الحمولة على واحد مما يلي:

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

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

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

المَعلمات	النوع	الوصف
channelNumber	سلسلة	مطلوبة. معرّف رقمي للقناة المطلوبة.

أمثلة

تغيير إلى 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

اضبط القناة الحالية بمقدار نسبي.

المَعلمات

المَعلمات	النوع	الوصف
relativeChannelChange	عدد صحيح	مطلوبة. عدد القنوات المراد زيادتها أو إنقاصها.

أمثلة

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

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

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

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

الأخطاء ذات الصلة

حدث خطأ أثناء ضبط قناة الجهاز.

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

channelSwitchFailed

action.devices.commands.returnChannel

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

المَعلمات

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

أمثلة

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

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

الأخطاء ذات الصلة

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

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

channelSwitchFailed

أخطاء الجهاز

يمكنك الاطلاع على القائمة الكاملة للأخطاء والاستثناءات.