裝置支援來自 Google Home 生態系統或 Matter 規格的一或多個特徵,並在裝置上啟用特定功能。如要進一步瞭解裝置類型,請參閱 Android 上的資料模型。
表格鍵:
- matter 表示特徵來自 Matter 標準。
- google 表示該特徵來自 Google 智慧型住宅。
- Kotlin 範例應用程式:指出是否已在範例應用程式中,為裝置類型實作裝置狀態或裝置的有限控制 (包括讀取和寫入狀態)。如果適用,每個裝置類型都會列出特定裝置控制選項。
- 用途:指出 Google Home 生態系統中的裝置類型 (顯示在 Google Home 應用程式中,並列於「用途」頁面),Home API 裝置類型會對應至此類型。
- 裝置類型 ID 是專屬 ID,包含四位數的字串 (
0000
或6006
),對應至 Matter 供應商 ID (VID)。通常,記錄訊息可能只會包含裝置類型 ID,例如類型未註冊時。舉例來說,home.matter.0000.types.002d
是 Matter 裝置類型AirPurifierDevice
,home.matter.6006.types.0100
則是 Google 裝置類型GoogleAirCoolerDevice
。
Android 適用的 Home API 支援下列裝置和相關特徵:
Home API 裝置類型 | 特徵 | Kotlin 範例應用程式 | 用途 |
---|---|---|---|
空氣清淨機
專為淨化室內空氣而設計的裝置。 |
必要特徵 matter Identify matter FanControl matter HepaFilterMonitoring matter ActivatedCarbonFilterMonitoring google ExtendedFanControl google ExtendedAirQuality google FilterMonitoring |
空氣清淨機 | |
空氣品質感應器
這類裝置可監控及測量室內和室外環境中與周遭空氣品質相關的各種參數。 |
必要特徵 matter 識別 matter AirQuality matter TemperatureMeasurement matter RelativeHumidityMeasurement matter CarbonMonoxideConcentrationMeasurement matter CarbonDioxideConcentrationMeasurement matter NitrogenDioxideConcentrationMeasurement matter OzoneConcentrationMeasurement matter Pm25ConcentrationMeasurement matter FormaldehydeConcentrationMeasurement matter Pm1ConcentrationMeasurement matter Pm10ConcentrationMeasurement matter TotalVolatileOrganicCompoundsConcentrationMeasurement matter RadonConcentrationMeasurement |
感應器 | |
接觸感應器
偵測物體 (例如門窗) 開關狀態的裝置。 |
必要特徵 matter Identify matter BooleanState |
布林狀態 |
感應器 |
流量感應器
測量及回報流體流速的裝置。 |
必要特徵 matter Identify matter FlowMeasurement |
感應器 | |
濕度感應器
回報濕度測量的裝置。 |
必要特徵 matter Identify matter RelativeHumidityMeasurement google ExtendedFanControl google RelativeHumidityControl google ExtendedOperationalState |
感應器 | |
光度感應器
可測量並回報感應器所受光照強度 (照度) 的測量和感應裝置。 |
必要特徵 matter Identify matter IlluminanceMeasurement |
感應器 | |
活動情形感應器
可測量及回報指定區域占用狀態的測量和感應裝置。 |
必要特徵 matter Identify matter OccupancySensing |
住家活動情形偵測 |
感應器 |
開關感應器
這類裝置可與照明裝置繫結,用來開啟或關閉照明裝置。 |
必要特徵 matter Identify |
感應器 | |
壓力感應器
測量並回報流體壓力的裝置。 |
必要特徵 matter 識別 � matter PressureMeasurement |
感應器 | |
雨水感應器
回報降雨情況的裝置。 |
必要特徵 matter Identify matter BooleanState |
感應器 | |
溫度感應器
回報溫度測量值的裝置。 |
必要特徵 matter 識別 matter TemperatureMeasurement |
感應器 | |
水結冰偵測器
回報水結冰可能性的裝置。 |
必要特徵 matter Identify matter BooleanState |
感應器 | |
漏水偵測器
回報漏水情形的裝置。 |
必要特徵 matter Identify matter BooleanState |
感應器 | |
基本影片播放器
能夠將媒體播放至實體輸出裝置或裝置內建螢幕的裝置。可進行基本播放控制 (例如播放或暫停),以及透過數字鍵盤輸入 (向上、向下、輸入數字)。 |
必要特徵 matter OnOff matter MediaPlayback matter KeypadInput matter WakeOnLan matter Channel matter TargetNavigator matter MediaInput matter LowPower matter AudioOutput |
電視 | |
投放影片播放器
裝置可將媒體內容輸出至實體輸出裝置或裝置內建的螢幕,並可啟動內容。可進行基本播放控制 (例如播放或暫停),以及透過數字鍵盤輸入 (向上、向下、輸入數字)。 |
必要特徵 matter OnOff matter MediaPlayback matter KeypadInput matter ContentLauncher matter WakeOnLan matter Channel matter TargetNavigator matter MediaInput matter LowPower matter AudioOutput matter ApplicationLauncher matter AccountLogin |
電視 | |
電視
這類裝置結合了調諧器、螢幕和揚聲器,可供使用者觀看及聆聽媒體。 |
選用特徵
google ExtendedApplicationLauncher matter Channel google ExtendedChannel google ExtendedMediaInput matter MediaPlayback google ExtendedMediaPlayback google MediaActivityState matter OnOff matter LevelControl google ExtendedLevelControl |
電視 | |
彩色調光開關
可調整色溫和亮度來控制照明裝置的裝置。 |
必要特徵 matter Identify |
Switch | |
調光開關
可開啟或關閉裝置,並控制燈光強度的裝置。 |
必要特徵 matter Identify |
Switch | |
一般切換器
可透過閂鎖 (例如翹板) 或瞬時 (例如按鈕) 開關的裝置。 |
必要特徵 matter Identify matter Switch |
Switch | |
色溫燈
可開啟或關閉、調整光線強度和色溫的照明裝置。 |
必要特徵 matter Identify matter OnOff matter LevelControl matter ColorControl google LightEffects google ExtendedColorControl |
開關、亮度 |
輕度 |
可調光燈
可開啟或關閉、調整亮度,以及透過繫結的占用感應器切換的照明裝置。 |
必要特徵 matter Identify matter OnOff matter LevelControl |
開關、亮度 |
輕度 |
擴展色域燈光
可開啟或關閉、調整亮度、調整色溫,並可透過綁定的人體感應器切換的照明裝置。 |
必要特徵 matter Identify matter OnOff matter LevelControl matter ColorControl google LightEffects google ExtendedColorControl |
開關、亮度 |
輕度 |
開燈/關燈
可開啟或關閉的照明裝置。 |
必要特徵 matter Identify matter OnOff matter LevelControl google LightEffects |
開關、亮度 |
輕度 |
烹煮表面
代表烹飪或其他類似裝置上加熱物件的裝置。 |
Cooktop | ||
爐台
代表烹調表面,具有一或多個加熱元件。 |
必要特徵 matter OnOff |
Cooktop | |
可調光插電式裝置
這類裝置可透過繫結的控制器裝置 (例如調光開關或彩色調光開關) 開啟/關閉及調整亮度。 |
必要特徵 matter Identify matter OnOff matter LevelControl |
Outlet | |
開關插座
可透過繫結的控制器裝置 (例如開關或調光器) 開啟或關閉的裝置。 |
必要特徵 matter Identify matter OnOff |
開啟和關閉 |
Outlet |
洗碗機
用來清洗餐具和與食物製備及食用相關物品的裝置。 |
必要特徵 matter OperationalState matter Identify matter OnOff matter TemperatureControl matter DishwasherMode matter DishwasherAlarm google ExtendedOperationalState google ExtendedTemperatureControl |
洗碗機 | |
門鎖
用於鎖門的裝置,可透過手動或遠端方式啟動。 |
必要特徵 matter Identify matter DoorLock |
鎖定 | |
Energy Evse
可為電動車或插電式油電混合車充電的裝置。 |
必要特徵 matter EnergyEvse matter EnergyEvseMode matter Identify matter TemperatureMeasurement google ExtendedModeSelect google ExtendedPowerSource |
充電器 | |
充電器
為蓄電池充電的裝置。與充電器互動包括開始和停止充電,以及檢查目前的電量、剩餘電量和充飽電量。 |
充電器 | ||
抽油煙機
通常安裝在爐具上方,可抽出空氣,減少異味和煙霧。 |
必要特徵 matter FanControl matter Identify matter HepaFilterMonitoring matter ActivatedCarbonFilterMonitoring google ExtendedFanControl |
連帽上衣 | |
電風扇
裝置內建風扇,支援多種模式和可變速度。 |
必要特徵 matter Identify matter FanControl |
風扇 | |
冷氣機
可控制溫度和濕度的裝置。這類裝置通常比空調輕巧,方便攜帶,且附有水箱。冷風扇可能不支援暖氣或設定確切溫度。與涼風扇的互動包括變更風扇轉速和濕度設定。 |
必要特徵 matter OnOff matter FanControl google ExtendedFanControl matter RelativeHumidityMeasurement google RelativeHumidityControl matter TemperatureMeasurement matter Thermostat google ExtendedThermostat matter ThermostatUserInterfaceConfiguration |
涼風扇 | |
影音接收器
可接收音訊輸入 (例如 HDMI、光纖和 RCA),並將聲音輸出至一或多個喇叭的裝置。 |
選用特徵
google ExtendedApplicationLauncher google ExtendedMediaInput matter MediaPlayback google ExtendedMediaPlayback google MediaActivityState matter OnOff matter LevelControl google ExtendedLevelControl |
影音接收器 | |
自動
|
選用特徵
google LockUnlock matter OperationalState google ExtendedOperationalState matter PowerSource google ExtendedPowerSource google Toggles google ExtendedModeSelect |
自動 | |
浴缸
可注水和排水的裝置,如果浴缸支援,可能還能注水到特定水位。 |
選用特徵
matter TemperatureControl google Fill matter TemperatureMeasurement google ExtendedTemperatureControl matter OperationalState google ExtendedOperationalState |
Bathtub | |
食物調理機
用來攪拌、切碎或混合食物的廚房電器。與果汁機的互動包括啟動和停止、設定計時器、設定烹調模式或食物預設值,或是調整其他各種設定。 |
必要特徵 matter OnOff google Cook google Timer matter OperationalState google ExtendedOperationalState |
Blender | |
鍋爐
由密閉容器和熱源組成的裝置,可從水中產生蒸氣或其他蒸發物,以供應熱能。你可以開啟及關閉鍋爐,並視情況調整溫度。 |
選用特徵
matter TemperatureControl matter TemperatureMeasurement google ExtendedTemperatureControl matter OnOff |
Boiler | |
衣櫥
用來存放物品的小型封閉空間。可開啟和關閉衣櫥,可能還能朝多個方向開啟。 |
Closet | ||
咖啡機
可製作咖啡的廚房家電。咖啡機的互動操作包括開啟和關閉、調整烹調模式和食物預設設定、調整目標溫度,以及調整各種非烹調模式設定。 |
必要特徵 matter OnOff matter TemperatureControl google Cook matter TemperatureMeasurement google ExtendedTemperatureControl |
咖啡機 | |
控制台
可設定及控制其他裝置的裝置。 |
必要特徵 google ElevatorControl google ParkingLocation |
控制台 | |
風乾機
用於脫水水果和蔬菜等食物的廚房電器。與脫水機的互動包括啟動和停止、設定計時器、調整烹調模式或食物預設設定,或是調整其他各種設定。 |
必要特徵 matter OnOff google Cook google Timer matter OperationalState google ExtendedOperationalState |
Dehydrator | |
門
一種裝置,由可移動的實心障礙物組成,可控制入口、壁櫥、櫃子等的出入。門可以開啟和關閉,而且可能朝多個方向開啟。 |
門 | ||
門鈴
門外的按鈕啟動裝置後,會發出聲音和/或視覺信號,用於引起門另一側人員的注意。這部裝置可能可以傳送通知和/或串流播放影片。 |
必要特徵 google DoorbellPress google Clip google Record google ObjectDetection |
門鈴 | |
導覽匣
這類裝置由無蓋的水平滑動隔間組成,可從家具或牆壁拉出,方便存取。抽屜可以開啟和關閉,而且可能不只一個方向。 |
Drawer | ||
水龍頭
控制液體流動的裝置。水龍頭可依各種數量和預設值分配液體。水龍頭可能有多種模式,每種模式都有相關設定。這些是水龍頭專屬的資料,會以一般化形式解讀。 |
選用特徵
matter TemperatureControl matter TemperatureMeasurement google ExtendedTemperatureControl google Dispense matter OperationalState google ExtendedOperationalState |
水龍頭 | |
冰櫃
可調整為各種模式設定,並可能允許溫度監控的溫度管理裝置。 |
必要特徵 matter TemperatureControl matter TemperatureMeasurement google ExtendedTemperatureControl |
冷凍櫃 | |
油炸機
透過油炸烹調食物的廚房家電。與氣炸鍋的互動包括啟動和停止、設定計時器、調整烹調模式或食物預設設定,或是調整其他各種設定。 |
必要特徵 matter OnOff google Cook google Timer matter OperationalState google ExtendedOperationalState |
Fryer | |
遊戲主機
用來管理及玩電玩遊戲的裝置。與遊戲主機互動包括玩遊戲和操作裝置控制項。 |
必要特徵 matter OnOff google ExtendedApplicationLauncher google ExtendedMediaInput matter MediaPlayback google ExtendedMediaPlayback google MediaActivityState matter LevelControl google ExtendedLevelControl |
遊戲主機 | |
車庫
由堅固的可移動障礙物組成的裝置,可控制車庫的進出權限。車庫門可以開啟、關閉及偵測開啟狀態。此外,如果門在關閉時遭到物體阻擋,或是門已上鎖而無法控制,也會顯示相關訊息。 |
車庫 | ||
閘門
一種裝置,由堅固的可移動障礙物組成,可透過圍籬或牆壁控管外部區域的進出。閘門可開啟和關閉,且可能朝多個方向開啟。 |
登機門: | ||
燒烤
一種裝置,可透過下方直接加熱,在烤架上烹調食物。與烤架的互動包括開啟和關閉、啟動和停止、設定計時器、調整烹調模式和食物預設設定,以及調整各種非烹調模式設定。 |
Grill | ||
煮水壺
用來煮水,以便沖泡茶等熱飲的裝置。與熱水壺的互動可能包括開啟和關閉熱水壺、調整目標溫度,以及調整各種模式設定。 |
必要特徵 matter OnOff matter TemperatureControl matter TemperatureMeasurement google ExtendedTemperatureControl |
Kettle | |
拖地機
用來清潔地板的裝置,可將地板弄濕並擦洗。 |
必要特徵 google Dock google Reboot matter OperationalState google ExtendedOperationalState google Locator matter PowerSource google ExtendedPowerSource matter OnOff |
Mop | |
割草機
用來將草坪修剪成相同高度的裝置。與割草機的互動包括啟動、停止和暫停割草、停靠、查看目前週期、尋找割草機,以及調整各種模式。 |
選用特徵
google 底座 matter OnOff matter OperationalState google ExtendedOperationalState google Locator matter PowerSource google ExtendedPowerSource |
Mower | |
多功能電子鍋
這類裝置通常可使用多種烹調方式 (包括慢燉、煎炒、蒸煮或壓力烹調) 烹煮食物,且通常不需要有人在旁照看。與多功能鍋互動時,可以啟動和停止烹調、設定計時器,或調整非烹調模式。 |
必要特徵 matter OnOff google Cook google Timer matter OperationalState google ExtendedOperationalState |
Multicooker | |
網路
代表一組路由器節點或網狀網路的裝置,可做為單一實體控制,而非個別裝置。網路裝置可能會重新啟動、更新軟體,並提供模式來處理服務品質 (QoS) 控制項和家長限制。裝置可以執行啟用訪客網路等作業,並回報網路特定資訊,例如目前的網際網路輸送量。 |
必要特徵 google NetworkControl google Reboot google SoftwareUpdate |
網路 | |
棚架
由水平格架形成的涼亭,支撐在柱子或立柱上,可開啟和關閉,可能有多個方向。舉例來說,部分帆布涼亭可能向左或向右開啟。 |
Pergola | ||
寵物餵食器
自動為貓狗等家養寵物餵食的裝置。與寵物餵食器的互動包括以各種數量和預設值供應寵物食物或水。 |
寵物餵食器 | ||
壓力鍋
廚房電器,可利用高溫高壓蒸氣快速烹調食物。與壓力鍋的互動可能包括啟動和停止、設定計時器、調整烹調模式或食物預設設定,或是調整其他各種設定。 |
必要特徵 matter OnOff |
壓力鍋 | |
路由器
這類網路裝置可控管兩個以上不同網路之間的網路流量。路由器可以重新啟動、更新軟體、提供模式來處理服務品質 (QoS) 控制項和家長限制,以及執行網路專屬作業 (例如啟用訪客網路和回報網路專屬資訊,例如目前的網際網路輸送量)。 |
必要特徵 google NetworkControl google Reboot google SoftwareUpdate |
路由器 | |
保全系統
這類裝置會監控建築物內的一或多個感應器,並在感應器偵測到異常活動時發出警報。保全系統可以啟動和解除。你可以設定多種安全等級 (例如「在家」和「外出」),並讓感應器回報特定資訊,例如感應器偵測到動作或窗戶開啟。 |
必要特徵 google ArmDisarm |
安全系統 | |
機上盒
連接電視並用來存取數位電視頻道的裝置。與多頻道電視節目供應商 (MVPD) 和機上盒裝置的互動可能包括控制媒體播放。 |
必要特徵 matter Channel matter OnOff google ExtendedApplicationLauncher google ExtendedChannel matter MediaPlayback google ExtendedMediaPlayback google MediaActivityState matter LevelControl google ExtendedLevelControl |
機上盒 | |
淋浴間
一種裝置,可將水噴灑在身上以達到清潔目的。你可以開啟和關閉淋浴設備,並視需要調整溫度。 |
選用特徵
matter TemperatureControl matter TemperatureMeasurement google ExtendedTemperatureControl matter OperationalState google ExtendedOperationalState |
淋浴間 | |
單件式環繞劇院
通常會搭配電視使用,機身為長條狀的一體式音訊裝置。 |
必要特徵 matter OnOff google ExtendedApplicationLauncher google ExtendedMediaInput matter MediaPlayback google ExtendedMediaPlayback google MediaActivityState matter LevelControl google ExtendedLevelControl |
單件式環繞劇院 | |
舒肥
一種廚房用具,用於在真空狀態下以相對低溫烹調食物。與舒芙機互動包括啟動和停止、設定計時器、調整烹調模式或食物預設設定,或是調整其他各種設定。 |
必要特徵 matter OnOff google Cook google Timer matter OperationalState google ExtendedOperationalState |
舒肥 | |
灑水器
用來在花園等區域均勻灑水的裝置。灑水器可以啟動和停止 (或開啟和關閉)。也可能支援計時器和/或排程。 |
Sprinkler | ||
Standmixer
用來混合乾料和液體食材,製作麵糊或麵團的廚房電器。與直立式攪拌機的互動可能包括開啟和關閉攪拌機、啟動和停止攪拌機、調整烹調模式或食物預設設定,或是調整各種非烹調模式設定。 |
必要特徵 matter OnOff google Cook matter OperationalState google ExtendedOperationalState |
Standmixer | |
機上盒
連接電視的裝置,用於存取媒體和音樂的數位串流服務,通常會搭配電視等螢幕使用。 |
必要特徵 matter OnOff matter Channel google ExtendedApplicationLauncher google ExtendedChannel google ExtendedMediaInput matter MediaPlayback google ExtendedMediaPlayback google MediaActivityState matter LevelControl google ExtendedLevelControl |
機上盒 | |
串流單件式環繞劇院
這類裝置結合了音箱和串流裝置 (例如串流棒或串流盒),除了音箱功能外,還提供串流體驗。 |
必要特徵 matter OnOff google ExtendedApplicationLauncher google ExtendedMediaInput matter MediaPlayback google ExtendedMediaPlayback google MediaActivityState matter LevelControl google ExtendedLevelControl |
串流單件式環繞劇院 | |
串流電視棒
這類裝置通常採用小型棒狀外觀,透過 USB 或 HDMI 傳輸線供電,連接至電視等顯示器,用來存取媒體和音樂的數位串流服務。 |
選用特徵
matter OnOff google ExtendedApplicationLauncher matter MediaPlayback google ExtendedMediaPlayback google MediaActivityState matter LevelControl google ExtendedLevelControl |
串流電視棒 | |
淨水器
可過濾和淨化水質的裝置。 |
淨水器 | ||
軟水器
可去除水中礦物質的裝置。 |
軟水器 | ||
視窗
可讓光線進入建築物的透明裝置。可開關車窗,可選擇開啟不同方向的部分,也可以上鎖和解鎖。 |
視窗 | ||
優格機
可製作優格的廚房家電。與優格機的互動可能包括啟動和停止、設定計時器、調整烹調模式或食物預設設定,或是調整其他各種設定。 |
必要特徵 matter OnOff google Cook google Timer matter OperationalState google ExtendedOperationalState |
Yogurtmaker | |
烘衣機
可烘乾衣物的裝置。 |
必要特徵 matter OperationalState matter Identify matter OnOff matter LaundryDryerControls matter LaundryWasherMode matter TemperatureControl google ExtendedOperationalState google Timer google Toggles |
烘衣機 | |
洗衣機
可清洗消費性商品的裝置。 |
必要特徵 matter OperationalState matter Identify matter OnOff matter LaundryWasherMode matter LaundryWasherControls matter TemperatureControl google ExtendedOperationalState google Toggles google ExtendedTemperatureControl google ExtendedModeSelect |
Washer | |
微波爐
使用微波加熱食物和飲料的裝置。 |
必要特徵 matter MicrowaveOvenMode matter MicrowaveOvenControl matter OperationalState matter Identify matter FanControl google ExtendedModeSelect google Cook google Timer |
微波爐 | |
烤箱
包含一或多個櫃子,可選配爐具,並能加熱食物的裝置。 |
烤箱 | ||
泵
通常用於抽水等液體,速度可能不一。可能內建選配感應器和調控機制。 |
必要特徵 matter Identify matter OnOff matter PumpConfigurationAndControl matter LevelControl matter TemperatureMeasurement matter PressureMeasurement matter FlowMeasurement |
泵 | |
幫浦控制器
可設定及控制幫浦的裝置。 |
必要特徵 matter Identify |
泵 | |
冰箱
內含一或多個櫃子的裝置,可冷藏或冷凍食物。 |
選用特徵
matter 識別 matter RefrigeratorAndTemperatureControlledCabinetMode matter RefrigeratorAlarm google ExtendedTemperatureControl |
冰箱 | |
掃地機器人
可自動清潔地板和地毯的裝置,會吸除灰塵和碎屑。 |
必要特徵 matter Identify matter RvcRunMode matter RvcOperationalState matter RvcCleanMode google ExtendedPowerSource google Locator google ExtendedOperationalState |
吸塵器 | |
室內空調
主要功能為控制單一房間空氣溫度的裝置。 |
必要特徵 matter Identify matter OnOff matter Thermostat matter FanControl matter ThermostatUserInterfaceConfiguration matter TemperatureMeasurement matter RelativeHumidityMeasurement google ExtendedFanControl google ExtendedThermostat |
AC | |
喇叭
音訊或視訊裝置可控制音量,也能設為靜音或取消靜音。 |
必要特徵 matter OnOff matter LevelControl google ExtendedApplicationLauncher google ExtendedMediaInput google ExtendedMediaPlayback google MediaActivityState google ExtendedLevelControl |
喇叭 | |
溫度控制器
裝置必須內建或配備獨立的溫度、濕度或入住感應器,並可設定所需溫度。溫度控制器可將暖氣和/或冷氣需求通知傳送至暖氣/冷氣機組 (例如室內空氣處理機),或內建可直接控制暖氣或冷氣機組的機制。 |
必要特徵 matter 識別 matter 溫度控制器 matter ThermostatUserInterfaceConfiguration google ExtendedThermostat |
溫度控制器 | |
影片遙控器
可控制影片播放器的裝置,例如傳統萬用遙控器。 |
選用特徵
google ExtendedLevelControl google ExtendedChannel google ExtendedMediaInput google ExtendedApplicationLauncher google ExtendedMediaPlayback google MediaActivityState |
媒體遙控器 | |
水龍頭
可設定及控制水流的裝置。 |
必要特徵 matter Identify matter ValveConfigurationAndControl |
Valve | |
窗簾
可遮蓋窗戶並能升起或傾斜的裝置。 |
必要特徵 matter Identify matter WindowCovering |
百葉窗 |