สคีมาลักษณะการทำงาน AppSelector ของ Smart Home

action.devices.traits.AppSelector - ลักษณะการทำงานนี้ใช้กับอุปกรณ์ที่สามารถสลับระหว่างแอปพลิเคชันได้

แอตทริบิวต์ของอุปกรณ์

อุปกรณ์ที่มีลักษณะการทำงานนี้อาจรายงานแอตทริบิวต์ต่อไปนี้ เป็นส่วนหนึ่งของการดำเนินการ SYNC ดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการ Intent SYNC ได้ที่ การตอบสนอง Intent

Attributes	ประเภท	คำอธิบาย
availableApplications	Array	ต้องระบุ รายการแอปพลิเคชัน แอปพลิเคชันแต่ละรายการมีคำเหมือนอย่างน้อย 1 คำในแต่ละภาษาที่รองรับ ระบบจะใช้คำเหมือนคำแรกในการตอบกลับ
[item, ...]	Object	แอปพลิเคชันที่ผู้ใช้อุปกรณ์นี้โต้ตอบได้
key	String	ต้องระบุ คีย์ที่ไม่ซ้ำกันสำหรับแอปพลิเคชันซึ่งจะไม่แสดงต่อผู้ใช้ในคำพูดหรือการตอบกลับ
names	Array	ต้องระบุ ชื่อของแอปพลิเคชันแต่ละรายการและคำเหมือนเฉพาะภาษา
[item, ...]	Object	คำเหมือนของแอปพลิเคชัน
name_synonym	Array	ต้องระบุ คำเหมือนที่เรียกง่ายสำหรับชื่อแอปพลิเคชันในภาษาที่กำหนด ระบบจะใช้คำเหมือนคำแรกในการตอบกลับ
[item, ...]	String	ชื่อแอปพลิเคชัน
lang	String	ต้องระบุ รหัสภาษา

ตัวอย่าง

อุปกรณ์ที่มีแอป YouTube

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

สถานะของอุปกรณ์

เอนทิตีที่มีลักษณะการทำงานนี้อาจรายงานสถานะต่อไปนี้ เป็นส่วนหนึ่งของการดำเนินการ QUERY ดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการ Intent QUERY ได้ที่ การตอบสนอง Intent

สถานะ	ประเภท	คำอธิบาย
currentApplication	String	ต้องระบุ ค่าคีย์ของแอปพลิเคชันปัจจุบันที่ใช้งานอยู่เบื้องหน้า

ตัวอย่าง

อุปกรณ์ที่มีแอป YouTube ใช้งานอยู่เบื้องหน้า

{
  "currentApplication": "YouTube"
}

คำสั่งของอุปกรณ์

อุปกรณ์ที่มีลักษณะการทำงานนี้อาจตอบสนองต่อคำสั่งต่อไปนี้เป็นส่วนหนึ่งของการดำเนินการ EXECUTE ดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการ Intent EXECUTE ได้ที่ การตอบสนอง Intent

action.devices.commands.appInstall

ติดตั้งแอปพลิเคชันที่ระบุ

พารามิเตอร์

พารามิเตอร์	ประเภท	คำอธิบาย
newApplication	String	คีย์ของแอปพลิเคชันที่จะติดตั้ง
newApplicationName	String	ชื่อของแอปพลิเคชันที่จะติดตั้ง

ตัวอย่าง

ติดตั้งแอป YouTube ด้วยคีย์

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

ติดตั้งแอป YouTube ด้วยชื่อ

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

action.devices.commands.appSearch

ค้นหาแอปพลิเคชันที่ระบุ

พารามิเตอร์

พารามิเตอร์	ประเภท	คำอธิบาย
newApplication	String	คีย์ของแอปพลิเคชันที่จะค้นหา
newApplicationName	String	ชื่อของแอปพลิเคชันที่จะค้นหา

ตัวอย่าง

ค้นหาแอป YouTube ด้วยคีย์

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

ค้นหาแอป YouTube ด้วยชื่อ

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

action.devices.commands.appSelect

เลือกแอปพลิเคชันที่ระบุ

พารามิเตอร์

พารามิเตอร์	ประเภท	คำอธิบาย
newApplication	String	คีย์ของแอปพลิเคชันที่จะเลือก
newApplicationName	String	ชื่อของแอปพลิเคชันที่จะเลือก

ตัวอย่าง

เลือกแอป YouTube ด้วยคีย์

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

เลือกแอป YouTube ด้วยชื่อ

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

ตัวอย่างคำพูด

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

ข้อผิดพลาดของอุปกรณ์

ดูรายการข้อผิดพลาดและข้อยกเว้นทั้งหมด

• noAvailableApp: แอปพลิเคชันไม่มีอยู่หรือใช้งานไม่ได้
• appLaunchFailed: แอปพลิเคชันเปิดไม่สำเร็จ
• alreadyInstalledApp: แอปพลิเคชันได้รับการติดตั้งไว้แล้ว