Z tego przewodnika dowiesz się, jak skonfigurować środowisko do tworzenia akcji za pomocą SDK Actions i Actions Builder. Wykonasz te zadania:
- Zainstaluj Node.js: aby korzystać ze środowiska Node.js, musisz mieć to środowisko wykonawcze. w bibliotece realizacji zamówień.
- Zainstaluj interfejs wiersza poleceń Firebase: to narzędzie wiersza poleceń pozwala tworzyć wdrażanie zależności Firebase, takich jak aplikacje internetowe, na potrzeby interaktywnego obszaru roboczego, Hosting Firebase.
- Instalowanie narzędzia wiersza poleceń gactions: podczas programowania za pomocą polecenia Actions SDK, za pomocą tego narzędzia możesz tworzyć i wdrażać pakiet akcji dla akcję.
- Tworzenie projektu w Actions: projekt w Actions jest kontenerem logicznym. dotyczące akcji konwersacyjnych. Musisz je utworzyć w Konsoli Actions, zanim mogą zacząć tworzyć.
- Zainicjuj i wdróż przykład: ten prosty przykład pokazuje, jak rozpoczął tworzenie akcji opartych na Interaktywnej Canvas.
Gdy wykonasz ten krótki przewodnik, możesz zsynchronizować swój projekt w Actions między lokalnego środowiska programistycznego i środowiska internetowego Actions Builder.
Instalowanie Node.js i interfejsu wiersza poleceń Firebase
Pobierz i zainstaluj Node.js zgodnie z Node.js dokumentacji do korzystania z naszej biblioteki realizacji zamówień. Również Twoja instalacja środowiska Node.js pozwala zainstalować interfejs wiersza poleceń Firebase za pomocą npm, a później uruchamiać lokalnej implementacji realizacji konwersacyjnej.
Zainstaluj i skonfiguruj interfejs wiersza poleceń Firebase zgodnie z wymaganiami do dokumentacji Firebase. Interfejs wiersza poleceń Firebase pozwala wdrożyć aplikację internetową Canvas w Hostingu Firebase i w razie potrzeby wdrożyć ją ręcznie; do Cloud Functions dla Firebase.
Instalowanie narzędzia wiersza poleceń Gactions
Zainstaluj narzędzie interfejsu wiersza poleceń Gactions, pobierając pakietu instalacyjnego, rozpakowania go i skonfigurowania ścieżki wykonywania.
Aby zainstalować i skonfigurować interakcje, wykonaj te czynności:
Pobierz pakiet odpowiedni dla swojego systemu operacyjnego:
Platforma Pakiet Suma kontrolna Windows Pobierz SHA256 Linux Pobierz SHA256 System operacyjny macOS Pobierz SHA256 Rozpakuj pakiet do wybranej lokalizacji i dodaj plik binarny do w zmiennej
PATH
środowiska. Możesz też rozpakować pakiet do lokalizacja, która znajduje się już w zmiennejPATH
(np./usr/local/bin
).W systemach Linux i Mac włącz uprawnienia do uruchamiania, jeśli to konieczne:
chmod +x PATH_TO/gactions
Uruchom to polecenie, aby uwierzytelnić interfejs wiersza poleceń. To polecenie uruchamia proces uwierzytelniania i wymaga przeglądarki:
gactions login
Po zakończeniu procesu interfejs wiersza poleceń uwierzytelnia się automatycznie.
Tworzenie i konfigurowanie projektu
Zanim zaczniesz korzystać z narzędzia wiersza poleceń frakcji, musisz utworzyć projekt w w Konsoli Actions i przyznaj gakcjom dostęp do projektu. Aby utworzyć i ustawić utwórz projekt, wykonaj te czynności:
- Otwórz konsolę działań.
- Kliknij New project (Nowy projekt), wpisz nazwę projektu i kliknij Create project (Utwórz projekt).
- Wybierz kategorię i kliknij Dalej.
- Wybierz Pusty projekt i kliknij Rozpocznij tworzenie.
- Włącz Actions API w konsoli Google Cloud przez wykonanie tych czynności instrukcje znajdziesz w sekcji Włączanie i wyłączanie interfejsów API. Dzięki temu ułamki mogą wchodzić w interakcję z Twoim projektem.
Pobierz próbkę ze świata Hello World
Interaktywny przykład gry Hello World pokazuje, jak utworzyć proste akcje za pomocą jednej akcji korzystającej z platformy Interactive Canvas.
Utwórz pusty katalog i zainicjuj przykładowy obszar interaktywny do tego katalogu. Na przykład ten kod inicjuje przykład w pliku
interactive-canvas-sample/
, używany jako przykład w tym dokumencie:gactions init interactive-canvas --dest interactive-canvas-sample
cd interactive-canvas-sample
Otwórz plik
interactive-canvas-sample/sdk/settings/settings.yaml
i zmień wartość polaprojectId
na identyfikator Twojego projektu.
Wdrażanie i testowanie przykładu
Po skonfigurowaniu przykładu możesz wdrożyć aplikację internetową Interactive Canvas w projekcie Actions. Ten proces spowoduje utworzenie wersji roboczej działań. projekt, który możesz wdrożyć w Actions Simulator (Symulatorze Actions) na potrzeby wyświetlania podglądu i testowania:
W katalogu
interactive-canvas-sample/
uruchom to polecenie aby wdrożyć aplikację internetową Interactive Canvas (zawartośćpublic/
).firebase deploy --project PROJECT_ID --only hosting
Możesz zobaczyć wyrenderowaną wersję aplikacji internetowej pod adresem URL zwróconym przez funkcję Interfejs wiersza poleceń Firebase w przeglądarce:
https://PROJECT_ID.web.app
Otwórz plik
interactive-canvas-sample/sdk/webhooks/ActionsOnGoogleFulfillment/index.js
i zmień wartość zmiennejCANVAS_URL
na adres URL aplikacji internetowej Twojego projektu.const CANVAS_URL = 'https://PROJECT_ID.web.app';
W katalogu
interactive-canvas-sample/sdk/
uruchom następujące polecenie aby przekazać lokalną wersję projektu Actions do konsoli jako wersja robocza:gactions push
W katalogu
interactive-canvas-sample/sdk/
uruchom następujące polecenie aby przetestować projekt Actions w symulatorze:gactions deploy preview
Otwórz link zwrócony przez narzędzie wiersza poleceń, by przejść do symulatora.
W symulatorze wpisz "Talk to Interactive Canvas sample", aby uruchomić działanie. Ty zobaczysz obracający się trójkąt zasilany przez aplikację internetową
.https://PROJECT_ID.web.app