Projekty programisty, które obejmują integracje z Matter, są zarządzane w Google Home Developer Console. Z tego artykułu dowiesz się, jak skonfigurować nowy projekt programisty w Developer Console.
Ograniczenia
Funkcji Cloud-to-cloud lub 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 da się łatwo pomylić z innym projektem.
- Może reprezentować wszystkie integrationw projekcie.
Znaczące nazwy są ważne. Nazwa ogólna, np. project-gamma-798, jest skutecznie „kamuflowana” i nie będzie wyróżniać się na liście innych projektów o standardowych nazwach.
Nadając nazwę projektowi, weź pod uwagę te wskazówki:
- Użyj nazwy 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 jasne i unikalne nazwy projektów.
Tworzenie projektu
Projekt programisty reprezentuje co najmniej 1 integration. Udostępniając projekt członkom swojego zespołu programistów, właściciel może zezwolić innym użytkownikom na zarządzanie wszystkimi elementami integrationw projekcie.
Ekosystemem integrationinteligentnych domów zarządza się za pomocą nowego systemu Developer Console. W Developer Console dostępne są 2 metody konfigurowania projektów:
Zalecamy utworzenie tylko 1 projektu dla wszystkich integracji Matter, zarówno testowych, jak i produkcyjnych, zwłaszcza w celu uniknięcia problemów podczas testowania testowego identyfikatora dostawcy i identyfikatorów produktów dla Matter.
Metoda 1. Utwórz nowy projekt
Przejdź do Developer Console:
- Na stronie Zarządzaj projektami kliknij Utwórz projekt.
- Na stronie Rozpocznij kliknij Utwórz projekt.
- Wpisz nazwę projektu, która powinna być zgodna z wytycznymi 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 nowego projektu Developer Console, jeśli chcesz dodać obsługę Matter do istniejącej integracji Cloud-to-cloud lub Local Home.
W przypadku tej metody obowiązują następujące ograniczenia:
- 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 Actions on Google. Właścicielem jest osoba, która utworzyła projekt. Możesz ją wyświetlić po kliknięciu linku Użytkownicy.
- Profil firmy dla zaimportowanego projektu można edytować tylko w konsoli Actions on Google. Wprowadzone zmiany zostaną odzwierciedlone w konsoli programisty Google Home.
Po zaimportowaniu możesz nadal używać pierwotnego projektu Actions on Google 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ę obecnego projektu w Actions lub wybierz projekt z listy (na przykład na tym zrzucie ekranu 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.
Ustaw poziomy rejestrowania
Domyślnie w usłudze Google Cloud zapisywane są tylko logi błędów dotyczące każdej integracji w projekcie.
Aby zapisać w Google Cloud wszystkie logi dla każdej integracji, w sekcji Kontrola na poziomie logu: logi błędów wybierz Wszystkie logi.
To ustawienie dotyczy wszystkich integracji w projekcie. Nie można go ustawić dla każdej integracji. Jeśli przekroczysz dostępne miejsce, zapisanie wszystkich logów w Google Cloud może się wiązać z dodatkowymi kosztami.
Więcej informacji o logach znajdziesz w artykule Cloud Logging for Matter.
Udostępnianie projektu programisty
Możesz przyznawać i odbierać dostęp do projektu użytkownikom w zespole, korzystając ze wstępnie zdefiniowanych ról.
Na stronie głównej usługi Developer Console kliknij Członkowie. Otworzy się strona Administracja > Uprawnienia w Google Cloud Console.
Możesz też kliknąć Szczegóły projektu, a następnie kliknąć Zarządzanie użytkownikami w GCP w sekcji Użytkownicy u dołu.
W razie potrzeby wprowadź zmiany w panelu Google Cloud Console.
Instrukcje zmieniania dostępu do projektu znajdziesz w artykule Kontrola dostępu do projektów z uprawnieniami.
Po dodaniu użytkownika do listy użytkowników może on wyświetlać projekt i wszystkie integracje w Developer Console.
Zgodnie z ustawieniami organizacji podczas próby utworzenia projektów programisty mogą wystąpić błędy uprawnień. Jeśli tak, skontaktuj się ze swoim administratorem Google Cloud i poproś o uprawnienia twórcy projektów do konta.