طرحواره ویژگی کانال خانه هوشمند

action.devices.traits.Channel - این trait متعلق به دستگاه‌هایی است که از کانال‌های تلویزیونی در یک دستگاه رسانه‌ای پشتیبانی می‌کنند.

کانال‌های موجود باید در طول همگام‌سازی (SYNC) از طریق ویژگی availableChannels به صورت یک لیست، برای هر کاربر یا دستگاه، به اشتراک گذاشته شوند. این لیست باید شامل تمام کانال‌های برتر یا محبوبی باشد که کاربر یا دستگاه در آنها مشترک است. برای اطمینان از تأخیر کم در پرس‌وجو، توصیه می‌کنیم لیست کانال‌ها را کوچک نگه دارید (تا 30 کانال یا کمتر).

ویژگی‌های دستگاه

دستگاه‌هایی که این ویژگی را دارند، ممکن است ویژگی‌های زیر را به عنوان بخشی از عملیات SYNC گزارش دهند. برای کسب اطلاعات بیشتر در مورد مدیریت اهداف SYNC ، به بخش «تحقق اهداف» مراجعه کنید.

ویژگی‌ها نوع توضیحات
availableChannels آرایه

الزامی است.

فهرست اشیایی که کانال‌های رسانه‌ای موجود برای این دستگاه خاص را توصیف می‌کنند. هر مورد، کانالی را توصیف می‌کند که کاربر می‌تواند در این دستگاه انتخاب کند.

[ item, ... ] شیء

کانال رسانه‌ای موجود.

key رشته

الزامی است.

شناسه منحصر به فرد برای این کانال. برای کاربران نمایش داده نمی‌شود.

names آرایه

الزامی است.

فهرست نام‌های قابل مشاهده توسط کاربر برای این کانال.

[ item, ... ] رشته

نام کانال.

number رشته

شناسه عددی اختیاری برای این کانال.

commandOnlyChannels بولی

(پیش‌فرض: false )

نشان می‌دهد که آیا دستگاه از ارتباط یک‌طرفه (true) یا دوطرفه (false) پشتیبانی می‌کند یا خیر. اگر دستگاه نمی‌تواند به یک درخواست پرس‌وجو (QUERY intent) یا گزارش وضعیت (Report State) برای این ویژگی پاسخ دهد، این ویژگی را روی true تنظیم کنید.

مثال‌ها

دستگاهی که از دو کانال پشتیبانی می‌کند.

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

وضعیت دستگاه

هیچ کدام.

دستورات دستگاه

دستگاه‌هایی که این ویژگی را دارند، می‌توانند به دستورات زیر به عنوان بخشی از عملیات 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

خطاهای دستگاه

لیست کامل خطاها و استثنائات را مشاهده کنید.