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

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

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

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

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

صفات تایپ کنید توضیحات
availableChannels آرایه

مورد نیاز.

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

[ item, ... ] شیء

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

key رشته

مورد نیاز.

شناسه منحصر به فرد برای این کانال. در معرض دید کاربران قرار نمی گیرد.

names آرایه

مورد نیاز.

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

[ item, ... ] رشته

نام کانال

number رشته

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

commandOnlyChannels بولی

(پیش‌فرض: false )

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

نمونه ها

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

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

وضعیت دستگاه

هیچ کدام

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

دستگاه های دارای این ویژگی ممکن است به دستورات زیر به عنوان بخشی از عملیات EXECUTE پاسخ دهند. برای کسب اطلاعات بیشتر در مورد مدیریت EXECUTE intent ها، به اجرای Intent مراجعه کنید.

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

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

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