Giản đồ Trait InputSelector cho nhà thông minh

action.devices.traits.InputSelector – Trait này dùng cho các thiết bị có thể 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. Những nguồn cấp dữ liệu này có thể đi dây hoặc nối mạng, nhưng bạn cần đặt tên và đảm bảo tính ổn định một cách hợp lý. Trait này không hỗ trợ nguồn cấp dữ liệu tạm thời tuỳ ý, chẳng hạn như một thư viện nối mạng có thể tìm kiếm được. Các nguồn Bluetooth được đặt tên và ghép nối được hỗ trợ. 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 sẽ được hỗ trợ, cũng như tên mặc định. Ví dụ: "hdmi_1" cũng có thể là "Đầu đĩa DVD", hoặc "usb_1" cũng có thể là "Ổ cứng".

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

Tương tự như với 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 của 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 SYNC. Để tìm hiểu thêm về cách xử lý ý định SYNC, vui lòng xem phần Thực hiện ý định.

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

Bắt buộc.

Danh sách các đố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 kết nối cứng hoặc nối mạng. Bạn phải đặt tên cho từng nguồn cấp dữ liệu và đảm bảo tính nhất quán một cách hợp lý. Hãy nhớ xác định từ đồng nghĩa của bạn một cách cẩn thận để ngăn chặn kích hoạt không mong muốn (quá mức).

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

Phương thức nhập có sẵn.

key Chuỗi

Bắt buộc.

Khoá duy nhất cho giá trị nhập. Không được để người dùng thấy khoá trong lời nói hoặc phản hồi.

names Mảng

Bắt buộc.

Danh sách tên của dữ liệu nhập 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ữ có sẵn.

lang Chuỗi

Bắt buộc.

Mã ngôn ngữ.

name_synonym Mảng

Bắt buộc.

Tên thân thiện với người dùng cho dữ liệu nhập, bằng một ngôn ngữ cụ thể. Từ đồng nghĩa đầu tiên được dùng trong phản hồi của Trợ lý Google với người dùng.

[item, ...] Chuỗi

Tên mục nhập.

commandOnlyInputSelector Boolean

(Mặc định: false)

Cho biết thiết bị có hỗ trợ giao tiếp một chiều (true) hay hai chiều (false). Đặ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 Trạng thái báo cáo cho trait 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" hiện đang hoạt động.

Ví dụ

Thiết bị có 2 dữ liệu đầ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 của 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 trong thao tác QUERY. Để tìm hiểu thêm về cách xử lý ý định QUERY, vui lòng xem phần Thực hiện ý định.

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

Bắt buộc.

Khoá của đầu vào hiện đang được sử dụng.

Ví dụ

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

{
  "currentInput": "hdmi_1"
}

Lệnh trên thiết bị

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

action.devices.commands.SetInput

Đặt đầu vào nội dung nghe nhìn.

Thông số

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

Bắt buộc.

Phím của phương thức nhập 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 Nội dung 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 Nội dung 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ách phát âm 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

Thiết bị ERRORS

Xem danh sách đầy đủ lỗi và trường hợp ngoại lệ.

unsupportedInput: Đầu vào hiện chưa được hỗ trợ.