Interfejsy Google Home API na Androida zapewniają ujednoliconą powierzchnię interfejsu API, która umożliwia deweloperom interakcję ze stanem urządzeń w domu użytkownika. Te elementy mogą opisywać urządzenia i informacje niezwiązane z urządzeniami, które są powiązane ze strukturą i pomieszczeniami użytkownika.
Interfejsy Home API definiują te elementy, z którymi użytkownik może wchodzić w interakcje:
- Domy to domy, w których znajdują się pomieszczenia i urządzenia.
- Pomieszczenia są częścią struktury i zawierają urządzenia.
- Urządzenia implementują cechy zawierające atrybuty, są zgodne z typami, emitują zdarzenia i odpowiadają na polecenia.
- Automatyzacje są częścią struktury i wykorzystują metadane domu oraz urządzenia do automatyzacji zadań w domu.
Ilustracja 1 przedstawia tę architekturę:
Typy urządzeń interfejsu Home API mogą być obsługiwane przez Matter, otwarty standard dla inteligentnego domu, lub być urządzeniem Cloud-to-cloud w ekosystemie Google Home. Niektóre typy urządzeń mogą zawierać funkcje z obu tych kategorii. Więcej informacji znajdziesz w artykule Obsługiwane typy urządzeń z Androidem.
W Matter funkcje urządzenia są pogrupowane w klastry, które w interfejsach Home API są reprezentowane jako Matter standardowe cechy. Interfejsy Home API obsługują standardowy zestaw klastrów Matter zdefiniowanych w aktualnej specyfikacji Matter.
W ekosystemie Google Home funkcje urządzeń są pogrupowane według cech inteligentnego domu, które są reprezentowane w interfejsach Home API jako cechy inteligentnego domu Google. Interfejsy Home API obsługują zestaw cech inteligentnego domu zdefiniowanych w Cloud-to-cloud.
Dostępne są też inne cechy, takie jak klastry specyficzne dla producenta i cechy platformy. Więcej informacji znajdziesz w artykule Model danych na Androidzie.
Ekosystem
Ekosystem Google Home zapewnia uproszczoną podstawę do tworzenia, zarządzania, zabezpieczania i integrowania funkcji inteligentnego domu. Rysunek 2 pokazuje, jak wszystkie komponenty współpracują ze sobą.
Ekosystem obejmuje silnik automatyzacji Google, który przechowuje i uruchamia automatyzacje umożliwiające automatyzację zadań i ustawień urządzeń w domu.
Interfejsy Home API używają OAuth 2.0, aby przyznawać dostęp do urządzeń w strukturze. Protokół OAuth umożliwia użytkownikowi przyznanie aplikacji lub usłudze uprawnień bez konieczności ujawniania danych logowania.
Google Home Developer Console służy do zarządzania wszystkimi etapami projektu interfejsów Home API, od weryfikacji marki po opracowywanie, testowanie i certyfikację, a w końcu uruchomienie. Usprawnia proces tworzenia, zapewniając jednocześnie zaawansowane narzędzia i dystrybucję w ekosystemie Google Home.
Język
Interfejsy Home API na Androida są napisane w języku Kotlin i zapewniają idiomatyczny interfejs Kotlin, który do zarządzania stanem i subskrypcją wykorzystuje Flow. Daje to szereg korzyści w porównaniu ze standardowym interfejsem API subskrypcji.
Jeśli nie znasz jeszcze tych tematów, zapoznaj się z dokumentacją Kotlin dotyczącą korutyn, przepływów i Jetpack Compose:
- Tworzenie aplikacji na Androida w Kotlinie
- Poznaj język Kotlin na potrzeby Androida
- Korutyny Kotlin na Androidzie Te konkretne codelaby mogą być przydatne:
- Przepływy Kotlin na Androidzie, a w szczególności StateFlow.
- State i Jetpack Compose, a w szczególności funkcja
collectAsStateWithLifecycle(). Ta funkcja automatycznie zarządza subskrypcją i anulowaniem subskrypcji przepływów w zależności od tego, czy interfejs pokazujący ten stan jest rzeczywiście na pierwszym planie. - Jeśli korzystasz z interfejsu Automation API, warto przeczytać artykuł o budowniczych bezpiecznych pod względem typów w języku Kotlin, aby zrozumieć, jak działa język DSL automatyzacji.
Identyfikatory jednostek
Każda encja w interfejsach Home API ma identyfikator, który jest jej głównym identyfikatorem. Jest to unikalny i stały identyfikator, który nigdy się nie zmieni w całym okresie istnienia podmiotu. Ten identyfikator może służyć do buforowania obiektów lub sprawdzania równości, ponieważ metadane jednostki mogą się zmieniać.
Aby dowiedzieć się, które jednostki mają identyfikator, zapoznaj się z interfejsem HasId.
Mapowanie terminologii
Obiekty w interfejsach API Home są mapowane na koncepcje Matter i Cloud-to-cloud w następujący sposób:
| Interfejsy Home API | Matter | Cloud-to-cloud |
|---|---|---|
| Cechy | Klaster | Cechy |
| Atrybut | Atrybut | Atrybut, Stan |
| Polecenie | Polecenie | Polecenie |
| Zdarzenie | Zdarzenie | Odpowiedź uzupełniająca, powiadomienie |