مرحبًا بك في "مركز مطوّري برامج Google Home"، وجهتك الجديدة لتعلّم كيفية تطوير إجراءات منزلية ذكية. ملاحظة: ستواصل إنشاء الإجراءات في وحدة تحكم الإجراءات.
تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

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

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

أخطاء الجهاز

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