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

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

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

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