Giản đồ đặc điểm AppSelector của nhà thông minh

action.devices.traits.AppSelector – Đặc điểm này được dùng cho các thiết bị có thể chuyển đổi giữa các ứng dụng.

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 thực hiện 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ả
availableApplications	Mảng	Bắt buộc. Danh sách ứng dụng. Mỗi ứng dụng có một hoặc nhiều từ đồng nghĩa trong mỗi ngôn ngữ được hỗ trợ. Từ đồng nghĩa đầu tiên được dùng trong câu trả lời.
[item, ...]	Đối tượng	Ứng dụng mà người dùng thiết bị này có thể tương tác.
key	String	Bắt buộc. Khoá duy nhất cho ứng dụng không hiển thị cho người dùng bằng lời nói hoặc phản hồi.
names	Mảng	Bắt buộc. Tên của từng ứng dụng và các từ đồng nghĩa theo ngôn ngữ cụ thể.
[item, ...]	Đối tượng	Từ đồng nghĩa cho ứng dụng.
name_synonym	Mảng	Bắt buộc. Từ đồng nghĩa thân thiện với người dùng cho tên ứng dụng của một ngôn ngữ nhất định. Từ đồng nghĩa đầu tiên được dùng trong câu trả lời.
[item, ...]	String	Tên ứng dụng.
lang	String	Bắt buộc. Mã ngôn ngữ.

Ví dụ

Thiết bị có ứng dụng YouTube

{
  "availableApplications": [
    {
      "key": "youtube",
      "names": [
        {
          "name_synonym": [
            "YouTube",
            "YouTube US"
          ],
          "lang": "en"
        },
        {
          "name_synonym": [
            "YouTube",
            "YouTube DE"
          ],
          "lang": "de"
        }
      ]
    }
  ]
}

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ả
currentApplication	String	Bắt buộc. Giá trị khoá của ứng dụng hiện đang hoạt động ở nền trước.

Ví dụ

Thiết bị có ứng dụng YouTube đang hoạt động ở chế độ nền trước.

{
  "currentApplication": "YouTube"
}

LỆNH 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 quá trình hoạt động 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.appInstall

Cài đặt ứng dụng đã cho.

Tham số

Tham số	Loại	Mô tả
newApplication	String	Khoá của ứng dụng cần cài đặt.
newApplicationName	String	Tên ứng dụng cần cài đặt.

Ví dụ

Cài đặt ứng dụng YouTube theo khoá

{
  "command": "action.devices.commands.appInstall",
  "params": {
    "newApplication": "YouTube"
  }
}

Cài đặt ứng dụng YouTube theo tên

{
  "command": "action.devices.commands.appInstall",
  "params": {
    "newApplicationName": "YouTube US"
  }
}

action.devices.commands.appSearch

Tìm ứng dụng đã cho.

Tham số

Tham số	Loại	Mô tả
newApplication	String	Khoá của ứng dụng cần tìm.
newApplicationName	String	Tên ứng dụng cần tìm.

Ví dụ

Tìm kiếm ứng dụng YouTube theo khoá

{
  "command": "action.devices.commands.appSearch",
  "params": {
    "newApplication": "YouTube"
  }
}

Tìm ứng dụng YouTube theo tên

{
  "command": "action.devices.commands.appSearch",
  "params": {
    "newApplicationName": "YouTube US"
  }
}

action.devices.commands.appSelect

Chọn ứng dụng đã cho.

Tham số

Tham số	Loại	Mô tả
newApplication	String	Khoá của ứng dụng cần chọn.
newApplicationName	String	Tên ứng dụng cần chọn.

Ví dụ

Chọn ứng dụng YouTube theo khoá

{
  "command": "action.devices.commands.appSelect",
  "params": {
    "newApplication": "YouTube"
  }
}

Chọn ứng dụng YouTube theo tên

{
  "command": "action.devices.commands.appSelect",
  "params": {
    "newApplicationName": "YouTube US"
  }
}

Câu lệnh mẫu

de-DE

• Öffne Netflix auf dem Fernseher .

en-US

• begin using YouTube app on the smart TV

es-ES

• pon netflix en la tele del salón

fr-FR

• Mets Netflix sur la télé .

hi-IN

• टीवी पर नेटफ्लिक्स ऍप लॉन्च करो

it-IT

• Apri Netflix sulla televisione della mia camera .

ja-JP

• YouTube のアプリを テレビ でスタート

ko-KR

• TV 에서 유튜브 앱 열어 줘

nl-NL

• Start Netflix op mijn TV .

pt-BR

• Abra o Netflix na TV para mim.
• Abre o Youtube na televisão .

sv-SE

• Öppna Youtube på TV:n

LỖI thiết bị

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

• noAvailableApp: Ứng dụng không tồn tại hoặc không có sẵn.
• appLaunchFailed: Không chạy được ứng dụng.
• alreadyInstalledApp: Ứng dụng đã được cài đặt.