ยินดีต้อนรับสู่ Google Home Developer Center แหล่งใหม่เรียนรู้วิธีพัฒนาการดําเนินการในบ้านอัจฉริยะ หมายเหตุ: คุณจะสร้างการดําเนินการต่างๆ ต่อไปในคอนโซลการดําเนินการ
จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ

สคีมาของฟีเจอร์ Smart Home AppSelector

action.devices.traits.AppSelector - ลักษณะเฉพาะเหล่านี้ใช้กับอุปกรณ์ที่เปลี่ยนอินพุตได้

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

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

แอตทริบิวต์ ประเภท คำอธิบาย
availableApplications อาร์เรย์

ต้องระบุ

รายการแอปพลิเคชัน แอปพลิเคชันแต่ละรายการมีคําพ้องความหมายอย่างน้อย 1 รายการในแต่ละภาษาที่รองรับ ระบบจะใช้คําพ้องความหมายคําแรกในการตอบกลับ

[item, ...] วัตถุ

แอปพลิเคชันที่ผู้ใช้อุปกรณ์นี้โต้ตอบได้

key สตริง

ต้องระบุ

คีย์ที่ไม่ซ้ํากันสําหรับแอปพลิเคชันซึ่งไม่ได้แสดงต่อผู้ใช้ในคําพูดหรือการตอบกลับ

names อาร์เรย์

ต้องระบุ

ชื่อของแต่ละแอปพลิเคชันและคําพ้องความหมายเฉพาะภาษา

[item, ...] วัตถุ

คําพ้องความหมายของแอปพลิเคชัน

name_synonym อาร์เรย์

ต้องระบุ

คําพ้องความหมายที่ใช้งานง่ายของชื่อแอปพลิเคชันสําหรับภาษาที่ระบุ ระบบจะใช้คําพ้องความหมายคําแรกในการตอบกลับ

[item, ...] สตริง

ชื่อแอปพลิเคชัน

lang สตริง

ต้องระบุ

รหัสภาษา

ตัวอย่าง

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

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

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

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

รัฐ ประเภท คำอธิบาย
currentApplication สตริง

ต้องระบุ

คีย์-ค่าของแอปพลิเคชันปัจจุบันที่ใช้งานอยู่เบื้องหน้า

ตัวอย่าง

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

{
  "currentApplication": "youtube"
}

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

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

action.devices.commands.appInstall

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

พารามิเตอร์

พารามิเตอร์ ประเภท คำอธิบาย
newApplication สตริง

คีย์ของแอปพลิเคชันที่จะติดตั้ง

newApplicationName สตริง

ชื่อของแอปพลิเคชันที่จะติดตั้ง

ตัวอย่าง

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

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

ติดตั้งแอป YouTube ตามชื่อ

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

action.devices.commands.appSearch

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

พารามิเตอร์

พารามิเตอร์ ประเภท คำอธิบาย
newApplication สตริง

คีย์ของแอปพลิเคชันในการค้นหา

newApplicationName สตริง

ชื่อของแอปพลิเคชันที่จะค้นหา

ตัวอย่าง

ค้นหาแอป YouTube ตามคีย์

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

ค้นหาแอป YouTube ตามชื่อ

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

action.devices.commands.appSelect

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

พารามิเตอร์

พารามิเตอร์ ประเภท คำอธิบาย
newApplication สตริง

คีย์ของแอปพลิเคชันเพื่อเลือก

newApplicationName สตริง

ชื่อของแอปพลิเคชันที่จะเลือก

ตัวอย่าง

เลือกแอป 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

  • เริ่มใช้ YouTube แอปใน สมาร์ททีวี

es-ES

  • pon netflix en la Tele del salón

fr-FR

  • Mets Netflix sur la télé .

อุปกรณ์ ERRORS

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