مخطط سمات قنوات المنازل المزوّدة بأجهزة ذكية

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

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

سمات الجهاز

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

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

أمثلة

جهاز يتيح استخدام قناتَين

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

حالات الجهاز

بلا عُري

أوامر الجهاز

قد تستجيب الأجهزة التي تتضمّن هذه السمة للأوامر التالية كجزء من عملية 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

أخطاء الجهاز

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