Giản đồ đặc điểm InputSelector cho nhà thông minh

action.devices.traits.InputSelector – Trait này dùng cho các thiết bị có khả năng chuyển đổi đầu vào.

Đầu vào nội dung nghe nhìn có thể có tên động trên mỗi thiết bị, đại diện cho nguồn cấp dữ liệu âm thanh hoặc video. Các nguồn cấp dữ liệu này có thể được kết nối mạng hoặc kết nối cứng, nhưng phải được đặt tên và duy trì một cách hợp lý. Thuộc tính này không hỗ trợ các nguồn cấp dữ liệu tạm thời tuỳ ý, chẳng hạn như thư viện mạng có thể tìm kiếm. Hỗ trợ các nguồn Bluetooth đã ghép nối, được đặt tên. Nguồn có thể có nhiều tên, vì vậy, tên do người dùng tạo và phát hiện cũng được hỗ trợ, cũng như tên mặc định; ví dụ: "hdmi_1" cũng có thể là "DVD player" (Đầu phát DVD) hoặc "usb_1" cũng có thể là "Hard drive" (Ổ đĩa cứng).

Bạn có thể sắp xếp các đầu vào nội dung nghe nhìn để hỗ trợ các lệnh "tiếp theo" và "trước đó".

Cũng như TogglesModes, tên của dữ liệu đầu vào phải được cung cấp bằng tất cả ngôn ngữ có sẵn; điều này đặc biệt phù hợp với tên mặc định.

Thuộc tính thiết bị

Các thiết bị có đặc điểm này có thể báo cáo các thuộc tính sau đây trong quá trình thao tác SYNC. Để tìm hiểu thêm về cách xử lý ý định SYNC, hãy xem phần Thực hiện ý định.

Thuộc tính Loại Mô tả
availableInputs Mảng

Bắt buộc.

Danh sách đối tượng đại diện cho nguồn cấp dữ liệu âm thanh hoặc video đầu vào. Nguồn cấp dữ liệu có thể được đấu nối cứng hoặc nối mạng. Mỗi nguồn cấp dữ liệu phải được đặt tên và duy trì một cách hợp lý. Hãy nhớ xác định từ đồng nghĩa một cách cẩn thận để tránh kích hoạt (quá mức) không mong muốn.

[item, ...] Đối tượng

Nguồn đầu vào hiện có.

key String

Bắt buộc.

Khoá duy nhất cho đầu vào. Không được để người dùng nhìn thấy khoá khi nói hoặc trả lời.

names Mảng

Bắt buộc.

Danh sách tên cho dữ liệu đầu vào cho tất cả ngôn ngữ có sẵn.

[item, ...] Đối tượng

Dữ liệu đầu vào cho một ngôn ngữ nhất định.

lang String

Bắt buộc.

Mã ngôn ngữ.

name_synonym Mảng

Bắt buộc.

Tên dễ hiểu cho dữ liệu đầu vào, bằng một ngôn ngữ nhất định. Từ đồng nghĩa đầu tiên được dùng trong câu trả lời của Trợ lý Google cho người dùng.

[item, ...] String

Nhập tên.

commandOnlyInputSelector Boolean

(Mặc định: false)

Cho biết liệu thiết bị có hỗ trợ giao tiếp một chiều (true) hay hai chiều (false) hay không. Đặt thuộc tính này thành true nếu thiết bị không thể phản hồi ý định QUERY hoặc Báo cáo trạng thái cho đặc điểm này.

orderedInputs Boolean

(Mặc định: false)

Đúng nếu danh sách đầu ra được sắp xếp. Điều này cũng cho biết rằng chức năng "tiếp theo" và "trước" có sẵn.

Ví dụ

Thiết bị có hai đầu vào theo thứ tự.

{
  "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
}

Trạng thái thiết bị

Các thực thể có đặc điểm này có thể báo cáo các trạng thái sau đây trong quá trình thực hiện thao tác QUERY. Để tìm hiểu thêm về cách xử lý ý định QUERY, hãy xem phần Thực hiện ý định.

Tiểu bang Loại Mô tả
currentInput String

Bắt buộc.

Khoá của phương thức nhập hiện đang được sử dụng.

Ví dụ

Thiết bị có đầu vào HDMI hiện đang được chọn.

{
  "currentInput": "hdmi_1"
}

lệnh của thiết bị

Các thiết bị có đặc điểm này có thể phản hồi các lệnh sau đây trong thao tác EXECUTE. Để tìm hiểu thêm về cách xử lý ý định EXECUTE, hãy xem phần Thực hiện ý định.

action.devices.commands.SetInput

Đặt phương tiện đầu vào.

Thông số

Thông số Loại Mô tả
newInput String

Bắt buộc.

Khoá của dữ liệu đầu vào mới.

Ví dụ

Chọn đầu vào USB

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

action.devices.commands.NextInput

Chọn phương thức nhập tiếp theo. Chỉ áp dụng khi thuộc tính orderedInputs được đặt thành true.

Lệnh này yêu cầu các thuộc tính sau:
{
  "orderedInputs": true
}

Thông số

Thông số Loại Mô tả

Không có thuộc tính nào

Ví dụ

Không có tham số

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

action.devices.commands.PreviousInput

Chọn dữ liệu đầu vào trước đó. Chỉ áp dụng khi thuộc tính orderedInputs được đặt thành true.

Lệnh này yêu cầu các thuộc tính sau:
{
  "orderedInputs": true
}

Thông số

Thông số Loại Mô tả

Không có thuộc tính nào

Ví dụ

Không có tham số

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

Câu lệnh mẫu

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

LỖI thiết bị

Xem danh sách đầy đủ lỗi và ngoại lệ.

unsupportedInput: Dữ liệu đầu vào hiện không được hỗ trợ.