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 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 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: 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: Đú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.
{ "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.
{ "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ợ.