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

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

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

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