Projekty dewelopera, które obejmują integracje typu Matter, są zarządzane na platformie Google Home Developer Console. Z tego artykułu dowiesz się, jak skonfigurować nowy projekt programisty w Developer Console.
Ograniczenia
Funkcji Cloud-to-cloud ani Local Home SDK nie można dodać do projektu w Developer Console. Jeśli chcesz dodać funkcję Matter do istniejącej integracji Cloud-to-cloud lub Local Home, musisz najpierw zaimportować istniejący projekt Actions on Google.
Nazwij projekt
Nadaj projektowi nazwę, która:
- Zawiera podstawowe informacje o projekcie.
- nie będą się łatwo pomylić z innym projektem;
- Może reprezentować wszystkie elementy integrationw projekcie.
Znaczące nazwy są ważne. Ogólna nazwa, na przykład project-gamma-798
, jest w rzeczywistości zakamuflowana i nie wyróżni się na liście innych projektów ogólnie nazywanych ogólnie.
Podczas nadawania nazwy projektowi weź pod uwagę te wskazówki:
- Użyj nazwy swojej firmy
- Użyj w nazwie typu projektu lub działania
- Nie używaj słowa „test” w nazwie projektu.
Na przykład acme-smarthome
i acme-lighting
to zrozumiałe i niepowtarzalne nazwy projektów.
Tworzenie projektu
Projekt programisty reprezentuje co najmniej 1 element integration. Udostępniając projekt członkom zespołu programistów, właściciel może zezwolić innym użytkownikom na zarządzanie wszystkimi elementami integrationw projekcie.
Ekosystemem inteligentnego domu Google integrationzarządza się za pomocą nowego narzędzia: Developer Console. W Developer Console dostępne są 2 metody konfigurowania projektów:
Zalecamy utworzenie tylko jednego projektu dla wszystkich integracji Matter, zarówno testowych, jak i produkcyjnych. Jest to szczególnie ważne, aby uniknąć problemów podczas testowania za pomocą testowych identyfikatorów dostawców i identyfikatorów produktów dla Matter.
Metoda 1. Utwórz nowy projekt
Przejdź do Developer Console:
- Na stronie Zarządzanie projektami kliknij Utwórz projekt.
- Na stronie Rozpocznij kliknij Utwórz projekt.
- Wpisz nazwę projektu, która powinna być zgodna ze wskazówkami dotyczącymi nazewnictwa projektów.
- Kliknij Create new project (Utwórz nowy projekt).
Nastąpi przekierowanie na stronę główną nowego projektu.
Metoda 2. Zaimportuj istniejący projekt z konsoli Actions on Google
Istniejący projekt Actions on Google może zostać zaimportowany do nowej integracji Developer Console, jeśli musisz dodać obsługę Matter do istniejącej integracji Cloud-to-cloud lub Local Home.
W przypadku tej metody obowiązują te ograniczenia:
- Ten import odbywa się tylko w jedną stronę. Tej czynności nie można cofnąć.
- Tylko właściciel projektu może zaimportować istniejący projekt w usłudze Actions on Google. Właścicielem jest osoba, która utworzyła projekt. Można go wyświetlić za pomocą linku Użytkownicy.
- Profil firmy w zaimportowanym projekcie można edytować tylko w konsoli Actions on Google. Wprowadzone zmiany zostaną odzwierciedlone w konsoli programisty Google Home.
Po zaimportowaniu pierwotny projekt Actions on Google nadal może być używany do zarządzania istniejącymi integracjami (np. Cloud-to-cloud, Local Home, App Discovery).
Aby zaimportować istniejący projekt z Actions on Google Console, otwórz Developer Console:
- Kliknij Utwórz projekt.
- Wpisz nazwę projektu w Actions lub wybierz go z listy (np. na zrzucie ekranu poniżej nazwa projektu to „Mój projekt sprawy”).
- Kliknij Import project (Importuj projekt).
Nastąpi przekierowanie do szczegółów istniejącego projektu w zadaniu Developer Console.
Ustawianie poziomów logu
Domyślnie w usłudze Google Cloud zapisywane są tylko logi błędów dla każdej integracji w projekcie.
Aby zapisać wszystkie logi w usłudze Google Cloud dla każdej integracji, wybierz Wszystkie logi w sekcji Kontrola na poziomie logu: logi błędów.
To ustawienie dotyczy wszystkich integracji w Twoim projekcie. Nie można go ustawić dla danej integracji. Zapisanie wszystkich logów w usłudze Google Cloud może spowodować naliczenie dodatkowych opłat w przypadku przekroczenia limitu miejsca na logi.
Więcej informacji o logach znajdziesz w artykule Cloud Logging for Matter.
Udostępnianie projektu dewelopera
Możesz przyznawać i odbierać dostęp do projektu użytkownikom w zespole za pomocą wstępnie zdefiniowanych ról.
Na stronie głównej Developer Console kliknij Członkowie. Otworzy się strona Administracja > Uprawnienia w panelu Google Cloud Console.
Możesz też kliknąć Szczegóły projektu, a następnie w sekcji Użytkownicy u dołu kliknąć Zarządzaj użytkownikami w GCP.
W razie potrzeby wprowadź zmiany w panelu Google Cloud Console.
Instrukcje, jak zmienić dostęp do projektu, znajdziesz w artykule Kontrola dostępu do projektów z uprawnieniami.
Po dodaniu do listy użytkowników użytkownik może wyświetlać projekt i integracje w Developer Console.
Zgodnie z ustawieniami organizacji mogą wystąpić błędy uprawnień podczas próby tworzenia projektów programisty. Jeśli tak, skontaktuj się z administratorem Google Cloud i poproś o uprawnienia twórcy projektów na Twoim koncie.