Lược đồ đặc điểm Smart Home AppSelector

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

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 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 trên 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 được tiết lộ cho người dùng trong lời nói hoặc câu trả lờ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 của ứ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 theo 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 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 tại đang hoạt động ở nền trước.

Ví dụ

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

{
  "currentApplication": "YouTube"
}

LỆNH trên 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.appInstall

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

Thông số

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

Khoá của ứng dụng cần cài đặt.
newApplicationName String

Tên của ứng dụng cần cài đặt.

Ví dụ

Cài đặt ứng dụng YouTube bằng 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 kiếm ứng dụng đã cho.

Thông số

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

Khoá của ứng dụng cần tìm.
newApplicationName String

Tên của ứng dụng cần tìm.

Ví dụ

Tìm ứng dụng YouTube bằng 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.

Thông số

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

Khoá của ứng dụng cần chọn.
newApplicationName String

Tên của ứng dụng cần chọn.

Ví dụ

Chọn ứng dụng YouTube bằng 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 nói 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 đủ các lỗi và trường hợp ngoại lệ.
  • noAvailableApp: Ứng dụng không tồn tại hoặc không dùng được.
  • appLaunchFailed: Không chạy được ứng dụng.
  • alreadyInstalledApp: Ứng dụng đã được cài đặt.