スマートホームの InputSelector トレイトのスキーマ

action.devices.traits.InputSelector - このトレイトは、入力を切り替えられるデバイスに使用します。

メディア入力には、オーディオ フィードまたは動画フィードを表すデバイスごとに動的な名前を設定できます。これらのフィード 有線でもネットワークでもかまいませんが、名前と適度な永続性が必要です。このトレイト は、検索可能なネットワーク ライブラリなど、任意の一時的なフィードをサポートしていません。ペア設定済み、名前付き Bluetooth ソースがサポートされています。ソースには複数の名前を付けることができるため、ユーザーが作成して検出したソース デフォルト名だけでなく、デフォルトの名前もサポートされています。たとえば、「hdmi_1」は「DVD プレーヤー」、 または「usb_1」「ハードドライブ」の場合もあります

「次」をサポートするようにメディア入力を並べ替え可能および「previous」使用できます。

TogglesModes と同様に、名前は 利用可能なすべての言語で入力を提供する必要がある。これは特にデフォルト名に関係します。

デバイスの属性

このトレイトを持つデバイスは、以下をレポートすることがあります。 SYNC オペレーションの一部として使用できます。学習内容 SYNC インテントの処理の詳細については、以下をご覧ください。 インテント フルフィルメント

属性 タイプ 説明
availableInputs 配列

必須。

入力音声フィードまたは入力動画フィードを表すオブジェクトのリスト。フィードは有線でもネットワークでも接続できます。各フィードには名前を付け、適度に永続的なものにする必要があります。望ましくない(過剰な)トリガーを防ぐため、類義語は慎重に定義してください。

[item, ...] オブジェクト

利用可能な入力。

key String

必須。

入力の一意のキー。音声やレスポンスで鍵をユーザーに公開しないでください。

names 配列

必須。

使用可能なすべての言語の入力名のリスト。

[item, ...] オブジェクト

利用可能な特定の言語の入力。

lang String

必須。

言語コード。

name_synonym 配列

必須。

指定された言語での、ユーザー フレンドリーな入力名。1 つ目の類義語は、ユーザーに対する Google アシスタントの応答で使用されます。

[item, ...] String

入力名。

commandOnlyInputSelector ブール値

(デフォルト: false)。

デバイスが一方向(true)または双方向(false)の通信の使用をサポートしているかどうかを示します。デバイスがこのトレイトの QUERY インテントまたは Report State に応答できない場合は、この属性を true に設定します。

orderedInputs ブール値

(デフォルト: false)。

出力のリストが順序付けされている場合は true。また、これは「次」がおよび「previous」使用できます。

2 つの順序付き入力を持つデバイス。

{
  "availableInputs": [
    {
      "key": "hdmi_1",
      "names": [
        {
          "lang": "en",
          "name_synonym": [
            "HDMI 1",
            "1st HDMI",
            "DVD Player"
          ]
        },
        {
          "lang": "de",
          "name_synonym": [
            "HDMI 1",
            "Zuerst HDMI",
            "DVD Spieler"
          ]
        }
      ]
    },
    {
      "key": "usb_1",
      "names": [
        {
          "lang": "en",
          "name_synonym": [
            "USB 1",
            "First USB",
            "Hard Drive"
          ]
        },
        {
          "lang": "de",
          "name_synonym": [
            "USB 1",
            "Zuerst USB",
            "Festplatte"
          ]
        }
      ]
    }
  ],
  "orderedInputs": true
}

デバイスのステータス

このトレイトを持つエンティティは、以下を報告する場合があります。 複数の状態を QUERY オペレーションの一部として呼び出します。学習内容 QUERY インテントの処理の詳細については、以下をご覧ください。 インテント フルフィルメント

タイプ 説明
currentInput String

必須。

現在使用されている入力のキー。

HDMI 入力を備えたデバイスが現在選択されています。

{
  "currentInput": "hdmi_1"
}

デバイスのコマンド

このトレイトを持つデバイスは、以下の動作に反応します。 コマンドを EXECUTE オペレーションの一部として使用できます。学習内容 EXECUTE インテントの処理の詳細については、以下をご覧ください。 インテント フルフィルメント

action.devices.commands.SetInput

メディア入力を設定します。

パラメータ

パラメータ タイプ 説明
newInput String

必須。

新しい入力のキー。

USB 入力を選択する

{
  "command": "action.devices.commands.SetInput",
  "params": {
    "newInput": "usb_1"
  }
}

action.devices.commands.NextInput

次の入力を選択してください。orderedInputs 属性が true に設定されている場合にのみ適用可能です。

このコマンドには、次の属性が必要です。
{
  "orderedInputs": true
}

パラメータ

パラメータ タイプ 説明

プロパティがありません

パラメータなし

{
  "command": "action.devices.commands.NextInput",
  "params": {}
}

action.devices.commands.PreviousInput

前の入力を選択します。orderedInputs 属性が true に設定されている場合にのみ適用可能です。

このコマンドには、次の属性が必要です。
{
  "orderedInputs": true
}

パラメータ

パラメータ タイプ 説明

プロパティがありません

パラメータなし

{
  "command": "action.devices.commands.PreviousInput",
  "params": {}
}

サンプル音声

<ph type="x-smartling-placeholder">

de-DE

  • Ändere den Eingangskanal auf AUX .

en-US

  • change input mode to HDMI 1

es-ES

  • cambia a hdmi 1

fr-FR

  • Activation du mode HDMI1 .
  • Mets la télé sur HDMI 1 .

hi-IN

  • टीवी की इनपुट HDMI 1 में स्विच करो

it-IT

  • metti ingresso aux sulla tv

ja-JP

  • テレビ HDMI1 にして

ko-KR

  • TV HDMI 1 로 바꿔 줘

nl-NL

  • zet de TV op bluetooth

pt-BR

  • Muda a entrada da TV para HDMI2 .
  • mudar a entrada para AUX

sv-SE

  • Sätt på hdmi 1

デバイスエラー

詳しくは、 エラーと例外をご覧ください。

unsupportedInput: この入力は現在サポートされていません。