歡迎來到 Google Home 開發人員中心,你可以在這裡學習如何學習智慧型住宅動作。注意事項:您將在 Actions 主控台建構動作。

智慧住宅裝置特性

裝置類型的功能來自您為每個類型新增的特性。每種裝置類型都有幾種建議特性,但您也可以新增任何偏好的屬性。次要使用者驗證適用於所有裝置特性。

請參閱「支援的語言」清單,瞭解所有特質。

姓名 裝置特徵 說明 建議裝置類型
應用程式選取器 action.devices.traits.AppSelector 這個特性屬於支援媒體應用程式的裝置,通常來自第三方。 支援裝置啟動、安裝及搜尋裝置上執行的媒體裝置。
ArmDisarm action.devices.traits.ArmDisarm 這項特性支援啟動和解除功能,例如保全系統。 保全系統或任何支援實驗組和解除設備的裝置
亮度 action.devices.traits.Brightness 絕對亮度設定在正規化值到 0 到 100 之間 (個別燈具可能不支援根據 LED 設定範圍中的每個點)。 輕度
相機串流 action.devices.traits.CameraStream 裝置具有這樣的特性,能夠將影片串流串流至第三方螢幕、與 Chromecast 連線的螢幕或智慧型手機。而大型監視器的監視攝影機或嬰兒相機但此特性也適用於裝有相機的複雜裝置 (例如視訊會議裝置或附有相機的吸塵器)。 相機
管道 action.devices.traits.Channel 這項特性屬於媒體裝置支援電視頻道的裝置。 電視
色彩設定 action.devices.traits.ColorSetting 這項特性適用於可能改變顏色或色彩溫度的裝置 (例如智慧型燈具)。 輕度
色彩規格 action.devices.traits.ColorSpectrum 這適用於使用 RGB 色彩範圍的「完整」色燈泡。光源可以是 ColorSpectrum 和 ColorTemperature 的任意組合。強調燈和 LED 燈條可能只有 Spectrum,但部分閱讀燈泡只有溫度。基本燈泡或智慧型插座的燈泡都沒有。 輕度
色溫 action.devices.traits.ColorTemperature 這適用於在 Kelvin 中處理顏色點的「戰爭」燈泡。這通常與 ColorSpectrum 的獨立型態,也可能有透過 Spectrum 無法到達的溫度。視可用特徵而定,Google 可能會根據要求和光源類型選擇適當的模式 (例如,將客廳的燈光變成白色,可能會將溫度指令傳送至部分燈泡,以及指定 Spectrum 指令)。 輕度
烹飪 action.devices.traits.Cook 裝置具有這種特性,可以根據多種預設料理和支援的烹飪模式烹飪。 支援烹飪各種類型的裝置。
意識 action.devices.traits.Dispense 這個特性涵蓋的裝置,用於支援指定一或多個實體項目的指定數量。舉例來說,愛狗食用器可能會供應多種甜點;水龍頭可能會分水杯,寵物餵食器則可能會供應水和寵物食物。 裝置支援透過一定數量的一或多個實體商品宣傳。
座架 action.devices.traits.Dock 這項特性是針對自助式行動裝置所設計,能夠指示裝置回傳資料以進行充電。 吸塵器
EnergyStorage action.devices.traits.EnergyStorage 這個特性是指裝置可以儲存電池的電池、可能充電的充電裝置,或可為其他裝置充電的裝置。這個追蹤記錄支援開始和停止充電,以及查看目前的充電量、剩餘容量和容量,直到完整的值為止。 可為裝置充電。
FanSpeed action.devices.traits.FanSpeed 裝置具有這種特性,可以用來設定風扇速度 (例如,從不同層級吹下裝置),例如空調、暖氣設備或車身中的低速、中或高風。
填滿 action.devices.traits.Fill 這項特性適用於支援填滿的裝置,例如浴缸。 任何能填滿的裝置,例如浴缸。
HumiditySetting action.devices.traits.HumiditySetting 這項特性會用於支援濕度設定 (例如加濕器和除濕器) 的裝置。 任何支援濕度設定的裝置,例如加濕器或除濕機。
輸入選取器 action.devices.traits.InputSelector 訓練可變更媒體輸入的裝置。這些輸入可為各個裝置提供動態名稱,且可能表示使用音訊或視訊動態饋給 (有線或網路)。 任何支援切換媒體的媒體裝置。
燈光效果 action.devices.traits.LightEffects 這個特性裝置可用於支援複雜的亮度指令,例如變換不同顏色的裝置。 輕度
定位器 action.devices.traits.Locator 這個特性會用於「找到」的裝置。包括手機、機器人 (包括吸塵器、割草機)、無人機和附加至其他裝置的標記專屬產品。 任何需要找到的裝置,例如機器人 Vacuum
鎖定 action.devices.traits.LockUnlock 這個特質涵蓋支援鎖定和解鎖功能,以及/或是回報鎖定狀態的裝置。 支援鎖定和解鎖功能,和/或回報鎖定狀態的裝置。
MediaState action.devices.traits.MediaState 這個影像會用於能夠回報媒體狀態的裝置。 任何能回報媒體狀態的媒體裝置
模式 action.devices.traits.Modes 這個特性會用於任何有任意「雙向」模式的裝置,其中每種模式的模式和設定是免費的,且各種裝置類型或裝置類型都是唯一的。每種模式都有多個可能的設定,但一次只能選取一個設定;DDR 模式無法同時處於「精緻」、「正常」和「嚴重任務」模式。可開啟或關閉的設定屬於「Toggles」特性。 任何檔案
NetworkControl action.devices.traits.NetworkControl 這個特性會用於支援回報網路資料及執行網路特定作業的裝置。 可以回報網路資料及執行網路特定作業的裝置。
ObjectDetection action.devices.traits.ObjectDetection 這項特性屬於裝置可以偵測物件或人物,並傳送通知給使用者。例如,門鈴可以用來表示人員 (已命名或未命名) 執行門鈴,以及用來偵測物體或人移動的攝影機和感應器。 可偵測物件或人物並傳送通知給使用者的裝置。
可住人數 action.devices.traits.OccupancySensing 這個管道視為可偵測活動情形的裝置,無論是透過 PIR、超音波或身體接觸感應,都屬於此類。 可偵測活動情形的裝置,無論是透過 PIR、超音波或身體接觸感應,都不成問題。
關閉 action.devices.traits.OnOff 針對任何開啟及關閉二進位檔的裝置,包括電源和外接切換裝置,以及許多日後的裝置,都包括基本和關閉功能。
OpenClose action.devices.traits.OpenClose 屬於例如,某些百葉窗向左或右側開啟。在某些情況下,開啟特定裝置可能會是安全性敏感動作,而且可能需要雙重驗證。請參閱雙重驗證 支援開啟和關閉的任何裝置。
重新啟動 action.devices.traits.Reboot 這項特性會用於支援重新啟動的裝置,例如路由器。裝置需要支援重新啟動為單一動作。 任何支援重新啟動的裝置。
旋轉 action.devices.traits.Rotation 這項特性適用於支援旋轉功能的裝置,例如具有可旋轉板蓋的百葉窗。 支援旋轉功能的裝置,例如裝有石板的百葉窗。
RunCycle action.devices.traits.RunCycle 這個特性代表有持續運作的作業,可查詢其持續進行的裝置。包括 (但不限於) 洗衣機、乾洗機和洗碗機的裝置。 任何 - 主要為「設備」和其他具備執行狀態的裝置
SensorState action.devices.traits.SensorState 這項特性涵蓋量化測量資料 (例如空氣品質指數或煙霧等級) 和定量狀態 (例如空氣品質良好或煙霧濃度)。 提供量化評估的感應器 (例如煙霧等級) 和定性狀態 (空氣品質良好)
情境 action.devices.traits.Scene 針對情境,類型會將 1:1 對應至特性,因為場景不會與其他特性結合,形成複合裝置。 僅限情境
軟體更新 action.devices.traits.SoftwareUpdate 這個特性涵蓋支援軟體更新的裝置,例如路由器。 任何支援軟體更新的裝置。
啟動 action.devices.traits.StartStop 啟動及停止裝置提供了類似的功能,讓使用者在開啟及啟動裝置時開啟或關閉這項功能。有些裝置只是直接開啟和關閉狀態,部分裝置在啟動作業後也可以暫停。 任何 - 主要是電器、吸塵器,以及其他具有特定活動行為的電池
狀態報告 action.devices.traits.StatusReport 這個特性會回報特定裝置或已連結的裝置目前的狀態或狀態。 回報特定裝置或狀態裝置 (例如保全系統) 的目前狀態或狀態
溫度 action.devices.traits.TemperatureControl 在裝置內部或周圍支援溫度感應器 (非溫度控制器)。包括烤箱和冰箱等裝置。
溫度設定 action.devices.traits.TemperatureSetting 這項特性涵蓋處理溫度點和模式的情況。
計時器 action.devices.traits.Timer 計時器特徵代表裝置的計時器,主要為烤箱和微波爐等主要家電,但包括但不限於家電。 任何設有計時器的裝置,例如微波爐或烤箱等廚房電器。
切換 action.devices.traits.Toggles 這個特性會歸因於僅存在於以下兩種狀態的任何裝置上。這些設定可呈現實體按鈕,包括開啟/關閉或啟用/停用狀態、HTML 中的核取方塊,或任何其他啟用/停用元素的元素。 任何檔案
TransportControl action.devices.traits.TransportControl 這個特性支援能夠控制媒體播放的媒體裝置,例如繼續播放已暫停的音樂。 裝置支援與第三方裝置進行雙向語音通訊。
數量 action.devices.traits.Volume 這個特性代表可以變更音量的裝置,例如將音量設為特定等級、設為靜音或取消靜音。 可變更音量的媒體裝置。

支援的語言

上述特徵均支援下列語言:

  • 丹麥文 (da)
  • 荷蘭文 (nl)
  • 英語 (en)
  • 法文 (fr)
  • 德文 (de)
  • 北印度文 (hi)
  • 印尼文 (id)
  • 義大利文 (it)
  • 日文 (ja)
  • 韓文 (ko)
  • 挪威文 (no)
  • 葡萄牙文 (pt-BR)
  • 西班牙文 (es)
  • 瑞典文 (sv)
  • 泰文 (th)
  • 中文 (zh-TW)