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ư Toggles và Modes, 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: 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: Đú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.
{ "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.
{ "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ợ.