使用指令碼編輯器建立進階家用裝置自動化動作

在 Google Home 應用程式中，你可以透過日常安排在住家中執行自動化動作。如要建立進階住家日常安排，可以在指令碼編輯器中使用其他啟動條件、限制條件、動作和進階邏輯編寫自動化動作指令碼。

指令碼編輯器目前可在公開測試中使用。加入公開測試後，你就可以在 Google Home 網頁版或 Google Home 行動應用程式中使用指令碼編輯器。

瞭解如何編寫自動化動作的指令碼：

• 使用指令碼編輯器編寫自動化動作指令碼
• 「支援的啟動條件、限制條件和動作」完整清單
• 支援的裝置清單
• 根據程式碼研究室的範例，逐步建立第一個指令碼
• 其他自動化動作指令碼編寫練習和指令碼範例。

前往程式碼研究室

開始使用

你可以透過 Google Home 網頁版或 Google Home 應用程式的指令碼編輯器編寫和編輯住家日常安排。

如要建立自動化動作指令碼，你必須瞭解：

• YAML 的基本概念。你可以使用這種人類可讀的指令碼語言逐行輸入指示，建立家用裝置自動化動作。
• 日常安排的運作方式，包括啟動條件和動作等術語。
• 如何使用指令碼編輯器編寫自動化動作指令碼。

想進一步瞭解如何編寫指令碼，請參閱使用指令碼編輯器編寫自動化動作指令碼。

注意：使用 iPhone 或 iPad 時，你可以在 Google Home 應用程式中查看、編輯、停用及執行自動化動作，但目前無法使用指令碼建立新的自動化動作。如果你使用 iPhone 或 iPad，建議透過 Google Home 網頁版建立新的自動化動作。

指令碼編輯器基本概念

指令碼編輯器使用的指令碼語言是 YAML，你可以逐行輸入指示，建立家用裝置自動化動作。進一步瞭解如何使用指令碼編輯器編寫自動化動作指令碼。

YAML 快速參考指南

YAML 概念	範例
鍵/值組合 YAML 的格式是一組鍵/值組合，中間以 : 和空格分隔，而且每個鍵/值組合都必須獨立一行。 鍵是指常值關鍵字，與鍵相關聯的值可以是簡單的字串、數字或日期，也可以是另一個複雜的鍵/值組合集合。 在本範例中，鍵 = name，值 = 開電視並關燈。	name: 開電視並關燈
縮排和巢狀鍵/值組合 你可以在單一父項鍵底下使用「巢狀結構」納入多個鍵/值組合。 YAML 使用縮排 (2 個空格) 表示結構和階層及定義巢狀元素，每個巢狀結構層級都會以相同的空格數量縮排。 在本範例中，父項鍵為 metadata，其值為是兩個巢狀鍵/值組合： 組合 1：鍵 = name，值 = 開電視並關燈 組合 2：鍵 = description，值 = 電視開啟時關燈 每一個組合都以 2 個空格縮排，表示該組合為 metadata 鍵的子項。	metadata: name: TV on lights off description: Turn off lights when TV turns on
多個值 如要在單一鍵中加入多個值，請建立清單，並在每個清單項目前使用連字號。 在本範例中，鍵 = weekday，值是內含星期一和星期四的清單。	weekday: - 星期一 - 星期四
備註 如果一行文字的開頭是 #，表示該行是備註，自動化引擎會忽略這項資訊。	# 這是一則備註，系統會忽略這項資訊。

支援的啟動條件、限制條件和動作

自動化動作的行為是由啟動條件、限制條件和動作這三個鍵定義：

• 啟動條件定義啟動自動化動作的時機，包括特定時間或裝置狀態。自動化動作可以有多個啟動條件。
• 限制條件是指自動化動作的執行限制條件，系統在每次要啟動自動化動作前會檢查限制條件。舉例來說，你可以指定自動化動作只在你外出或日落後執行。
• 動作是指要執行的自動化動作，例如調整音箱音量或開/關燈。

如需啟動條件、限制條件和動作的完整清單，請前往 Google Home 開發人員中心。這些元件各有其指示和格式，上述連結的表格中列出了支援的啟動條件、限制條件和動作，只要點選所需項目，即可查看具體指示、格式設定方式和程式碼範例。你也可以查看自己有哪些支援的裝置，以及這些裝置可用的動作和指令。

新增、編輯或刪除用指令碼建構的自動化動作

在 Google Home 網頁版或 Google Home 應用程式中，你可以使用指令碼編輯器編寫和編輯自訂自動化動作的指令碼。

重要事項：所有住家成員都能查看這些日常安排的執行時間。日常安排僅供操作方便之用，請勿在攸關安全的情況下使用。如果日常安排可能因無法啟動或停止而造成傷害或損失，請勿建立。如要使用日常安排功能，除了連上正常運作的網際網路和 Wi-Fi，還須確認 Google 和日常安排設定中所列裝置的第三方製造商均提供相應服務。日常安排功能無法保證在任何情況下都能正常運作，Google 不為任何因該功能故障而導致的損害或損失負責。

使用指令碼建立自動化動作

使用 Google Home 應用程式

1. 開啟 Google Home 應用程式 。
2. 輕觸「自動化動作」圖示 。
3. 依序輕觸「新增」圖示 「住家」「更多選項」圖示 「指令碼編輯器」。
4. 編寫新的自動化動作指令碼草稿。如需建構指令碼的說明，請參閱「使用指令碼編輯器編寫自動化動作指令碼」一文。
5. 輕觸「驗證」，確認指令碼可以執行。你無法啟用含有錯誤的自動化動作。
6. 輕觸「儲存」將自動化動作新增至住家，你也可以儲存進行中的工作。如果儲存的指令碼有效，系統就會自動啟用自動化動作。如果你還不希望啟用自動化動作，請關閉「啟用」。

使用 Google Home 網頁版

1. 開啟 home.google.com/automations 並登入帳戶。
2. Click Add new.
3. 編寫新的自動化動作指令碼草稿。如需建構指令碼的說明，請參閱「使用指令碼編輯器編寫自動化動作指令碼」一文。
4. Click Validate to verify your script is able to run. You can't activate an automation with errors.
5. Click Save to add your automation to your home or save in-progress work. If your script is valid when you save it, your automation automatically activates. If you don't want it to run yet, turn Activate off.

編輯自動化動作指令碼

你可以查看和編輯透過指令碼編輯器建立的大多數自動化動作。如果自動化動作不是使用指令碼建立，或者自動化動作正在執行，就無法透過指令碼編輯器編輯。你必須先停止自動化動作，才能進行編輯。

使用 Google Home 應用程式

1. 開啟 Google Home 應用程式 。
2. 輕觸「自動化動作」圖示 使用指令碼建立的自動化動作名稱 「編輯」。
3. 編輯自動化動作指令碼。
4. Tap Validate to verify your script is able to run. You can't activate an automation with errors.
5. Tap Save. If your script is valid when you save it, your automation automatically activates. If you don't want it to run yet, turn Activate off.

你可以在 Google Home 應用程式的「我的最愛」 固定常用裝置、房間、自動化動作和動作，這樣就能輕鬆快速地存取。進一步瞭解如何建立及自訂我的最愛。

使用 Google Home 網頁版

1. 開啟 home.google.com/automations 並登入帳戶。
2. 選取自動化動作指令碼。
3. 編輯指令碼。
4. Click Validate to verify your script is able to run. You can't activate an automation with errors.
5. Click Save to add your automation to your home or save in-progress work. If your script is valid when you save it, your automation automatically activates. If you don't want it to run yet, turn Activate off.

刪除使用指令碼建立的自動化動作

重要事項：日常安排或自動化動作一經刪除即無法復原。如要暫時停止日常安排或自動化動作，請改用暫停功能。

使用 Google Home 應用程式

1. 開啟 Google Home 應用程式 。
2. 輕觸「自動化動作」圖示 。
3. 選取要刪除的日常安排。
4. 依序輕觸「刪除」圖示 「刪除日常安排」。

使用 Google Home 網頁版

1. 開啟 home.google.com/automations 並登入帳戶。
2. 按一下「自動化動作指令碼」圖示 。
3. 依序點選「刪除」圖示 「刪除」。

自動化動作指令碼相關說明

• 如需指令碼相關說明及瞭解其他人編寫的指令碼，請前往 Google 家用裝置自動化社群。
• 為了讓自動化動作正常運作，請務必使用有效的程式碼編寫指令碼。如果指令碼有錯誤，系統會顯示訊息。進一步瞭解驗證錯誤和警告。
• 如要驗證程式碼，請點選或輕觸指令碼編輯器中的「驗證」。以下是幾個常見的錯誤：
  • 請務必使用正確的裝置名稱，格式為 <裝置名稱> - <房間名稱>。如果不確定名稱為何，請前往 Google Home 應用程式查看裝置名稱。
  • 確認裝置是否支援要執行的功能。你也可以使用自動完成功能尋找可用選項。
  • 請務必加入動作。你必須加入動作，自動化動作才能運作。
• 當你儲存指令碼後，如果自動化動作沒有正常運作，請手動確認指令碼中的各個元件是否可正常運作。舉例來說，假設你編寫的指令碼可開燈、在日落時變更燈光亮度，建議你使用 Google 助理指令分別確認這些指令是否能正常運作。你也可以檢查：
  • Google Home 應用程式是否已新增你的裝置並建立連結。
  • 裝置是否連上網路並保持連線狀態。
  • 裝置名稱、啟動條件、限制條件和動作的內容是否正確。
  • 指令碼的縮排和格式是否正確。
• Google Home 網頁版會在指令碼下方提供自動化動作記錄 ，你可以查看自動化動作的歷史記錄，並找出潛在問題。進一步瞭解自動化動作記錄中的訊息類型。
• 你可以使用指令碼編輯器的生成式 AI 實驗功能說明所需的自動化動作，系統就會生成指令碼草稿供你查看和編輯。
• 進一步瞭解日常安排的基本概念和疑難排解方式。
• 請參閱練習編寫第一個指令碼。