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

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

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

سمات الجهاز

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

السمات	النوع	الوصف
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"
    }
  ]
}

حالات الجهاز

بلا عُري

CommandS للجهاز

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

action.devices.commands.selectChannel

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

المعلمات

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

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

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

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

المعلمات	النوع	الوصف
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

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

المعلمات

المعلمات	النوع	الوصف
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

أخطاء الجهاز

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