Forem: PubNub [Polski]

Jak korzystać z kontekstu aplikacji

PubNub Developer Relations — Tue, 09 Jul 2024 06:42:11 +0000

PubNub App Cont ext upraszcza tworzenie złożonych funkcji czasu rzeczywistego, zapewniając bezserwerowy mechanizm przechowywania informacji o użytkownikach, kanałach i członkostwie. App Context wyzwala zdarzenia przy każdej zmianie danych, umożliwiając aktualizację aplikacji w czasie rzeczywistym, a przechowywane dane mogą być wykorzystywane w Illuminate, Functions i innych usługach PubNub do podejmowania mądrzejszych decyzji. Możesz także zarządzać tymi danymi za pomocą intuicyjnego interfejsu BizOps Workspace.

Co to jest App Context?

AppContext (wcześniej znany jako Objects) pozwala na:

Nadanie znaczenia użytkownikom i kanałom w aplikacji oraz relacjom między nimi.
Przechowywanie metadanych dla wszystkich podmiotów na serwerze, co ułatwia zapewnienie globalnego źródła prawdy dla klientów. Należy pamiętać, że użytkownik nie musi reprezentować człowieka, a zamiast tego często przechowuje się stan urządzenia w obiekcie użytkownika.
Otrzymywanie natychmiastowych zdarzeń w czasie rzeczywistym za każdym razem, gdy zmieniają się wartości obiektu.

Chociaż każda aplikacja może korzystać z App Context, jest on szczególnie popularny wśród programistów tworzących rozwiązania Chat.

App Context zapewnia zestaw sugerowanych pól dla użytkowników i kanałów, a także sugerowane pola dla członkostwa między nimi. Większość z tych pól jest opcjonalna, więc możesz wybrać, które pola wypełniasz, a także podać własne pola niestandardowe.

Przypadki użycia App Context

Jak wspomniano, App Context jest szczególnie popularny wśród programistów tworzących rozwiązania Chat, ale może być używany w różnych przypadkach użycia:

Czat: Przechowywanie informacji o użytkowniku (imię i nazwisko, zdjęcie profilowe, status "na wakacjach", stanowisko), informacje o kanale (ikona, opis, odbiorcy), role użytkowników i śledzenie ostatniej przeczytanej wiadomości na kanale, na użytkownika.
Sport, media i rozrywka: Głosowanie i ankiety na żywo, ciekawostki na żywo, licytacja w czasie rzeczywistym, nakładki CTA (wezwanie do działania) dla towarów lub promocji.
Gry: Statystyki gracza w czasie rzeczywistym, w tym poziom gracza, wygrane gry, odznaki; śledzenie i zarządzanie tabelą liderów
Więcej: Status nieobecności/aktywności użytkownika, wynik zaufania użytkownika do wykrywania oszustw, śledzenie lokalizacji użytkownika, statusy urządzeń IoT, takie jak poziom naładowania baterii lub ostatni odczyt czujnika.

Jak włączyć kontekst aplikacji

Kontekst aplikacji można włączyć w następujący sposób:

Zaloguj się do portalu administratora
Kliknij zakładkę "Aplikacje" po lewej stronie portalu.
Kliknij aplikację. Zostaniesz przeniesiony na stronę zestawów kluczy dla tej aplikacji.
Jeśli jeszcze tego nie zrobiłeś, utwórz nowy zestaw kluczy, klikając przycisk "Utwórz nowy zestaw kluczy". Nastąpi przejście do strony konfiguracji tego zestawu kluczy
Włącz kontekst aplikacji, klikając suwak
Ustawienie Bucket Region to region, w którym przechowywane są dane. Należy pamiętać, że regionu nie można zmodyfikować po zapisaniu zmian w zestawie kluczy.
Jeśli ustawienia User Metadata Events i Channel Metadata Events są włączone, zdarzenia użytkownika i kanału są wyzwalane, gdy dane są ustawiane lub usuwane w bazie danych, jak omówiono później.
Jeśli włączone jest ustawienie Membership Events, zdarzenia członkostwa są wyzwalane, gdy członkostwa są dodawane, aktualizowane lub usuwane, co zostanie omówione później.
Pozostałe opcje są poza zakresem tego artykułu, ale więcej informacji można znaleźć w dokumentacji App Context.
Kliknij Zapisz zmiany, aby zapisać zaktualizowane zmiany.

Kontekst aplikacji użytkownika

Gdy nowy użytkownik zostanie zarejestrowany w aplikacji, być może za pośrednictwem zewnętrznego dostawcy tożsamości, będziesz mieć jakiś sposób na jednoznaczną identyfikację tego użytkownika w PubNub; jest to identyfikator użytkownika, którego klient użytkownika użyje do zainicjowania PubNub SDK. Identyfikator użytkownika PubNub może nie być taki sam jak identyfikator używany w innym miejscu rozwiązania do identyfikacji tego samego użytkownika, dlatego zalecamy śledzenie tego w polu "External ID".

Nazwa użytkownika, adres e-mail i adres URL profilu nie wymagają wyjaśnienia, ale korzyść z przechowywania ich w App Context oznacza, że jeśli użytkownik zmieni którekolwiek z tych pól, zmiany mogą być propagowane na dużą skalę do wszystkich klientów nasłuchujących za pomocą zdarzeń App Context, które są obsługiwane przez wszystkie nasze zestawy SDK.

Jak utworzyć reprezentację użytkownika w App Context?

Istnieją dwa sposoby tworzenia użytkownika App Context.

Użytkownicy mogą być tworzeni i zarządzani za pomocą BizOps Workspace, znajdującego się w portalu administracyjnym PubNub. Nie wymaga to żadnego kodu, a proces został wyjaśniony na przykładach w osobnym artykule: Jak zarządzać użytkownikami i kanałami za pomocą BizOps Workspace
Interfejsy API są dostępne za pośrednictwem każdego z naszych zestawów SDK do tworzenia użytkowników. Jeśli korzystasz z naszego zestawu Chat SDK, ten zestaw SDK obsługuje kontekst aplikacji za kulisami; na przykład metoda Chat SDK"createUser()" wywoła setUUIDMetadata JavaScript pod przykrywką, aby utworzyć użytkownika. Dedykowane interfejsy API służą do modyfikowania danych App Context w przypadku korzystania z dowolnego zestawu SDK innego niż Chat SDK. Wspomniałem już o JavaScript setUUIDMetadata API, ale istnieją odpowiedniki dla wszystkich naszych API, w tym Java, Swift, Kotlin, Python, Unity itp.

Kontekst aplikacji kanału

PubNub tworzy kanały automatycznie za każdym razem, gdy użytkownik je subskrybuje lub publikuje, ale kanały prawdopodobnie reprezentują coś znaczącego dla aplikacji, na przykład w aplikacji czatu możesz mieć czat grupowy, który używa kanału do komunikacji lub wydarzenie na żywo może używać dedykowanego kanału do zarządzania ankietami.

Określenie App Context dla kanału spowoduje przechowywanie i aktualizowanie wszelkich pożądanych metadanych związanych z tym kanałem, a aktualizacje te będą opcjonalnie propagowane do wszystkich zainteresowanych klientów. Możesz nadać kanałowi nazwę, np. "Czat między użytkownikiem A i użytkownikiem B", a być może kanał jest związany z przechowywaniem dokumentów, które można śledzić w niestandardowym polu "URI".

Jak utworzyć reprezentację kanału w App Context?

Podobnie jak w przypadku użytkowników, istnieją dwa sposoby tworzenia kanału App Context.

Kanały można tworzyć i zarządzać nimi za pomocą BizOps Workspace. Nie wymaga to żadnego kodu, a proces ten został wyjaśniony na przykładach w osobnym artykule: Jak zarządzać użytkownikami i kanałami za pomocą BizOps Workspace
Interfejsy API są dostępne za pośrednictwem każdego z naszych zestawów SDK do tworzenia kanałów. Jeśli korzystasz z naszego zestawu Chat SDK, obsługuje on kontekst aplikacji za kulisami; na przykład rodzina metod"Utwórz kanał" wywoła setChannelMetadata() JavaScript pod przykrywką. Jeśli korzystasz z dowolnego zestawu SDK innego niż Chat SDK, dostępne są dedykowane interfejsy API do modyfikowania danych App Context, w tym JavaScript, Java, Swift, Kotlin, Python, Unity itp.

Kontekst aplikacji członkostwa

Po zdefiniowaniu App Context zarówno dla naszych użytkowników, jak i kanałów, możemy teraz zdefiniować relację między nimi, określając, czy użytkownicy są "członkami" kanału.

Gdy użytkownik dołącza do kanału, może otrzymywać aktualizacje dotyczące każdego innego członka tego samego kanału; może być powiadamiany, gdy użytkownicy dołączają lub odchodzą, a także za każdym razem, gdy kontekst aplikacji tego użytkownika jest aktualizowany (np. aktualizują swoją nazwę).

Jest to*zwodniczo potężny mechanizm, który zapewnia dużą wartość*, szczególnie dla twórców aplikacji do czatu. Gdybyś nie korzystał z App Context, musiałbyś samodzielnie śledzić każdego użytkownika, którego kanały są członkami, i powiadamiać wszystkich innych w tym samym kanale, gdy użytkownik dołącza lub opuszcza. To wyzwanie nie skaluje się liniowo, więc im więcej użytkowników masz w swoim rozwiązaniu, tym trudniej jest próbować zarządzać wszystkimi tymi informacjami centralnie.

Korzystając z App Context, klienci czatu otrzymują wszystkie informacje potrzebne do utrzymania ich wewnętrznego stanu, a Ty masz pełną kontrolę nad tymi danymi dzięki PubNub Access Manager, aby zapobiec nieautoryzowanemu dostępowi.

Jak utworzyć członkostwo?

Podobnie jak w przypadku użytkowników i kanałów, istnieją dwa sposoby tworzenia członkostwa.

Członkostwa można tworzyć i zarządzać nimi za pomocą BizOps Workspace bez pisania kodu. Więcej informacji można znaleźć w sekcji Zarządzanie członkostwem w naszej dokumentacji.
Interfejsy API są dostępne za pośrednictwem każdego z naszych zestawów SDK do tworzenia kanałów. Jeśli korzystasz z naszego Chat SDK, to obsługuje on kontekst aplikacji za kulisami; na przykład rodzina metod"Create channel" wywoła setMemberships JavaScript pod przykrywką. Jeśli korzystasz z dowolnego zestawu SDK innego niż Chat SDK, dostępne są dedykowane interfejsy API do modyfikowania danych App Context, w tym JavaScript, Java, Swift, Kotlin, Python, Unity itp.

Odbieranie zdarzeń w czasie rzeczywistym, gdy zmienia się App Context

Gdy dane App Context ulegną zmianie, aplikacja otrzyma zdarzenie powiadamiające o tym, co się zmieniło w czasie rzeczywistym; pozwala to na tworzenie responsywnych aplikacji bez odpytywania serwera o aktualizacje.

Odbieranie zmian kontekstu aplikacji za pośrednictwem PubNub SDK (z wyłączeniem Chat SDK)

Wszystkie zestawy SDK PubNub udostępniają "Event Listeners" i to właśnie za ich pośrednictwem można nasłuchiwać zdarzeń obiektów, które są uruchamiane za każdym razem, gdy zmieniają się dane App Context.

Należy zauważyć, że w chwili pisania tego tekstu niektóre z naszych zestawów SDK obsługują nowy format "detektorów zdarzeń", jak wyjaśniono w tym blogu na temat aktualizacji silnika zdarzeń i detektorów zdarzeń. Niezależnie od formatu detektora zdarzeń, zasada pozostaje taka sama: aplikacja powinna zarejestrować się, aby otrzymywać zdarzenia kontekstu aplikacji za pośrednictwem detektora dostarczonego przez SDK.

Jak wyszczególniono w dokumentacji JavaScript SDK, rejestracja zdarzeń App Context będzie wyglądać następująco:

const channel = pubnub.channel('channel_1');
const subscription = channel.subscription();
subscription.onObjects = 
  (objectsEvent) => { console.log("Objects event: ", objectsEvent); };

Dokumentację opisującą sposób rejestracji zdarzeń App Context w innych językach można znaleźć w następujących lokalizacjach: Java, Swift, Kotlin, Python (należy pamiętać, że Python nazywa zdarzenia "metadanymi", podczas gdy inne zestawy SDK odnoszą się do zdarzeń jako "obiektów"), Unity itp.

Praktyczny przykład i interaktywne demo można znaleźć w artykule How to Manage Users and Channels with BizOps Workspace.

Odbieranie zmian kontekstu aplikacji przez PubNub Chat SDK

PubNub Chat SDK udostępnia zdarzenia App Context poprzez rodzinę interfejsów API streamUpdates().

Kilka przykładów zaczerpniętych z aplikacji Chat SDK Demo dla sieci Web:

//  Detect changes to the current User
useEffect(() => {
  return currentUser.streamUpdates(updatedUser => {
    if (updatedUser.name) {
      setName(updatedUser.name)
    }
    if (updatedUser.profileUrl) {
      setProfileUrl(updatedUser.profileUrl)
    }
  })
}, [currentUser])

//  Detect changes to an array of Channels
useEffect(() => {
if (chat && privateGroups) {
    return Channel.streamUpdatesOn(privateGroups, channels => {
    //  The array of channels, privateGroups, has been updated
}
}, [chat, privateGroups])

Aby uzyskać działający przykład oparty na naszej prostszej próbce "uzyskiwania informacji" dla Chat SDK, zapoznaj się z artykułem Jak zarządzać użytkownikami i kanałami za pomocą BizOps Workspace

Kontekst aplikacji i PubNub Illuminate

PubNubIlluminate to produkt do podejmowania decyzji i analizy w czasie rzeczywistym, który można dostosować do unikalnego przypadku użycia organizacji. Produkt został zaprojektowany z myślą o menedżerach produktu i analitykach, umożliwiając im wykonywanie następujących czynności:

Definiowanie niestandardowych zagregowanych wskaźników w czasie rzeczywistym.
Konfigurowanie i wdrażanie reguł decyzyjnych z warunkami i akcjami.
Natychmiastowe wizualizowanie śledzonych metryk, wykonywanych działań i ich wyników.

Wszystko to można robić w czasie rzeczywistym bez odrywania zespołu inżynierów od bieżących projektów.

Pełne wyjaśnienie, czym jest PubNub Illuminte i w jaki sposób może zapewnić natychmiastowy wgląd w dane, wykracza poza zakres tego artykułu, ale więcej informacji można znaleźć w naszej dokumentacji i przeglądzie produktu.

Podsumowując: Definiujesz metryki związane z Twoją aplikacją, tj. rzeczy, które chcesz mierzyć. Na przykład w scenariuszu śledzenia zasobów mogą to być godziny od przyjęcia zamówienia. Gdy zostanie spełniony jakiś warunek związany z tą metryką, np. "Godziny od zamówienia" mogą przekroczyć określoną wartość, można podjąć pewne działania.

To, które działanie zostanie podjęte, jest elastyczne, ale trzy z możliwych działań odnoszą się do App Context:

Zaktualizuj użytkownika za pomocą PubNub Illuminate

Umożliwia ustawienie dowolnych predefiniowanych lub niestandardowych metadanych użytkownika. Poniższy zrzut ekranu pokazuje użytkownika o identyfikatorze 123, którego status został ustawiony na statyczną wartość "Nowy status", ale możliwe jest również ustawienie wartości dynamicznej w oparciu o warunek, który wyzwolił akcję.

Kanał aktualizacji z PubNub Illuminate

Umożliwia ustawienie dowolnych predefiniowanych lub niestandardowych metadanych kanału. Poniższy zrzut ekranu pokazuje kanał o identyfikatorze 123, którego nazwa została ustawiona na wartość statyczną "Nowa nazwa", ale możliwe jest również ustawienie wartości dynamicznej na podstawie warunku, który wyzwolił akcję.

Aktualizacja członkostwa za pomocą PubNub Illuminate

Umożliwia ustawienie dowolnych predefiniowanych lub niestandardowych metadanych członkostwa. Poniższy zrzut ekranu pokazuje członkostwo użytkownika o identyfikatorze 123 w kanale 123, którego status został ustawiony na wartość statyczną "Nowy status". Możliwe jest również ustawienie wartości dynamicznej w oparciu o warunek, który wyzwolił akcję.

Kontekst aplikacji i funkcje PubNub

PubNub udostępnia funkcje do przechwytywania zdarzeń zachodzących na platformie PubNub. Funkcje pozwalają pisać kod lub wykorzystywać istniejące integracje do przekształcania, przekierowywania, rozszerzania, filtrowania, a nawet agregowania danych. Więcej informacji na temat funkcji PubNub można znaleźć w dokumentacji Fun ctions, ale w tym artykule omówimy, w jaki sposób funkcje PubNub odnoszą się do App Context.

Aktualizacja App Context z poziomu PubNub Functions

Środowisko, w którym uruchamiane są funkcje, ma dostęp do modułu PubNub; moduł ten ma pełny dostęp do App Context na zestawie kluczy, a poniżej podano kilka przykładów zaczerpniętych z dokumentacji. :

Przykład dla Get User App Context Metadata

export default (event) => {
  const pubnub = require('pubnub');

  return pubnub.objects.getUUIDMetadata({
    uuid: 'my-uuid',
    include: {
      customFields: false,
    },
  })
  .then((resp) => {
    console.log(resp);
    return event.ok('Fetched UUID metadata successfully.');
  })
  .catch((err) => {
    console.log(err);
    return event.abort('Failed to fetch UUID metadata');
  });
};

Przykład dla Set Channel App Context Metadata

export default (event) => {
  const pubnub = require('pubnub');

  return pubnub.objects.setChannelMetadata({
    channel: 'my-channel',
    data: {
      name: 'channel-name',
      description: 'What a great channel',
      custom: {
        foo: 'bar',
      },
    },
    include: {
      customFields: false,
    },
  })
  .then((resp) => {
    console.log(resp);
    return event.ok('Set channel metadata successfully.');
  })
  .catch((error) => {
    console.log(err);
    return event.abort('Failed to set channel metadata.');
  });
};

Wyczerpujący zestaw przykładów kodu można znaleźć w dokumentacji modułu PubNub.

Wyzwalanie funkcji PubNub po zmianie kontekstu aplikacji

Istnieje wiele typów zdarzeń, które mogą wyzwalać funkcję, jak wyszczególniono w dokumentacji typów zdarzeń. Obejmują one możliwość wykrywania, kiedy wysyłane są wiadomości i sygnały, wyzwalania funkcji po wystąpieniu zdarzeń obecności oraz wykonywania funkcji w określonych odstępach czasu lub na żądanie. W chwili pisania tego tekstu nie jest możliwe wykonywanie funkcji po aktualizacji kontekstu aplikacji, ale jeśli okaże się, że Twoja aplikacja tego potrzebuje, skontaktuj się z naszym zespołem pomocy technicznej, który z przyjemnością omówi Twoje przypadki użycia.

Następne kroki

Aby zobaczyć App Context w akcji, możesz sprawdzić nasze Chat Demo, które wykorzystuje App Context wraz z naszym Chat SDK, aby pokazać, jak może wyglądać aplikacja czatu z bezserwerową pamięcią masową. Demo czatu pozwala ustawić metadane użytkownika i kanału oraz zobaczyć, jak zmiany te są propagowane do innych słuchaczy i członków w czasie rzeczywistym.

Zapoznaj się również z naszą powiązaną 3-częściową serią na temat przestrzeni roboczej BizOps, która zależy od App Context i obejmuje: Zarządzanie użytkownikami i kanałami, Monitorowanie i moderowanie konwersacji oraz Bezpieczne moderowanie czatu.

Na koniec zachęcamy do skontaktowania się z zespołem DevRel pod adresem devrel@pubnub.com lub skontaktowania się z naszym zespołem pomocy technicznej w celu uzyskania pomocy w dowolnym aspekcie rozwoju PubNub.

Jak PubNub może ci pomóc?

Ten artykuł został pierwotnie opublikowany na PubNub.com

Nasza platforma pomaga programistom tworzyć, dostarczać i zarządzać interaktywnością w czasie rzeczywistym dla aplikacji internetowych, aplikacji mobilnych i urządzeń IoT.

Podstawą naszej platformy jest największa w branży i najbardziej skalowalna sieć komunikacyjna w czasie rzeczywistym. Dzięki ponad 15 punktom obecności na całym świecie obsługującym 800 milionów aktywnych użytkowników miesięcznie i niezawodności na poziomie 99,999%, nigdy nie będziesz musiał martwić się o przestoje, limity współbieżności lub jakiekolwiek opóźnienia spowodowane skokami ruchu.

Poznaj PubNub

Sprawdź Live Tour, aby zrozumieć podstawowe koncepcje każdej aplikacji opartej na PubNub w mniej niż 5 minut.

Rozpocznij konfigurację

Załóż konto PubNub, aby uzyskać natychmiastowy i bezpłatny dostęp do kluczy PubNub.

Rozpocznij

Dokumenty PubNub pozwolą Ci rozpocząć pracę, niezależnie od przypadku użycia lub zestawu SDK.

Informacje o wersji dokumentacji - czerwiec 2024 r.

PubNub Developer Relations — Mon, 08 Jul 2024 12:36:46 +0000

Ten artykuł został pierwotnie opublikowany na stronie https://www.pubnub.com/docs/release-notes/2024/june

Cześć! W tym miesiącu mamy dla Ciebie kilka nowych aktualizacji.

Wprowadziliśmy nową flagę integralności referencyjnej, która pomaga zachować spójność danych.
Limity grup kanałów można teraz ustawiać bezpośrednio z portalu administracyjnego.
Spróbuj zaimportować dane z Insights do BizOps, aby przetestować jego funkcje.
Ponadto zauważysz odświeżony wygląd i sposób działania Presence Management.

Poza tym wprowadziliśmy kilka drobnych, ale znaczących ulepszeń w dokumentacji, które, miejmy nadzieję, odpowiedzą na niektóre pytania lub rozwieją wszelkie wątpliwości podczas pracy z PubNub.

Miłego odkrywania i dziękujemy za bycie częścią naszej społeczności!

Ogólne 🛠️

Pola niestandardowe w ładunkach FCM

Typ: Ulepszenie

Poprawiliśmy dokumentację dla Android Mobile Push Notifications, dodając brakujące niestandardowe parametry PubNub, które można dodać do ładunku FCM Mobile Push Notification: pn_debug, pn_exceptions i pn_dry_run.

Umożliwiają one testowanie lub debugowanie powiadomień oraz wykluczanie wybranych urządzeń z otrzymywania powiadomień.

Oto przykładowy ładunek FCM z naszymi niestandardowymi polami:

{
  "pn_fcm": {
    "notification": {
      "title": "My Title",
      "body": "Message sent at"
 },
    "pn_collapse_id": "collapse-id",
    "pn_exceptions": [
      "optional-excluded-device-token1"
 ]
 },
  "pn_debug": true,
  "pn_dry_run": false
}

Limity grupy kanałów

Typ: Nowa funkcja

Kontroler strumienia w portalu administracyjnym ma nową, konfigurowalną opcję limitu grupy kanałów dla klientów korzystających z płatnych planów cenowych, która pozwala ustawić limity maksymalnej liczby kanałów, które mogą mieć grupy kanałów w zestawie kluczy. Można obniżyć domyślny limit 1000 kanałów lub zwiększyć go do 2000 kanałów.

Zdarzenia metadanych użytkownika w kontekście aplikacji

Typ: Ulepszenie

Poprawiliśmy dokumentację, aby wyjaśnić, że przy włączonej opcji User Metadata Events każda modyfikacja jednostki użytkownika(ustawienie i usunięcie) powoduje wysłanie powiadomień o zdarzeniach do wszystkich stowarzyszeń członkowskich, a więc zarówno tego użytkownika, jak i każdego kanału, którego jest członkiem. Szczegółowe informacje można znaleźć w dokumentacji.

Zależność konfiguracji App Context

Typ: Ulepszenie

Zaktualizowaliśmy dokumentację dotyczącą opcji konfiguracji App Context, aby uwzględnić informacje o krytycznej zależności.

Chociaż opcje Disallow Get All Channel Metadata i Disallow Get All User Metadata wydają się dość oczywiste, zastrzeżenie polega na tym, że opcje te działają tylko z włączonym Menedżerem dostępu.

Innymi słowy, bez Menedżera dostępu te aktywne opcje nie wyłączają pobierania metadanych o użytkownikach lub kanałach na zestawie klawiszy. Jednocześnie po włączeniu Menedżera dostępu, który domyślnie ogranicza dostęp do wszystkich obiektów w zestawie kluczy, można łatwo ominąć ograniczenia GET Menedżera dostępu dla użytkowników i kanałów, usuwając zaznaczenie obu tych opcji konfiguracji bez tworzenia szczegółowego schematu uprawnień.

Interfejs użytkownika portalu administracyjnego wkrótce również odzwierciedli tę zależność.

Nowa flaga integralności referencyjnej w App Context

Typ: Nowa funkcja

Dodaliśmy nową opcję Wymuś integralność referencyjną dla członkostwa, która jest domyślnie włączona po włączeniu App Context w zestawie kluczy aplikacji w portalu administracyjnym.

Flaga ta zapewnia, że można ustawić nowe członkostwo tylko wtedy, gdy istnieje zarówno identyfikator użytkownika, jak i identyfikator kanału, dla którego utworzono członkostwo. Jednocześnie usunięcie nadrzędnej jednostki metadanych użytkownika lub kanału automatycznie usuwa wszelkie podrzędne skojarzenia członkostwa dla tej usuniętej jednostki. W ten sposób można upewnić się, że w zestawie kluczy nie ma nieprawidłowo działających lub osieroconych obiektów członkowskich.

SDK 📦

Ulepszenia dokumentacji Python

Typ: Ulepszenie

Po otrzymaniu informacji zwrotnych rozszerzyliśmy informacje na temat użycia i wykonywania metod. W rezultacie każda sekcja Returns w dokumentacji Python SDK opisuje teraz pola danych zwracane przez każdą metodę. Wyjaśnia również, w jaki sposób wykonanie żądania synchronicznego (.sync()) i asynchronicznego (.pn_async(callback)) wpływa na zwracane dane dla każdej metody.

React SDK został przestarzały

Typ: Powiadomienie o deprecjacji

Ponieważ od jakiegoś czasu nie rozwijamy aktywnie React SDK, zdecydowaliśmy się w końcu oficjalnie zdeprecjonować jego dokumentację i przenieść ją do sekcji Call For Contributions w naszych dokumentach.

Jeśli znajdziesz błąd w React SDK lub chcesz rozszerzyć jego funkcjonalność, możesz utworzyć pull request w repozytorium i poczekać na naszą opinię!

Funkcje

Eksportowanie logów funkcji poprzez zdarzenia i akcje

Typ: Nowa funkcja

Każda funkcja PubNub zapisuje logi w wewnętrznym kanale blocks-output-*, takim jak blocks-output-NSPiAuYKsWSxJl4yBn30, który może przechowywać do 250 wierszy logów, zanim nowe je nadpiszą. Jeśli nie chcesz stracić starych dzienników, możesz teraz użyć funkcji Events & Actions, aby wyeksportować te dzienniki do usługi zewnętrznej.

Insights 📊

Czas trwania użytkownika i metryki urządzeń w dokumentacji interfejsu API REST

Typ: Ulepszenie

W zeszłym miesiącu wprowadziliśmy metryki urządzeń do pulpitu nawigacyjnego Zachowanie użytkownika w PubNub Insights na portalu administratora. W tym miesiącu zaktualizowaliśmy dokumentację interfejsu API R EST, aby uwzględnić zarówno czas trwania użytkownika, jak i metryki urządzenia, dzięki czemu można bezpośrednio wywołać interfejs API PubNub Insights, aby uzyskać interesujące metryki.

BizOps Workspace 🏢

Top 20 użytkowników/kanałów

Typ: Nowa funkcja

Jeśli nie używasz App Context do przechowywania i zarządzania użytkownikami i kanałami, nadal możesz przetestować powiązane funkcje BizOps Workspace, importując dane testowe.

Jeśli masz dostęp do PubNub Insights, możesz uzyskać do niego dostęp, przechodząc do modułów User Management i Channel Management w BizOps Workspace w Admin Portal i klikając przycisk Import from Insights.

W rezultacie zaimportujesz z zestawu kluczy aplikacji maksymalnie 20 użytkowników, którzy opublikowali największą liczbę wiadomości w ciągu ostatniego dnia (jeśli wczoraj nie wysłano żadnych wiadomości, użytkownicy zostaną zaimportowani na podstawie danych z poprzedniego dnia).

Podobnie jak w przypadku użytkowników, można zaimportować z zestawu kluczy aplikacji do 20 kanałów z największą liczbą wiadomości opublikowanych w ciągu ostatniego dnia.

Użyj tych danych testowych, aby poznać możliwości BizOps Workspace.

Odświeżony interfejs zarządzania obecnością

Typ: Ulepszenie

Niedawno przeprojektowaliśmy cały moduł zarządzania obecnością w BizOps Workspace, aby uprościć kreator tworzenia reguł, zmienić kolory odznak na bardziej integracyjne i dodać konfigurację wzorca "catch all", która odzwierciedla domyślną konfigurację "włącz obecność na wszystkich kanałach" konfiguracji obecności w zestawie kluczy.

Mamy nadzieję, że spodoba ci się jego nowy wygląd!

Informacje o wersji dokumentacji - maj 2024 r.

PubNub Developer Relations — Mon, 08 Jul 2024 10:47:14 +0000

Witamy w informacjach o wydaniu z tego miesiąca! PubNub przynosi pakiet aktualizacji zaprojektowanych w celu usprawnienia pracy i dodania szczypty wygody.

Co zawiera pakiet?

Ujednoliciliśmy dokumentację filtrowania danych App Context, zmodernizowaliśmy architekturę listenera zdarzeń dla Pythona i Asyncio oraz dodaliśmy nowe narzędzia, które mają pomóc w rozpoczęciu bezpiecznego moderowania czatów.

Na froncie portalu administracyjnego ulepszyliśmy naszą grę dzięki szczegółowym wskaźnikom urządzeń, usprawniliśmy zarządzanie zdarzeniami dzięki opcjom grupowania i kopertowania oraz wprowadziliśmy nowe, eleganckie, skumulowane wykresy słupkowe i zmienne funkcje w Illuminate.

Ponadto nasze dokumenty i strona internetowa mają teraz nową wyszukiwarkę ze sztuczną inteligencją, która pomoże Ci znaleźć dokładnie to, czego potrzebujesz.

Zanurz się i odkryj te smakołyki!

Ogólne🛠️

Ujednolicone informacje na temat filtrowaniadanych App Context

Typ: Ulepszenie

Opis: Na podstawie informacji zwrotnych przejrzeliśmy i ujednoliciliśmy informacje z różnych zestawów SDK na temat filtrowania danych użytkowników, kanałów i członkostwa za pomocą interfejsu API App Context PubNub. W rezultacie stworzyliśmy jeden dokument App Context Filtering (poparty licznymi przykładami), który służy jako punkt wejścia dla wszelkich zapytań dotyczących filtrowania danych.

Dowiedz się:

Które dane użytkownika, kanału i członkostwa można filtrować.
Których operatorów filtrowania użyć.
Jak filtrować dane na praktycznych przykładach.

   pubnub.objects.getAllChannelMetadata({
       filter: '["description"] LIKE "*support*"'
   })

SDK📦

Zaktualizowana architektura detektorów zdarzeń dla Python i Asyncio

Typ: Nowa funkcja

Opis: Nowa architektura detektorów zdarzeń dla pakietów SDK Python i Asyncio wprowadza bardziej zawężone sposoby zarządzania subskrypcjami i nasłuchiwania zdarzeń w porównaniu z poprzednim monolitycznym obiektem PubNub.

Podczas gdy obiekt PubNub nadal służy jako zakres globalny i pozostaje kompatybilny wstecz, nowa architektura oferuje obiekty "entity", takie jak kanały, grupy kanałów, metadane użytkowników i metadane kanałów, które zwracają obiekty Subscription.

Subskrypcje te pozwalają na metody subskrypcji/rezygnacji z subskrypcji oraz metody addListener/removeListener specyficzne dla pojedynczych jednostek, oferując bardziej elastyczny i niezależny sposób zarządzania zdarzeniami w czasie rzeczywistym i zmniejszając potrzebę globalnego zarządzania stanem.

# entity-based, local-scoped
subscription = pubnub.channel(f'{channel}').subscription(with_presence: bool = False)

Chat💬

Przykład bezpiecznej moderacji w Chat SDK

Typ: Nowa funkcja

Opis: Nasz zespół ds. czatu stworzył prostą usługę API Access Manager, aby pomóc w zrozumieniu kompleksowego scenariusza zabezpieczania aplikacji Chat SDK za pomocą Access Managera. Ta usługa makietuje prosty punkt końcowy i zawiera przykładowy zestaw uprawnień, którego można użyć do skonfigurowania autoryzacji po stronie serwera dla aplikacji Chat SDK z włączonym Menedżerem dostępu.

Przejdź przez cały scenariusz testowy, korzystając z naszej aplikacji React Native Chat App (do interakcji z użytkownikiem), Channel Monitor (do moderowania użytkowników, takich jak wyciszanie i banowanie) oraz Access Manager API (do generowania tokenów autoryzacyjnych).

Szczegółowe kroki można znaleźć na blogu How to Securely Moderate Chat and Users with BizOps Workspace.

Insights📊

Pulpit nawigacyjny metryk urządzeń

Typ: Ulepszenie

Opis: Rozszerzyliśmy pulpit nawigacyjny Zachowanie użytkowników we Wnioskach o metryki typu urządzenia. Pozwala to na dogłębne zbadanie zachowania użytkowników w zależności od typu urządzenia. Od teraz możesz obserwować, gdzie użytkownicy aplikacji publikują lub subskrybują najczęściej (iOS, Android i Windows) i sprawdzać liczbę unikalnych użytkowników według typu urządzenia.

Ten wgląd może pomóc w tworzeniu niestandardowych funkcji według urządzenia, a tym samym poprawić jakość obsługi klienta.

Zdarzenia i akcje⚡

Akcja Webhook obsługuje teraz grupowanie

Typ: Ulepszenie

Opis: Funkcja Batching w Events & Action pozwala zarządzać dużą liczbą zdarzeń, wysyłając je w jednym żądaniu, zamiast wysyłać każde zdarzenie osobno. Ta funkcja jest również dostępna dla typu akcji Webhook od maja.

(Un)enveloping

Typ: Ulepszenie

Opis: Można teraz zawinąć ładunek każdej akcji w kopertę, tj. wybrać, czy schemat ładunku powinien zawierać szczegółowe metadane JSON zdarzeń i akcji. Może to być pomocne w przypadkach, gdy chcesz użyć metadanych poza ładunkiem, takich jak informacje o kanale, do którego wysłano ładunek lub słuchaczu, który go wyzwolił.

Illuminate💡

Skumulowane wykresy słupkowe

Typ: Nowa funkcja

Opis: Oprócz wykresów słupkowych i liniowych, Illuminate Dashboards oferuje teraz nowy typ wykresu słupkowego sk umulowanego, który poprawia czytelność danych, gdy na jednym wykresie znajduje się wiele wymiarów i wartości.

Zmienne

Typ: Ulepszenie

Opis: Podczas tworzenia akcji w Decisions (określających, co chcesz zrobić z zebranymi metrykami), możesz dodawać zmienne w tabelach konfiguracji akcji, aby kontrolować i dynamicznie zmieniać to, do czego się odnoszą. Zmiennych można używać bardziej elastycznie - odwołując się do wstępnie zdefiniowanych warunków (wpisz${ ) i wybierz z listy) lub konfigurując nowe zmienne(${zmienna}) na bieżąco. Zmienne są teraz dostępne dla większości pól akcji, nie tylko w polu Payload lub Body akcji.

Ulepszonepola mapowania danych

Typ: Ulepszenie

Opis: Podczas tworzenia obiektu biznesowego i definiowania miar (jakie dane chcesz śledzić) lub wymiarów (aby segmentować to, co śledzisz), musisz zmapować nazwy pól do rzeczywistych pól w ładunku, aby poinformować Illuminate, gdzie należy szukać tych danych. Do tej pory konieczne było ręczne wprowadzenie dokładnego mapowania konkretnego pola ładunku. Od maja Illuminate oferuje bardziej przyjazne dla użytkownika menu rozwijane, aby zlokalizować dokładną lokalizację danych Publish i App Context.

Inne🌟

Nowe wyszukiwanie iasystent AI

Typ: Nowa funkcja

Opis: Na koniec, ale zdecydowanie nie mniej ważne, zamieniliśmy wyszukiwanie Algolia w naszych dokumentach na nowe połączone wyszukiwanie i asystenta AI, aby przygoda z nauką PubNub była bardziej dokładna i interaktywna.

Czas podnieść poziom swojej gry w kodowanie i zaprzyjaźnić się z naszym nowym asystentem AI i funkcją wyszukiwania. Będziemy ją udoskonalać w oparciu o Twoje opinie, więc jeśli czegoś brakuje, na pewno to zaktualizujemy. Miłego kodowania! 🚀

Przegląd technologii strumieniowego przesyłania danych

PubNub Developer Relations — Mon, 08 Jul 2024 09:40:21 +0000

Zdolność do przetwarzania dużych ilości danych (big data) w czasie rzeczywistym stała się kluczowa dla wielu organizacji i właśnie w tym miejscu pojawiają się technologie strumieniowego przesyłania danych. Technologie te pozwalają na przetwarzanie dużych ilości danych w czasie rzeczywistym lub zbliżonym do rzeczywistego w momencie ich generowania, umożliwiając firmom uzyskanie natychmiastowego wglądu i podejmowanie decyzji opartych na danych.

Sercem tych technologii jest koncepcja strumieni danych, znanych również jako strumienie zdarzeń. Strumienie danych to sekwencje generowane przez różne źródła, takie jak kanały mediów społecznościowych, urządzenia Internetu rzeczy (IoT), pliki dziennika, zestawy danych naukowych i inne. Te strumienie danych są następnie pozyskiwane i przetwarzane przez technologie strumieniowego przesyłania danych.

Kolejnym ważnym aspektem jest skalowalność strumieni danych. Wraz ze wzrostem ilości danych, technologie mogą skalować się w celu obsługi zwiększonego obciążenia, zapewniając firmom możliwość zbierania danych analitycznych w czasie rzeczywistym. Oznacza to, że firmy mogą analizować swoje dane w miarę ich generowania, umożliwiając im podejmowanie szybkich decyzji, szczególnie przydatnych w scenariuszach, w których ważny jest czas, takich jak wykrywanie oszustw lub optymalizacja obsługi klienta.

Technologie strumieniowego przesyłania danych obsługują różne formaty, od danych strukturalnych, takich jak bazy danych SQL, po dane nieustrukturyzowane, takie jak wydarzenia na żywo lub kanały mediów społecznościowych; zapewnia to firmom możliwość przetwarzania i analizowania wszystkich rodzajów danych, niezależnie od ich źródła lub formatu. Należy zauważyć, że chociaż technologie te oferują wiele korzyści, wiążą się z nimi również wyzwania; na przykład wymagają zaawansowanych umiejętności inżynierii danych do wdrożenia i zarządzania, wymagając niskiego opóźnienia i wysokiej przepustowości, szczególnie w przypadku obsługi dużych ilości danych.

Podstawowe koncepcje technologii strumieniowego przesyłania danych

Technologie strumieniowego przesyłania danych opierają się na kilku podstawowych koncepcjach. Zrozumienie tych pojęć ma kluczowe znaczenie dla pełnego wykorzystania możliwości przetwarzania danych w czasie rzeczywistym:

Strumienie danych

Strumienie danych to ciągłe przepływy danych z różnych źródeł, takich jak urządzenia IoT, pliki dziennika, giełdy itp. Te źródła danych generują dane z dużą prędkością, często w czasie rzeczywistym lub prawie w czasie rzeczywistym, a generowane dane są zazwyczaj wrażliwe na czas, co oznacza, że ich znaczenie maleje z czasem.

Przetwarzanie strumieniowe

Przetwarzanie strumieniowe to przetwarzanie strumieni danych w czasie rzeczywistym. W przeciwieństwie do przetwarzania wsadowego, które przetwarza dane w zaplanowanych odstępach czasu, przetwarzanie strumieniowe obsługuje dane natychmiast po ich nadejściu. Zapewnia to niskie opóźnienia, co jest niezbędne w przypadku aplikacji wrażliwych na czas, takich jak śledzenie pozycji użytkownika lub cen towarów i podejmowanie decyzji na podstawie tych wartości.

Przetwarzanie wsadowe a przetwarzanie strumieniowe

Przetwarzanie wsadowe i przetwarzanie strumieniowe reprezentują dwa różne podejścia do przetwarzania danych. Przetwarzanie wsadowe obsługuje duże ilości danych jednocześnie, w zaplanowanych odstępach czasu i jest odpowiednie do zadań analizy danych niewrażliwych na czas. Z drugiej strony, przetwarzanie strumieniowe obsługuje dane natychmiast po ich wygenerowaniu, zapewniając wgląd w czasie rzeczywistym.

Mówiąc o przetwarzaniu strumieniowym danych, można również spotkać się z terminem "micro-batch" - podejście to znajduje się pomiędzy przetwarzaniem wsadowym i strumieniowym, gdy potrzebne są bardzo świeże dane, ale niekoniecznie w czasie rzeczywistym.

Architektura strumieniowego przesyłania danych

Typowa architektura technologii strumieniowego przesyłania danych obejmuje źródła danych, systemy pozyskiwania danych, systemy przetwarzania strumieniowego i systemy przechowywania danych.

Źródła danych generują strumienie danych.
Systemy pozyskiwania danych, takie jak Apache Kafka lub Amazon Kinesis, przechwytują te strumienie danych do przetwarzania.
Procesor strumieniowy, taki jak Apache Flink lub Apache Spark Streaming, przetwarza pozyskane dane w czasie rzeczywistym.
Przetworzone dane są następnie przechowywane w jeziorach danych lub hurtowniach danych w celu dalszej analizy lub wizualizacji pulpitów nawigacyjnych.
Dane mogą być przesyłane strumieniowo do brzegu sieci bezpośrednio przy użyciu systemów takich jak PubNub Kafka Bridge

Dane przepływają przez architekturę od źródła do miejsca docelowego w potokach danych. Zasadniczo potoki danych reprezentują podróż danych od punktu ich pochodzenia, poprzez pozyskiwanie, przetwarzanie, a na końcu przechowywanie lub wizualizację.

Spójność danych

Spójność danych jest istotnym zagadnieniem w strumieniowym przesyłaniu danych. Technologie strumieniowego przesyłania danych wykorzystują różne techniki, takie jak porządkowanie zdarzeń, przetwarzanie dokładnie raz i odporność na błędy w celu zapewnienia spójności. Techniki te zapewniają, że dane są przetwarzane we właściwej kolejności, żadne dane nie są tracone lub przetwarzane wielokrotnie, a system może odzyskać sprawność po awarii bez utraty danych.

Na przykład PubNub oferuje kilka sposobów gwarantowania dostarczania wiadomości, takich jak potwierdzenia odczytu, porządkowanie wiadomości i kolejkowanie.

Narzędzia dla technologii strumieniowego przesyłania danych

Dostępne są różne narzędzia open-source i komercyjne do wdrażania technologii strumieniowego przesyłania danych. Należą do nich Apache Kafka, Apache Flink, AWS Kinesis i Microsoft Azure Stream Analytics. Każde narzędzie ma swoje mocne strony i przypadki użycia, a wybór narzędzia zależy od konkretnych wymagań aplikacji do strumieniowego przesyłania danych.

Kolejne kroki z PubNub Data Streaming

Po zrozumieniu podstawowych pojęć i architektury technologii strumieniowego przesyłania danych, kolejnym krokiem jest wdrożenie tych technologii we własnych systemach. PubNub zapewnia solidną i skalowalną platformę strumieniowego przesyłania danych w czasie rzeczywistym, którą można łatwo zintegrować z istniejącą architekturą.

Oto kroki, które należy wykonać, aby rozpocząć pracę z PubNub Data Streaming:

Explore Demos: PubNub udostępnia wersję demonstracyjną strumieniowego przesyłania danych w czasie rzeczywistym, która pomaga zrozumieć, jak działa nasza platforma. Ta wersja demonstracyjna ma zastosowanie do szerokiego zakresu przypadków użycia, od aplikacji czatu po sterowanie urządzeniami IoT.
Poznaj podstawy: PubNub udostępnia obszerny glosariusz opisujący kluczowe terminy i pojęcia, w tym wpis dotyczący strumieniowego przesyłania danych.
Zrozumieć PubNub Illuminate: Dzięki PubNub Illuminate możesz na bieżąco dostosowywać strategie monetyzacji, łączyć zachowania użytkowników z zachętami, śledzić każde działanie za pomocą niestandardowych, zagregowanych danych w czasie rzeczywistym i urządzeń oraz natychmiast widzieć wyniki - a wszystko to bez obciążania zespołu programistów.
Rejestracja: Zarejestruj konto PubNub. Można to zrobić na stronie rejestracji. Darmowa warstwa konta PubNub ma duże limity i nie wymaga karty kredytowej, dopóki nie będziesz gotowy do aktualizacji.
Zacznij tworzyć: Gdy już opanujesz podstawy, zacznij tworzyć własne aplikacje do strumieniowego przesyłania danych. PubNub udostępnia wiele samouczków, które poprowadzą cię przez tworzenie różnych typów aplikacji, w tym samouczek dotyczący tworzenia aplikacji do strumieniowego przesyłania danych w czasie rzeczywistym.
Poznaj interfejsy API: PubNub zapewnia szeroką gamę interfejsów API i zestawów SDK, które można wykorzystać do tworzenia aplikacji. Więcej informacji można znaleźć na naszej stronie dokumentacji SDK.
Poznaj ceny: Przed zakończeniem tworzenia aplikacji warto wiedzieć, ile to będzie kosztować. Więcej informacji na temat cen PubNub można znaleźć na stronie z cennikiem.

Głębsze spojrzenie na przypadki użycia technologii strumieniowego przesyłania danych

Analiza danych w czasie rzeczywistym

Jednym z głównych zastosowań technologii strumieniowego przesyłania danych jest analiza danych w czasie rzeczywistym. Przetwarzając i analizując strumienie danych w czasie rzeczywistym, firmy mogą uzyskać natychmiastowy wgląd w swoje operacje i podejmować szybkie, świadome decyzje. Może to być szczególnie przydatne w branżach takich jak finanse, gdzie analiza danych w czasie rzeczywistym może być wykorzystywana do wykrywania oszustw, analizy trendów rynkowych i nie tylko.

PubNub Illuminate jest przykładem platformy analitycznej działającej w czasie rzeczywistym. PubNub Illuminate jest jednak czymś więcej niż tylko platformą do zarządzania danymi, pozwala również definiować warunki w oparciu o metryki danych, które po uruchomieniu wykonają dynamiczne działania w oparciu o te dane.

Internet rzeczy (IoT)

Innym ważnym zastosowaniem technologii strumieniowego przesyłania danych jest Internet rzeczy (IoT), w którym urządzenia generują strumienie danych, które mogą być przetwarzane w czasie rzeczywistym w celu zapewnienia cennych informacji. Na przykład monitorowanie wydajności urządzeń przemysłowych umożliwia firmom wykrywanie i rozwiązywanie problemów, zanim doprowadzą one do awarii sprzętu.

Analiza mediów społecznościowych

Platformy mediów społecznościowych generują ogromne ilości danych w każdej sekundzie, a technologie strumieniowego przesyłania danych mogą przetwarzać te dane w czasie rzeczywistym, umożliwiając firmom monitorowanie trendów, śledzenie nastrojów klientów i natychmiastowe reagowanie na opinie klientów.

Handel elektroniczny

W branży e-commerce technologie strumieniowego przesyłania danych mogą śledzić zachowania klientów w czasie rzeczywistym, umożliwiając firmom dostarczanie spersonalizowanych rekomendacji, poprawę doświadczeń klientów i zwiększenie sprzedaży.

Przyszłe trendy w technologiach strumieniowego przesyłania danych

Integracja z uczeniem maszynowym i sztuczną inteligencją

Jednym ze znaczących trendów w technologiach strumieniowego przesyłania danych jest integracja uczenia maszynowego i generatywnej sztucznej inteligencji. Modele uczenia maszynowego mogą być dostarczane z danymi w czasie rzeczywistym potrzebnymi do dokonywania dokładnych i terminowych prognoz. Może to być szczególnie przydatne w konserwacji predykcyjnej, gdzie modele uczenia maszynowego mogą przewidywać awarie części na podstawie danych w czasie rzeczywistym - na przykład cykle rozładowania baterii urządzenia mobilnego mogą być wykorzystane do oszacowania oczekiwanej żywotności baterii.

Zwiększone wykorzystanie frameworków open source

Struktury open-source, takie jak Apache Kafka, Apache Flink i Spark Streaming, stały się popularnymi narzędziami do wdrażania technologii strumieniowego przesyłania danych. Struktury te oferują solidne możliwości przetwarzania dużych ilości danych w czasie rzeczywistym, a ich charakter open-source sprawia, że są wysoce konfigurowalne i można je dostosować do różnych przypadków użycia. Spodziewamy się zwiększonego wykorzystania tych i innych frameworków open-source w przyszłości.

Większy nacisk na bezpieczeństwo i prywatność danych

Ponieważ firmy w coraz większym stopniu polegają na technologiach strumieniowego przesyłania danych w celu przetwarzania danych wrażliwych, większy nacisk będzie kładziony na bezpieczeństwo i prywatność danych. Będzie to wymagało wdrożenia solidnych środków bezpieczeństwa w celu ochrony strumieni danych przed nieautoryzowanym dostępem i zapewnienia zgodności z przepisami dotyczącymi prywatności danych.

Bardziej zaawansowane techniki inżynierii danych

Spodziewamy się bardziej zaawansowanych technik inżynierii danych, w miarę jak inżynierowie będą coraz lepiej zaznajomieni z tymi technologiami, w tym bardziej wyrafinowanych algorytmów przetwarzania strumieni, optymalizacji potoków danych i zapewniania spójności danych.

Podsumowanie

Przyszłość technologii strumieniowego przesyłania danych rysuje się w jasnych barwach. Zapewniając firmom lepszy wgląd w działalność operacyjną w czasie rzeczywistym, mogą one podejmować natychmiastowe działania bez konieczności polegania na danych historycznych, zwiększając zadowolenie klientów, wydajność i rentowność. Niezależnie od branży, czy jest to zarządzanie klientami, handel elektroniczny, IoT czy analiza mediów społecznościowych, technologie strumieniowego przesyłania danych mogą potencjalnie zmienić sposób działania firm.

PubNub może pomóc w przekształceniu firmy dzięki strumieniowemu przesyłaniu danych. Zachęcamy do skontaktowania się z zespołem DevRel pod adresem devrel@pubnub.com lub z naszym zespołem pomocy technicznej w celu uzyskania pomocy w dowolnym aspekcie rozwoju PubNub.

Jak PubNub może ci pomóc?

Ten artykuł został pierwotnie opublikowany na PubNub.com

Nasza platforma pomaga programistom tworzyć, dostarczać i zarządzać interaktywnością w czasie rzeczywistym dla aplikacji internetowych, aplikacji mobilnych i urządzeń IoT.

Fundamentem naszej platformy jest największa w branży i najbardziej skalowalna sieć przesyłania wiadomości w czasie rzeczywistym. Dzięki ponad 15 punktom obecności na całym świecie obsługującym 800 milionów aktywnych użytkowników miesięcznie i niezawodności na poziomie 99,999%, nigdy nie będziesz musiał martwić się o przestoje, limity współbieżności lub jakiekolwiek opóźnienia spowodowane skokami ruchu.

Poznaj PubNub

Sprawdź Live Tour, aby zrozumieć podstawowe koncepcje każdej aplikacji opartej na PubNub w mniej niż 5 minut.

Rozpocznij konfigurację

Załóż konto PubNub, aby uzyskać natychmiastowy i bezpłatny dostęp do kluczy PubNub.

Rozpocznij

Dokumenty PubNub pozwolą Ci rozpocząć pracę, niezależnie od przypadku użycia lub zestawu SDK.

Moderacja czatu za pomocą OpenAI

PubNub Developer Relations — Wed, 03 Jul 2024 15:17:47 +0000

Każda aplikacja zawierająca czat w aplikacji musi w jakiś sposób regulować i moderować wiadomości, które użytkownicy mogą wymieniać. Ponieważ nie jest możliwe moderowanie wszystkich nieodpowiednich treści za pomocą ludzkich moderatorów, system moderacji musi być automatyczny. Ponieważ użytkownicy często próbują obejść moderację, uczenie maszynowe, generatywna sztuczna inteligencja i duże modele językowe (LLM) [oraz modele GPT, takie jak GPT-3 i GPT-4] są popularnymi sposobami moderowania treści.

Moderacja to złożony temat, a PubNub oferuje różne rozwiązania spełniające wszystkie przypadki użycia naszych deweloperów.

Funkcje PubNub mogą przechwytywać i modyfikować wiadomości, zanim dotrą one do miejsca docelowego. W ramach funkcji można stosować niestandardową logikę, w tym wywoływanie zewnętrznego interfejsu API REST, co pozwala na korzystanie z dowolnej zewnętrznej usługi do moderowania wiadomości. To podejście zostało wykorzystane w tym artykule do integracji z OpenAI.
Funkcje PubNub oferują niestandardowe integracje, które obsługują moderację treści i analizę nastrojów, w tym Lasso Moderation, Tisane, filtr wulgaryzmów oparty na RegEx, Lexalytics i Community Sift.
BizOps Workspace firmy PubNub może monitorować i moderować konwersacje, w tym edytować i usuwać wiadomości.

Punkt końcowy moderowania Open AI

W tym artykule przyjrzymy się OpenAI Moderation API, interfejsowi API REST, który wykorzystuje sztuczną inteligencję (AI) do określenia, czy dostarczony tekst zawiera potencjalnie szkodliwe terminy. Intencją API jest umożliwienie programistom filtrowania lub usuwania szkodliwych treści, a w chwili pisania tego tekstu jest on udostępniany bezpłatnie, choć obsługuje tylko język angielski.

Model stojący za Moderation API będzie kategoryzował dostarczony tekst w następujący sposób (zaczerpnięty z dokumentacji API):

Nienawiść: Treści, które wyrażają, podżegają lub promują nienawiść ze względu na rasę, płeć, pochodzenie etniczne, religię, narodowość, orientację seksualną, niepełnosprawność lub kastę. Nienawistne treści skierowane do grup nieobjętych ochroną (np. szachistów) stanowią nękanie.
Nienawiść / Groźby: Nienawistne treści, które obejmują również przemoc lub poważne obrażenia wobec grupy docelowej w oparciu o rasę, płeć, pochodzenie etniczne, religię, narodowość, orientację seksualną, status niepełnosprawności lub kastę.
Nękanie: Treści, które wyrażają, podżegają lub promują napastliwy język wobec dowolnej grupy docelowej.
Nękanie/groźby: Treści nękające, które obejmują również przemoc lub poważne obrażenia wobec dowolnej osoby.
Samookaleczenie: Treści, które promują, zachęcają lub przedstawiają akty samookaleczenia, takie jak samobójstwo, cięcie się i zaburzenia odżywiania.
Samookaleczenie / zamiar: Treści, w których osoba mówiąca wyraża, że angażuje się lub zamierza angażować się w akty samookaleczenia, takie jak samobójstwo, cięcie się i zaburzenia odżywiania.
Samookaleczenie / Instrukcje: Treści, które zachęcają do dokonywania aktów samookaleczenia, takich jak samobójstwo, cięcie się i zaburzenia odżywiania, lub które zawierają instrukcje lub porady dotyczące popełniania takich aktów.
Seksualne: Treści mające na celu wzbudzenie podniecenia seksualnego, takie jak opisy aktywności seksualnej lub promujące usługi seksualne (z wyłączeniem edukacji seksualnej i dobrego samopoczucia).
Seksualne / Nieletni: Treści o charakterze seksualnym przedstawiające osoby poniżej 18 roku życia.
Przemoc: Treści przedstawiające śmierć, przemoc lub obrażenia fizyczne.
Przemoc / Grafika: Treści przedstawiające śmierć, przemoc lub obrażenia fizyczne w szczegółach graficznych.

Wyniki są dostarczane w strukturze JSON w następujący sposób (ponownie zaczerpnięte z dokumentacji API):

{
  "id": "modr-XXXXX",
  "model": "text-moderation-007",
  "results": [
    {
      "flagged": true,
      "categories": {
        "sexual": false,
        "hate": false,
        "harassment": false,
        "self-harm": false,
        "sexual/minors": false,
        "hate/threatening": false,
        "violence/graphic": false,
        "self-harm/intent": false,
        "self-harm/instructions": false,
        "harassment/threatening": true,
        "violence": true
      },
      "category_scores": {
        //  Out of scope for this article
      }
    }
  ]
}

Wywoływanie Open AI Moderation API z PubNub

Integracja interfejsu API Moderation z dowolną aplikacją PubNub jest łatwa przy użyciu funkcji PubNub, postępując zgodnie z tym samouczkiem krok po kroku:

Funkcje umożliwiają przechwytywanie zdarzeń w czasie rzeczywistym zachodzących na platformie PubNub, takich jak wysyłane i odbierane wiadomości; można następnie napisać niestandardowy kod bezserwerowy w ramach tych funkcji, aby modyfikować, przekierowywać, rozszerzać lub filtrować wiadomości w razie potrzeby.

Będziesz musiał użyć typu zdarzenia "Before Publish or Fire"; ten typ funkcji zostanie wywołany przed dostarczeniem wiadomości i musi zakończyć wykonywanie, zanim wiadomość zostanie zwolniona, aby mogła zostać dostarczona do odbiorców. Dokumentacja PubNub zawiera więcej informacji i szczegółów, ale w skrócie: "Before Publish or Fire" to wywołanie synchroniczne, które może zmienić wiadomość lub jej ładunek.

Tworzenie funkcji PubNub

Zaloguj się do portalu administracyjnego PubNub i wybierz aplikację oraz zestaw kluczy dla aplikacji, którą chcesz moderować.
Wybierz "Functions", które można znaleźć w zakładce "Build".
Wybierz "+ CREATE NEW MODULE" i nadaj modułowi nazwę i opis.
Wybierz "+ CREATE NEW FUNCTION" i nadaj funkcji nazwę.
Jako typ zdarzenia wybierz "Before Publish or Fire".
Jako nazwę kanału wpisz * (w tym demo użyjemy *, ale twoja aplikacja może określić tutaj tylko kanały, które chcesz moderować).

Po utworzeniu funkcji PubNub musisz podać swój klucz API Open AI jako sekret.

Wybierz "MOJE SEKRETY" i utwórz nowy klucz o nazwie "OPENAI_API_KEY".
Wygenerujklucz API Open AI i upewnij się, że klucz ma dostęp do umiarkowanego API.
Podaj wygenerowany klucz API do właśnie utworzonego sekretu funkcji PubNub.

Treść funkcji PubNub będzie wyglądać następująco:

const xhr  = require('xhr');
const vault = require('vault');

export default request => {
  if (request.message && request.message.text)
  {
    let messageText = request.message.text
    return getOpenaiApiKey().then(apiKey => {
      return openAIModeration(messageText).then(aiResponse => {
        //  Append the response to the message
        request.message.openAiModeration = aiResponse;
        //  If the message was harmful, you might also choose to report the message here.
        return request.ok();
      })
    })
  }
  return request.ok();
};

let OPENAI_API_KEY = null;
function getOpenaiApiKey() {
  // Use cached key
  if (OPENAI_API_KEY) {
      return new Promise(resolve => resolve(OPENAI_API_KEY));
  }
  // Fetch key from vault
  return vault.get("OPENAI_API_KEY").then(apikey => {
      OPENAI_API_KEY = apikey;
      return new Promise(resolve => resolve(OPENAI_API_KEY));
  });
}

function openAIModeration(messageText) {
  const url = 'https://api.openai.com/v1/moderations';
  const http_options = {
    'method': 'POST',
    'headers': {
      "Content-Type": "application/json",
      "Authorization": `Bearer ${OPENAI_API_KEY}`,
    },
    'body': JSON.stringify({
      "input": messageText
    }),
    timeout: 9500,
    retries: 0
  };
  return xhr.fetch(url, http_options)
    .then((resp) => {
      const body = JSON.parse(resp.body);
      return body;
    })
    .catch((err) => {
      console.log(err);
      return "Open AI Timed out";
    });
}

Sama funkcja jest dość prosta:

Dla każdej otrzymanej wiadomości:

Przekaż ją do funkcji moderacji Open AI
Dołącz zwrócony obiekt moderacji jako nowy klucz do obiektu Message (JSON).

Zapisz funkcję i upewnij się, że moduł jest uruchomiony.

Opóźnienie

Funkcja PubNub, którą właśnie utworzyłeś, będzie wykonywana synchronicznie za każdym razem, gdy wiadomość zostanie wysłana, a wiadomość ta nie zostanie dostarczona, dopóki funkcja nie zakończy wykonywania. Ponieważ funkcja zawiera wywołanie zewnętrznego interfejsu API, opóźnienie dostarczenia będzie zależeć od szybkości powrotu wywołania API do Open AI, co jest poza kontrolą PubNub i może być dość wysokie.

Istnieje kilka sposobów na złagodzenie pogorszenia wrażeń użytkownika. Większość wdrożeń zapewnia natychmiastową informację zwrotną dla nadawcy, że wiadomość została wysłana, a następnie polega na potwierdzeniach odczytu, aby wskazać, że wiadomość została dostarczona (lub zgłoszona).

Aktualizacja aplikacji klienckiej

Rozważmy, co byłoby wymagane do obsługi ładunku moderacji w aplikacji przy użyciu Chat Demo, która jest aplikacją React wykorzystującą PubNub Chat SDK do pokazania większości funkcji typowej aplikacji czatu.

Skonfiguruj atrybut, aby śledzić, czy potencjalnie szkodliwa wiadomość powinna zostać wyświetlona:

 const [showHarmfulMessage, setShowHarmfulMessage] = useState(false)

I dodać trochę logiki, aby domyślnie nie wyświetlać potencjalnie szkodliwej wiadomości, w tym przypadku w message.tsx:

{(
  !message.content.openAiModeration || 
  !message.content.openAiModeration?.results[0].flagged || 
  showHarmfulMessage) && (message.content.text
)}
{
  !showHarmfulMessage && 
  message.content.openAiModeration?.results[0].flagged && 
  <span>Message contains potentially harmful content 
    <span className="text-blue-400 cursor-pointer" 
    onClick={() => {setShowHarmfulMessage(true)}}>(Reveal)
    </span>
  </span>
}

Zauważ, że te zmiany nie są obecne w hostowanej wersji Chat Demo, ale ReadMe zawiera pełne instrukcje, jak ją zbudować i uruchomić z własnego zestawu kluczy.

Podsumowanie

Oto szybki i łatwy (oraz darmowy) sposób na dodanie zarówno moderacji, jak i analizy sentymentu do aplikacji przy użyciu Open AI.

Aby dowiedzieć się więcej o integracji Open AI z PubNub, zapoznaj się z innymi zasobami:

Integracja API OpenAI GPT z funkcjami
Tworzenie Chatbota z PubNub i ChatGPT (Dodawanie Chatbota do naszej prezentacji PubNub)
Ulepszanie aplikacji geograficznej za pomocą PubNub i Chat GPT / OpenAI

Zachęcamy do skontaktowania się z zespołem DevRel pod adresem devrel@pubnub.com lub z naszym zespołem pomocy technicznej w celu uzyskania pomocy w dowolnym aspekcie rozwoju PubNub.

Jak PubNub może ci pomóc?

Ten artykuł został pierwotnie opublikowany na PubNub.com

Nasza platforma pomaga programistom tworzyć, dostarczać i zarządzać interaktywnością w czasie rzeczywistym dla aplikacji internetowych, aplikacji mobilnych i urządzeń IoT.

Poznaj PubNub

Sprawdź Live Tour, aby zrozumieć podstawowe koncepcje każdej aplikacji opartej na PubNub w mniej niż 5 minut.

Rozpocznij konfigurację

Załóż konto PubNub, aby uzyskać natychmiastowy i bezpłatny dostęp do kluczy PubNub.

Rozpocznij

Dokumenty PubNub pozwolą Ci rozpocząć pracę, niezależnie od przypadku użycia lub zestawu SDK.

Jak używać Illuminate do balansowania gier

PubNub Developer Relations — Wed, 03 Jul 2024 06:30:47 +0000

Najnowsza wersja produktu PubNub, Illuminate, to skalowalne narzędzie do podejmowania decyzji, które stworzyliśmy, aby pomóc twórcom gier, menedżerom produktów i kierownikom projektów tworzyć, iterować i eksperymentować w ramach platformy PubNub.

Zaprojektowane od podstaw z doskonałym interfejsem użytkownika, Illuminate może pomóc w podejmowaniu decyzji, aby zapewnić graczom lepsze wrażenia i przyspieszyć monetyzację w czasie rzeczywistym.

Czym więc jest balansowanie rozgrywki i jak można z niego korzystać w czasie rzeczywistym?

Balans gry to gałąź projektowania gier, która poprawia rozgrywkę i wrażenia użytkownika poprzez zrównoważenie trudności i sprawiedliwości. Balans gry polega na dostosowaniu nagród, wyzwań i/lub elementów gry w celu stworzenia zamierzonego doświadczenia gracza.

Balans gry jest ogólnie rozumiany jako wprowadzenie sprawiedliwości dla graczy. Obejmuje to;

Dostosowanie poziomu trudności,
Modyfikowanie warunków wygranej i przegranej
stany gry
Równoważenie ekonomii

Więcej informacji na temat balansowania gry można znaleźć na stronie Wikipedia.

Korzystanie z balansu gry w czasie rzeczywistym może pomóc utrzymać zaangażowanie graczy, sprawić, że nowi gracze poczują się mile widziani i potencjalnie zarabiać na rozgrywce.

Jak Illuminate może pomóc w utrzymaniu zaangażowania graczy?

Jak wspomniano, Illuminate jest narzędziem do podejmowania decyzji w czasie rzeczywistym. Aby pomóc utrzymać zaangażowanie naszych graczy, skupimy się na nowych graczach, tych, którzy są nowi w grze i potencjalnie potrzebują pomocy w przyzwyczajeniu się do sposobu gry.

W tym przykładzie zbudowałem staromodną kopię asteroid napisaną w JavaScript i hostowaną w całości na funkcjach PubNub. Więcej informacji na temat funkcji PubNub można znaleźć na stronie https://www.pubnub.com/docs/serverless/functions/overview.

Po pierwsze, aby ustawić scenę.

Wyobraźmy sobie, że nowy gracz dołącza do gry i zaczyna grać, przegrywa i zaczyna się nudzić brakiem postępów.

Poprzez publikację możemy wysłać wiadomość z gry do PubNub, która powiadamia Illuminate o postępach gracza i wyniku, Illuminate podejmuje pewne decyzje w oparciu o predefiniowane metryki, a następnie wysyła wiadomość z powrotem do tego gracza, oferując mu opcję zakupu trzech żyć lub obejrzenia płatnej promocji w zamian za otrzymanie dwóch żyć.

Przejdźmy przez ekrany.

Gra zaczyna się normalnie, ale jak widać, nie jestem zbyt dobrym graczem i zginąłem z zaledwie 70 punktami.

Aby pomóc mi kontynuować grę, Illuminate otrzymało ten wynik i obliczyło, że powinienem otrzymać możliwość zakupu kilku żyć lub obejrzenia reklamy, aby uzyskać kilka żyć.

Decydując się na wydanie pieniędzy, byłem w stanie kupić kilka żyć i szybko wróciłem do gry.

Przejdźmy za kulisy Illuminate.

Illuminate można znaleźć w portalu konta PubNub - https://admin.pubnub.com/, pod nagłówkiem "Optymalizacja".

Naszym pierwszym przystankiem jest sprawdzenie naszych obiektów biznesowych. Obiekty biznesowe to sposób na pobieranie danych do Illuminate, pomagają nam zdefiniować, jakiego rodzaju dane musimy przechwytywać i skąd.

Możesz zdefiniować, jakie dane chcesz śledzić, dodając miary i jak chcesz segmentować te dane, dodając wymiary.

Jeśli potrzebujesz pomocy w konfiguracji lub zrozumieniu konfiguracji Illuminate, możesz znaleźć dokumenty tutaj: https://www.pubnub.com/docs/illuminate/basics.

Zrównoważenie gry wymaga wiedzy na temat tego, co chcesz śledzić i co chcesz zaoferować nowym graczom, aby utrzymać ich zaangażowanie.

Takie są umiejętności Illuminate; bez żadnego kodowania możemy dodawać, usuwać lub modyfikować zmienne, aby doskonalić, a nawet dostosowywać to, co oferujemy różnym graczom.

W tym prostym przykładzie zdecydowałem się zmierzyć wynik gry, ale można łatwo dodać inne miary; przykłady tutaj obejmują;

Czy gracz jest gościem, czy ma konto na platformie gry?
Całkowita długość gry
Typ urządzenia - sieć, telefon komórkowy, telewizor.
Czy wcześniej kupili coś od ciebie w poprzednich wydarzeniach lub grach?

Wracając do moich celów biznesowych, pozwól, że pokażę ci miary, z którymi pracuję.

Rozkładając to na czynniki pierwsze:

Mierniki: Wartości liczbowe, które można zmierzyć lub zsumować.

Wymiary: Wartości jakościowe, które można wykorzystać do segmentacji miar.

Metryki: Agregacja miar posegmentowanych według wybranych wymiarów.

Decyzje: Zbiór warunków i działań. Gdy warunki są spełnione, uruchamiana jest odpowiednia akcja.

Dashboards: Zbiór wykresów w czasie rzeczywistym, które wizualizują metryki i decyzje.

W moim przykładzie jedną z miar, których używam, jest klient proszący Illuminate o pomoc, gdy wynik jest poniżej 500 punktów.

Następnie zmapowałem to do decyzji: "Jeśli gracz ma wynik poniżej 500 punktów, zaoferuj mu możliwość zakupu życia lub obejrzenia reklamy".

Gdy gracz wybierze, czy chce obejrzeć reklamę lub kupić życia, jest to przekazywane jako metryka, która jest następnie wyświetlana na moim pulpicie nawigacyjnym.

Oto uproszczony widok mojego pulpitu nawigacyjnego. Widać, że śledzimy, którzy gracze zdobyli mniej niż 500 punktów i którzy gracze zdecydowali się zapłacić za swoje życia zamiast oglądać reklamy.

Ponownie, zakres rozszerzenia złożoności jest tutaj bardzo szeroki;

Czy więcej graczy zapłaciłoby za dodatkowe życia, gdyby były one tanie?
Czy oglądaliby 30-sekundową reklamę czy 3-minutową?

W porównaniu do tradycyjnego podejścia?

Gry strategiczne? Gry online? Równoważenie wrażeń i mechaniki gry dla wszystkich graczy może być długim procesem. Przed premierą można przetestować różne elementy gry, stworzyć samouczek wprowadzający i, w oparciu o zachowanie graczy, zapewnić progresywny projekt poziomów, aby zarówno zmaksymalizować czas gry, jak i zapobiec zbyt łatwej grze. Po uruchomieniu możesz monitorować fora graczy, sprawdzać dane analityczne dotyczące liczby graczy i ich działań, a następnie wydawać łatki, aby rozwiązać wszelkie problemy z równowagą... i miejmy nadzieję, że nie osłabisz przy tym swojej gry!

Może to być bardzo długi cykl analizy i wydawania, a Illuminate może w tym pomóc. Możesz podejmować decyzje w czasie rzeczywistym, niezależnie od typu gry: Możesz mieć grę wieloosobową, taką jak FPS lub RPG, bijatykę dla jednego gracza na Steam lub arenę bitewną, taką jak League of Legends. Tak długo, jak gra wideo jest online, gdzie na równowagę gracza może wpływać podejmowanie działań w danym momencie, Illuminate może poprawić wrażenia gracza - zapytałem PM i powiedzieli, że gry planszowe i karciane nie są jeszcze na mapie drogowej :(.

Podsumowanie

Wykorzystanie PubNub's Illuminate do zbalansowania gry to szybki, niewymagający kodowania sposób na wprowadzenie do aplikacji narzędzi do natychmiastowego podejmowania decyzji, dzięki czemu wrażenia graczy będą jeszcze lepsze.

Aby dowiedzieć się więcej o tworzeniu pierwszej gry z akcjami w czasie rzeczywistym, sprawdź naszą stronę Illuminate for gaming i naszą dokumentację. Mamy nadzieję, że spotkamy się na następnej konferencji GDC, gdzie z chęcią posłuchamy, co już stworzyliście z PubNub!

Jak PubNub może ci pomóc?

Ten artykuł został pierwotnie opublikowany na PubNub.com

Nasza platforma pomaga programistom tworzyć, dostarczać i zarządzać interaktywnością w czasie rzeczywistym dla aplikacji internetowych, aplikacji mobilnych i urządzeń IoT.

Poznaj PubNub

Sprawdź Live Tour, aby zrozumieć podstawowe koncepcje każdej aplikacji opartej na PubNub w mniej niż 5 minut.

Rozpocznij konfigurację

Załóż konto PubNub, aby uzyskać natychmiastowy i bezpłatny dostęp do kluczy PubNub.

Rozpocznij

Dokumenty PubNub pozwolą Ci rozpocząć pracę, niezależnie od przypadku użycia lub zestawu SDK.

Śledzenie geolokalizacji JavaScript za pomocą Google Maps API

PubNub Developer Relations — Fri, 31 May 2024 14:30:46 +0000

Oto zaktualizowany wpis na blogu, z płynnie osadzonymi wszystkimi słowami kluczowymi.

Jest to podsumowanie czteroodcinkowej serii o tworzeniu aplikacji internetowych na żywo, w czasie rzeczywistym, z funkcjami geolokalizacji przy użyciu Google Maps JavaScript API i PubNub. Nasz samouczek przeprowadzi Cię przez proces generowania ścieżek lotu przy użyciu JavaScript i PubNub.

Aby zobaczyć, jak to wszystko jest zaimplementowane, sprawdź nasze demo Showcase na stronie PubNub. Przejdź do wersji demonstracyjnej Geolocation, aby zobaczyć, jak wykorzystujemy PubNub ze śledzeniem w czasie rzeczywistym. Aby zapoznać się z kodem wersji demonstracyjnej, przejdź do naszego serwisu Github, aby zobaczyć, jak to wszystko działa.

Czym są ścieżki lotu?

Ścieżki lotu, zaimplementowane w tym samouczku, odnoszą się do polilinii, które umożliwiają dynamiczne rysowanie ścieżek przez punkty określone przez użytkownika na mapie znajdującej się na urządzeniach mobilnych lub w przeglądarce internetowej. Są one integralną częścią HTML5 Geolocation API i Google Maps API do śledzenia wzorców ruchu.

Przegląd samouczka

Upewnij się, że spełniłeś wymagania wstępne z części pierwszej, drugiej i trzeciej, , gdzie skonfigurowaliśmy nasze środowisko JavaScript i omówiliśmy znaczniki map oraz śledzenie lokalizacji.

Gdy to zrobisz, przejdź do następnej części.

Przewodnik po kodzie

Zacznijmy od zdefiniowania zmiennych let\ map\, mark\ i lineCoords\ do przechowywania naszych obiektów mapy, markera i współrzędnych polilinii. W ten sposób możemy je dostosowywać w miarę nadejścia zdarzeń PubNub. Następnie definiujemy wywołanie zwrotne initialize\, które jest używane przez Google Maps JavaScript API po gotowości do załadowania. Upewnij się, że zastąpiłeś YOUR\_GOOGLE\_MAPS\_API\_KEY\ swoim rzeczywistym kluczem API.

let map;
let mark;
let lineCoords = [];
let initialize = function() {
  map  = new google.maps.Map(document.getElementById('map-canvas'), {center:{lat:lat,lng:lng},zoom:12});
  mark = new google.maps.Marker({position:{lat:lat, lng:lng}, map:map});
};
window.initialize = initialize;

Teraz, dzięki obsłudze zdarzenia "redraw", zaktualizujemy nowe informacje o lokalizacji w locie, wywołując metodę geolokalizacji getCurrentPosition() \.

Lat/Long

Następnie definiujemy funkcję obsługi zdarzenia redraw, którą będziemy wywoływać za każdym razem, gdy otrzymamy nowe zdarzenie zmiany pozycji w locie. W pierwszej części funkcji ustawiamy szerokość i długość geograficzną na nowe wartości z komunikatu. Następnie wywołujemy odpowiednie metody na obiektach mapy, markera i polilinii, aby zaktualizować pozycję, dodać ją do końca linii i ponownie wyśrodkować mapę.

var redraw = function(payload) {
  lat = payload.message.lat;
  lng = payload.message.lng;
  map.setCenter({lat:lat, lng:lng, alt:0});
  mark.setPosition({lat:lat, lng:lng, alt:0});
  lineCoords.push(new google.maps.LatLng(lat, lng));
  var lineCoordinatesPath = new google.maps.Polyline({
    path: lineCoords,
    geodesic: true,
    strokeColor: '#2E10FF'
  });
  lineCoordinatesPath.setMap(map);
};

Inicjalizacja PubNub

Po zdefiniowaniu naszych wywołań zwrotnych, zainicjujemy funkcję strumieniowego przesyłania danych w czasie rzeczywistym PubNub, która działa na telefonach komórkowych, tabletach, przeglądarkach i laptopach w różnych technologiach, takich jak iOS, Android, JavaScript, .NET, Java, Ruby, Python, PHP i innych.

const pnChannel = "map3-channel";
const pubnub = new PubNub({
  publishKey:   'YOUR_PUB_KEY',
  subscribeKey: 'YOUR_SUB_KEY'
});
pubnub.subscribe({channels: [pnChannel]});
pubnub.addListener({message:redraw});

Funkcjonalność PubNub do publikowania i subskrybowania tematów w kanałach czasu rzeczywistego zapewnia wydajne możliwości strumieniowego przesyłania danych.

Publikowanie długości i szerokości geograficznej

W tym prostym samouczku skonfigurowaliśmy podstawowy licznik interwałów JavaScript, aby publikować nowe pozycje w oparciu o bieżący czas. Co 500 milisekund wywołujemy anonimową funkcję zwrotną, która publikuje nowy obiekt szerokości/długości geograficznej (ze współrzędnymi poruszającymi się w kierunku północno-wschodnim) na określonym kanale PubNub. W swojej aplikacji prawdopodobnie będziesz pobierać pozycję z pozycji urządzenia na żywo lub lokalizacji zgłoszonej przez użytkownika.

setInterval(function() {
  pubnub.publish({channel:pnChannel, message:{lat:window.lat + 0.001, lng:window.lng + 0.01}});
}, 500);

Wreszcie, na samym końcu inicjalizujemy interfejs API Map Google, aby upewnić się, że elementy DOM i warunki wstępne JavaScript są spełnione.

<script src="https://maps.googleapis.com/maps/api/js?v=3.exp&key=YOUR_GOOGLE_MAPS_API_KEY&callback=initialize"></script>

Podsumowanie

Ta seria samouczków pokazała nam, jak Google Maps API i PubNub wyjątkowo dobrze współpracują ze sobą w celu śledzenia lokalizacji w czasie rzeczywistym w aplikacjach internetowych i mobilnych. Jest to podobne do tego, jak usługi przewozowe, takie jak Uber i Lyft, pokazują ruch swoich pojazdów w czasie rzeczywistym.

Poznaj PubNub

Zapoznaj się z Live Tour, aby zrozumieć podstawowe koncepcje każdej aplikacji opartej na PubNub w mniej niż 5 minut. Dowiedz się więcej o doświadczeniach naszych użytkowników bezpośrednio z naszej strony GitHub i opinii dostępnych na naszej stronie internetowej.

Rozpocznij konfigurację

Zarejestruj konto Pub Nub, aby uzyskać natychmiastowy dostęp do kluczy PubNub za darmo.

Rozpocznij

Dokumenty PubNub pozwolą Ci rozpocząć pracę, niezależnie od przypadku użycia. Mamy sekcje poświęcone JavaScript Google Maps API i temu, jak używać ich ze śledzeniem w czasie rzeczywistym w naszym SDK.

Odkrywanie przypadków użycia dla usług kognitywnych

PubNub Developer Relations — Fri, 31 May 2024 13:50:06 +0000

Przeanalizujmy kilka przykładów aplikacji i firm przekształconych przez usługi kognitywne oraz kilka przyszłych przypadków użycia, aby zobaczyć, jak bardzo zmieniają one krajobraz technologiczny.

Dzięki usługom kognitywnym gigantów chmury, takich jak AWS, IBM i Microsoft Azure, zespoły programistów każdej wielkości mają teraz dostęp do usług kognitywnych o oszałamiającej mocy. Usługi te, dostarczane za pośrednictwem interfejsów API, ułatwiają wprowadzanie inteligencji nowej generacji do aplikacji.

Czat i interakcje społecznościowe

W 2015 roku miesięczna liczba aktywnych użytkowników aplikacji do czatowania przewyższyła liczbę użytkowników sieci społecznościowych, a przepaść ta wciąż się powiększa. Rzeczywiście, przesyłanie wiadomości stało się istotną cechą samych sieci społecznościowych. Wraz z tym szybkim wzrostem, aplikacje do przesyłania wiadomości ewoluowały od prostych narzędzi do wysyłania i odbierania krótkich wiadomości tekstowych do innowacyjnych, w pełni funkcjonalnych doświadczeń z zaskakującymi i zachwycającymi funkcjami. A siłą napędową tych innowacji są kognitywne interfejsy API.

Chatboty i obliczenia kognitywne

Chatboty są jedną z najwcześniejszych form algorytmów sztucznej inteligencji. Choć jest mało prawdopodobne, że wkrótce przejdą test Turinga, stanowią one naturalną ewolucję aplikacji obsługujących głos. Tam, gdzie kiedyś można było zadzwonić na linię pomocy technicznej i nacisnąć 1, aby uzyskać informacje o płatnościach, teraz można mówić pełnymi zdaniami do systemu, który potrafi rozpoznać intencje użytkownika.

Niezależnie od tego, czy zdajesz sobie sprawę, czy nie, adopcja chatbotów eksplodowała, ponieważ firmy starają się skrócić czas oczekiwania, poprawić jakość obsługi klienta i zminimalizować koszty ludzkich operatorów telefonicznych. Obecnie są one wykorzystywane głównie do obsługi prostych zadań: rozumienia podstawowych żądań i reagowania w oparciu o predefiniowane reguły, odpowiadając na pytania takie jak "Gdzie jest moje zamówienie?" lub "Chatbot, włącz nastrojowe światła".

Jednak interfejsy API, takie jak Watson Assistant lub Amazon Lex, ułatwiają tworzenie usług, które mogą stosować logikę do zaobserwowanych wzorców w tych żądaniach w języku naturalnym. Usługi te mogą na przykład zaobserwować nagły wzrost liczby połączeń z lotniska, które ma opóźnienia w starcie, i zmienić sekwencję opcji, aby nadać priorytet zmianie harmonogramu lotów. Mogą też zauważyć, że połączenia z określonego kraju lub regionu są zwykle prowadzone w innym języku i odpowiednio zmienić domyślne ustawienia. Mogą nawet zidentyfikować wzorce gramatyczne, które wskazują klientów do natychmiastowego przekazania do przełożonego.

Inteligentne interfejsy konwersacyjne wykorzystujące rozpoznawanie mowy, zamianę tekstu na mowę, rozpoznawanie twarzy i modele uczenia maszynowego mogą zapewnić wysoce angażujące doświadczenia i realistyczne rozmowy do różnych celów. A co więcej, będą uczyć się na podstawie tych doświadczeń.

Chatboty zmienią sposób, w jaki bankujemy, robimy zakupy i uczymy się: tworząc rekomendacje, rozumiejąc abstrakcyjne pojęcia i poznając osoby na podstawie wcześniejszych kontaktów. W końcu staną się tak dobre, że nawet nie będziesz wiedział, czy rozmawiasz z człowiekiem.

Przykład kodu: Chatbot automatyki domowej

Korzystając z Watson i PubNub ChatEngine, możesz łatwo stworzyć chatbota ze sztuczną inteligencją, który kontroluje twój inteligentny dom.

Ten samouczek pokazuje, jak zbudować chatbota, który akceptuje polecenia tekstowe, analizuje je i podejmuje działania na ich podstawie. Na przykład, użytkownik wpisze "włącz światła w salonie", a bot uruchomi światła.

{

  "homeauto_intents": 
  [
    {
      "intent":"turnOFF",
      "examples":
      [
        {"text":"Put off"},
        {"text":"Switch off"},
        {"text":"Turn off"}
      ],
      "description":"Turn on intents"
    },
    {
      "intent":"turnON",
      "examples":
      [
        {"text":"Put on"},
        {"text":"Switch on"},
        {"text":"Turn on"}
      ],
      "description":"Turn off intents"
    }

Przetwarzanie języka naturalnego

Kolejnym niezwykle istotnym obszarem jest nauka o danych i przetwarzanie języka naturalnego (NLP), czyli ogólny termin dla rozwiązań AI, które mogą owocnie przetwarzać duże ilości danych w języku naturalnym. NLP może nie tylko oceniać słowa i gramatykę z semantycznego punktu widzenia, ale może także odkrywać nastroje i emocje, odkrywając, jak użytkownicy czują się na dany temat lub temat poprzez analizę wiadomości po wiadomości.

NLP to ogromna korzyść dla marek, osób publicznych i organizacji, które muszą zrozumieć opinie użytkowników i reagować na nie w czasach, gdy reputacja może zostać zbudowana lub zniszczona w ciągu kilku minut. Wyobraźmy sobie, że marka wypuszcza nową reklamę produktu. Korzystając z odpowiednich usług kognitywnych, może połączyć się ze strumieniem mediów społecznościowych pod określonym hashtagiem lub nazwą produktu i zlecić swojemu interfejsowi NLP API analizę wszystkich istotnych wiadomości i dostarczyć informacji zwrotnych na temat reakcji opinii publicznej na produkt.

Poniżej znajduje się przykład aplikacji zaprojektowanej do analizowania i oceniania opinii ludzi na temat amerykańskich polityków na Twitterze. Monitoruje ona określone słowa kluczowe i frazy, a następnie może wykreślić emocje użytkowników w określonych regionach geograficznych.

Na przykład, jeśli użytkownik wyśle tekst "Jestem szczęśliwy"...

{
   "session_id": 1,
   "text": "I am happy!"
}

Watson analizuje tekst i zwraca następujące informacje:

{
   "session_id": 1,
   "text": "I am happy!"
   "session_sentiment": {
      "overall": 0.879998,
      "positive": {
         "count": 1,
         "avg": 0.879998
      },
      "negative": {
         "count": 0,
         "avg": 0
      },
      "neutral": {
         "count": 2,
         "avg": null
      }
   },
   "score": 0.88006828
}

Marki już wydają duże kwoty na analizę nastrojów rynkowych. W miarę jak systemy te stają się coraz bardziej inteligentne, niezawodne i zautomatyzowane, będą w stanie znacznie lepiej zrozumieć opinię publiczną przy niższych kosztach.

eCommerce

Chociaż zakupy online całkowicie zmieniły sposób, w jaki kupujemy towary, w handlu elektronicznym brakuje jednego kluczowego elementu sklepu stacjonarnego: pomocnych pracowników. W skali, w jakiej działają sklepy internetowe, nie jest ekonomicznie opłacalne posiadanie prawdziwych pracowników czatu na żywo.

W rezultacie wiele sklepów internetowych korzysta z usług inteligentnych botów-asystentów zakupowych, aby zoptymalizować obsługę, pomagać kupującym w zadawaniu pytań, przedstawiać rekomendacje, a nawet dokonywać płatności.

Nordstrom zdominował poprzednie sezony świąteczne swoim chatbotem Messenger, który wykraczał poza proste, predefiniowane pytania i odpowiedzi i wykorzystywał usługi kognitywne, aby naprawdę zrozumieć, czego szuka klient i pomóc w razie potrzeby. Oferował rekomendacje prezentów, a nawet mógł pomóc w realizacji zamówienia.

Chatboty uchroniły nas również przed przerażającymi rozmowami telefonicznymi z działem obsługi klienta i czekaniem przez godzinę, aż przedstawiciel firmy rozwiąże prosty problem. Amazon wdrożył chatboty, które mogą rozwiązywać drobne problemy, z którymi boryka się większość klientów potrzebujących pomocy przy składaniu zamówień.

Teraz, gdy przyjrzeliśmy się kilku przykładom inteligencji w świecie rzeczywistym, spójrzmy w przyszłość i zobaczmy, jak usługi kognitywne zmienią nasz świat w przyszłości.

Inteligentne miasta

Miasta przyszłości będą polegać na różnych zintegrowanych inteligentnych usługach, aby uczynić je bezpieczniejszymi, bardziej wydajnymi i bardziej przyjaznymi dla środowiska. Rozpoznawanie obrazów, wizja komputerowa i interfejsy API wizji będą odgrywać kluczową rolę w tej transformacji, przetwarzając i podejmując działania na obrazach w przestrzeni miejskiej.

Rolnictwo

Globalna populacja wciąż rośnie, a wyżywienie tych miliardów ludzi będzie w nadchodzących latach sporym wyzwaniem. Usługi kognitywne odegrają kluczową rolę w zarządzaniu polami i fabrykami, pozwalając nam podejmować inteligentne decyzje i kontrolować zasoby z precyzją, jakiej nigdy wcześniej nie mieliśmy.

Inteligentne farmy i IoT będą obejmować jak najwięcej cennych punktów danych, aby podejmować inteligentne decyzje rolnicze, nawet te, które wydają się sprzeczne z intuicją. Na przykład, agregując dane pogodowe w czasie rzeczywistym, dane ze zdalnych czujników i historyczne wyniki, usługi kognitywne mogą udoskonalić indywidualny plan nawadniania i aktualizować go w zależności od wyjątkowych okoliczności każdego dnia.

Bezpieczeństwo danych

W miarę jak stajemy się coraz bardziej połączeni, a nasze cyfrowe życie przyćmiewa nasze fizyczne, prywatność i bezpieczeństwo danych przekształcają się z czegoś, czego jesteśmy niejasno świadomi, w niepokojące, stale obecne osobiste zagrożenie.

Przepisy i zasady - HIPAA, RODO, SOC II - są jednym ze sposobów na zapewnienie, że firmy i organizacje mają odpowiednie zabezpieczenia. Wdrożenie tych złożonych przepisów w szczegółach może być bardzo trudne, dlatego do gry wkracza uczenie maszynowe.

Usługi kognitywne można przeszkolić w zakresie rozumienia i nadawania sensu zasadom i przepisom, a następnie sugerować sposoby osiągnięcia zgodności. Usługi kognitywne umożliwiają dostarczanie cennych informacji na temat bezpieczeństwa danych, od odpowiednich zasad i przepisów po moderację treści.

Opieka zdrowotna

Innowacje w branży opieki zdrowotnej zwykle postępują wolniej niż w innych branżach z kilku powodów, w tym z powodu wąskich marż, surowych przepisów oraz silosowych badań i rozwoju. Usługi kognitywne oferują możliwość zniesienia barier dla innowacji i usprawnienia systemu dostarczania usług od organizacji po pacjentów.

Podejmowanie decyzji w opiece zdrowotnej zazwyczaj odbywa się na zasadzie silosowej, pacjent po pacjencie. Usługi kognitywne natomiast analizują i działają w oparciu o kompleksowy obraz czynników wpływających na zdrowie: status społeczno-ekonomiczny, środowisko, dostęp do opieki zdrowotnej itp. Usługi kognitywne mogą zalecać lekarzom lepszą, bardziej ukierunkowaną opiekę nad pacjentem, w tym programy zdrowotne i odnowy biologicznej.

Usługi kognitywne mogą napędzać integrację i łączenie istniejących systemów w organizacjach opieki zdrowotnej oraz odkrywać istotne spostrzeżenia. Nagle, będąc w stanie agregować dane i łączyć potrzeby interesariuszy, organizacje mogą zapewnić lepszą opiekę, działając jednocześnie bardziej efektywnie.

Inteligencja teraz

W tym artykule opisano tylko niewielką próbkę tego, jak usługi kognitywne zmienią sposób, w jaki myślimy o biznesie i roli, jaką mogą odgrywać aplikacje. W przeszłości oprogramowanie wykonywało instrukcje. Dzięki usługom kognitywnym rozwiązania mogą się dostosowywać, ewoluować i osiągać rzeczy, które jeszcze kilka lat temu wydawały się niemożliwe. Nie widzimy wszystkich implikacji, ale z tego, co wiemy, nie ma wątpliwości, że wpływ na biznes będzie głęboki, pozytywny - i zanim się zorientujesz.

Jak PubNub może ci pomóc?

Ten artykuł został pierwotnie opublikowany na PubNub.com

Nasza platforma pomaga programistom tworzyć, dostarczać i zarządzać interaktywnością w czasie rzeczywistym dla aplikacji internetowych, aplikacji mobilnych i urządzeń IoT.

Poznaj PubNub

Sprawdź Live Tour, aby zrozumieć podstawowe koncepcje każdej aplikacji opartej na PubNub w mniej niż 5 minut.

Rozpocznij konfigurację

Załóż konto PubNub, aby uzyskać natychmiastowy i bezpłatny dostęp do kluczy PubNub.

Rozpocznij

Dokumenty PubNub pozwolą Ci rozpocząć pracę, niezależnie od przypadku użycia lub zestawu SDK.

Śledzenie zatwierdzeń na pulpicie nawigacyjnym GitHub w czasie rzeczywistym

PubNub Developer Relations — Thu, 30 May 2024 19:31:31 +0000

W dziedzinie tworzenia oprogramowania wykresy C3.js w czasie rzeczywistym oferują skuteczny sposób monitorowania aktywności w organizacji. W przypadku zespołów inżynieryjnych jednym z możliwych do śledzenia wskaźników są zatwierdzenia w serwisie GitHub. Aby zgłębić ten temat, ten wpis na blogu zawiera samouczek, który poprowadzi Cię przez proces wykorzystania interfejsu API GitHub do pobierania i wyświetlania danych zatwierdzeń GitHub na interaktywnym wykresie w czasie rzeczywistym. Wykorzystamy moc HTML, Javascript, CSS i użyjemy PubNub do stworzenia pulpitu nawigacyjnego GitHub i przesyłania strumieniowego danych zatwierdzeń, podczas gdy C3.js pomoże w wizualizacji.

Aby dowiedzieć się więcej o wykresach C3.js w czasie rzeczywistym, przygotowaliśmy świetny samouczek. A teraz do dzieła!

Jak utworzyć pulpit nawigacyjny GitHub w czasie rzeczywistym

Tworzenie pulpitu nawigacyjnego GitHub w czasie rzeczywistym obejmuje łączenie się z różnymi źródłami danych, takimi jak repozytorium GitHub i dbanie o niektóre niezbędne zależności. Należy pamiętać o niezbędnych środkach bezpieczeństwa cybernetycznego, takich jak bezpieczne kodowanie i szyfrowanie danych. Przestrzeganie branżowych protokołów bezpieczeństwa jest koniecznością.

Oto przewodnik krok po kroku:

Dodaj webhook GitHub

Aby skonfigurować webhook, wykonaj następujące kroki:

Utwórz repozytorium GitHub lub użyj istniejącego repozytorium git.
Kliknij "Ustawienia" po prawej stronie strony.
Kliknij "Webhooks" po lewej stronie strony.
Kliknij "Dodaj Webhook" w prawym górnym rogu.
GitHub poprosi o podanie hasła, wprowadź je.
W polu "Payload URL" wpisz: http://pubnub-git-hook.herokuapp.com/github/ORG-NAME/TEAM-NAME. Zastąp ORG-NAME nazwą swojej organizacji, a TEAM-NAME nazwą zespołu kontrolującego repozytorium.

Załaduj wizualny pulpit nawigacyjny

Odwiedźtę stronę. Zobaczysz listę wszystkich commitów wysłanych przez dashboard PubNub - słodkie! Po przesłaniu jednego z commitów do GitHub, w ciągu kilkudziesięciu milisekund na pulpicie commitów GitHub powinna pojawić się wiadomość, a wykresy będą aktualizowane w czasie rzeczywistym.

Jak zbudowaliśmy pulpit nawigacyjny zatwierdzeń Github

Pulpit nawigacyjny jest połączeniem GitHub, PubNub Data Stream Network i wizualizacji wykresów D3 obsługiwanych przez C3.js. Gdy commit jest przesyłany do GitHub, metadane commitu są publikowane w małej instancji Heroku, która publikuje je w sieci PubNub. Hostujemy stronę pulpitu nawigacyjnego na stronach GitHub.

Gdy nasza instancja Heroku otrzyma dane zatwierdzenia z GitHub, publikuje podsumowanie tych danych w PubNub przy użyciu publicznych kluczy publikowania/subskrybowania na kanale pubnub-git. Kanał pubnub-git można monitorować za pośrednictwem naszej konsoli programisty tutaj.

Oto przykładowy ładunek wiadomości:

{ 
  "name":"drnugent",
  "avatar_url":"https://avatars.githubusercontent.com/u/857270?v=3",
  "num_commits":4,
  "team":"team-pubnub",
  "org":"pubnub",
  "time":1430436692806,
  "repo_name":"drnugent/test"
}

Druga połowa magii dzieje się, gdy dashboard otrzymuje te informacje za pośrednictwem wywołania zwrotnego subskrypcji. Jeśli spojrzysz na źródło dashboardu, zobaczysz ten kod:

pubnub.subscribe({
  channel: 'pubnub-git',
  message: displayLiveMessage

});

To wywołanie subskrypcji zapewnia, że funkcja JavaScript displayLiveMessage() jest wywoływana za każdym razem, gdy wiadomość zostanie odebrana na kanale pubnub-git. displayLiveMessage() dodaje powiadomienie commit push na górze dziennika i aktualizuje wykresy wizualizacji C3.

Ale zaraz, w jaki sposób pulpit nawigacyjny jest wypełniany po pierwszym załadowaniu?

Wykorzystanie PubNub Storage & Playback API dla pulpitu nawigacyjnego

PubNub przechowuje zapis każdej wysłanej wiadomości i zapewnia programistom sposób na dostęp do tych zapisanych wiadomości za pomocą interfejsu API Storage & Playback (History). Głębiej w pulpicie nawigacyjnym zobaczysz następujący kod:

var displayMessages = function(ms) { ms[0].forEach(displayMessage); };

pubnub.history({
  channel: 'pubnub-git',
  callback: displayMessages,
  count: 100
});

Jest to żądanie pobrania ostatnich 1000 wiadomości wysłanych za pośrednictwem kanału pubnub-git. Tak więc, nawet jeśli pulpit nawigacyjny mógł być offline, gdy te wiadomości zostały wysłane, jest w stanie je pobrać i wykorzystać te dane do wypełnienia pulpitu nawigacyjnego tak, jakby był stale online.

Funkcja ta jest szczególnie przydatna w przypadku urządzeń z przerywaną lub zawodną łącznością, takich jak aplikacje mobilne w sieciach komórkowych lub podłączone samochody. Dzięki sieci PubNub nasz pulpit wizualizacji nie wymaga zaplecza do przechowywania stanu aplikacji.

Tworzenie własnego pulpitu nawigacyjnego GitHub

Aby rozpocząć tworzenie własnego pulpitu nawigacyjnego Github, rozwidl repozytorium Git Commit UI na github.com i postępuj zgodnie z README, aby uzyskać instrukcje konfiguracji. Żądania ściągnięcia są mile widziane w ramach współpracy społeczności open source.

Przyszłe trendy i rozwój pulpitów nawigacyjnych w czasie rzeczywistym

Śledzenie ostatnich trendów i rozwoju w zakresie pulpitów nawigacyjnych w czasie rzeczywistym i powiązanych technologii ma kluczowe znaczenie. Obejmuje to websockety do transmisji danych w czasie rzeczywistym, wykorzystanie powiadomień do natychmiastowego wglądu oraz wykorzystanie pulpitu nawigacyjnego w czasie rzeczywistym w różnych przepływach pracy.

Doświadczenie PubNub

PubNub pomógł wielu klientom osiągnąć sukces dzięki ich aplikacjom działającym w czasie rzeczywistym. Na przykład system powiadomień w czasie rzeczywistym LinkedIn...

Konfiguracja

Zarejestruj konto PubNub, aby uzyskać natychmiastowy dostęp do kluczy PubNub za darmo. Najnowsze funkcje dostępne na koncie PubNub obejmują ...

Rozpocznij

Nasze obszerne dokumenty PubNub pozwolą ci rozpocząć pracę w mgnieniu oka, niezależnie od przypadku użycia lub zestawu SDK.

PubNub oferuje przyjazną dla użytkownika platformę, która zwiększa komfort użytkowania. Nasze usługi zostały zaprojektowane z myślą o programistach, aby zapewnić płynny proces integracji.

Jesteśmy tu po to, by ułatwić i usprawnić proces tworzenia aplikacji w czasie rzeczywistym. Skonfiguruj adres URL ładunku i zaczynajmy!

Oficjalna dokumentacja i wiarygodne źródła mogą być przywoływane w całym wpisie na blogu w celu potwierdzenia ważności informacji.

Jak PubNub może ci pomóc?

Ten artykuł został pierwotnie opublikowany na PubNub.com

Nasza platforma pomaga programistom tworzyć, dostarczać i zarządzać interaktywnością w czasie rzeczywistym dla aplikacji internetowych, aplikacji mobilnych i urządzeń IoT.

Poznaj PubNub

Sprawdź Live Tour, aby zrozumieć podstawowe koncepcje każdej aplikacji opartej na PubNub w mniej niż 5 minut.

Rozpocznij konfigurację

Załóż konto PubNub, aby uzyskać natychmiastowy i bezpłatny dostęp do kluczy PubNub.

Rozpocznij

Dokumenty PubNub pozwolą Ci rozpocząć pracę, niezależnie od przypadku użycia lub zestawu SDK.

Jak bezpiecznie moderować czat i użytkowników za pomocą BizOps Workspace

PubNub Developer Relations — Thu, 23 May 2024 10:00:09 +0000

Ten artykuł instruktażowy jest częścią serii artykułów omawiających możliwości zarządzania danymi PubNub, znane pod wspólną nazwą BizOps Workspace:

Jak zarządzać użytkownikami i kanałami za pomocą BizOps Workspace
Jak monitorować i moderować konwersacje za pomocą BizOps Workspace
Jak bezpiecznie moderować konwersacje i użytkowników za pomocą BizOps Workspace

BizOps Workspace to zestaw narzędzi, które pomagają zarządzać aplikacją. Ten artykuł rozszerzy poprzedni artykuł "Jakmonitorować i moderować konwersacjeza pomocą BizOps Workspace", aby pokazać kompleksową bezpieczną aplikację do czatowania z ręcznymi możliwościami moderacji, tj. możliwością monitorowania konwersacji w czasie rzeczywistym oraz wyciszania lub blokowania użytkowników.

Chociaż ten artykuł można czytać samodzielnie, zdecydowanie zalecam przeczytanie poprzedniego artykułu "Jak monitorować i moderować konwersacje zapomocą BizOps Workspace", aby lepiej zrozumieć tło omawianych tutaj koncepcji.

Czym jest Channel Monitor?

Channel Monitor umożliwia moderatorom czatu oglądanie na żywo podglądu rozmów prowadzonych w czasie rzeczywistym na wielu kanałach. Jeśli moderator zauważy coś niepokojącego, takiego jak niewłaściwie zachowujący się użytkownik lub obraźliwe wiadomości, może natychmiast podjąć działania w celu złagodzenia problemu.

Moderator ma dużą swobodę w zakresie podejmowanych działań:

Obserwować użytkownika bez ograniczania jego praw dostępu
edytować lub usunąć obraźliwą wiadomość
ograniczyć możliwość publikowania wiadomości przez użytkownika(wyciszyć)
ograniczyć użytkownikowi możliwość czytania lub publikowania wiadomości (ban).

Wszystkie możliwości w ramach funkcji "Monitor" są ręczne: ręczne przeglądanie wiadomości, ręczne wyciszanie użytkowników itp. Ten artykuł nie omawia automatycznej moderacji.

Aby korzystać z funkcji Channel Monitor, konieczne jest włączenie kilku funkcji w zestawie kluczy PubNub, w szczególności kontekstu aplikacji i trwałości wiadomości. Więcej szczegółów można znaleźć w sekcji "Wymagania dotyczące zestawu kluczy dla Channel Monitor" w poprzednim artykule.

Czym jest menedżer dostępu PubNub?

Programiści muszą chronić się przed użytkownikami próbującymi obejść ich system moderacji; można to osiągnąć za pomocą menedżera dostępu PubNub.

Menedżer dostępu pozwala zdefiniować zestaw reguł, które opisują uprawnienia określonego użytkownika (lub użytkowników) i jakie działania mogą wykonywać na określonych zasobach. Na przykład:

Użytkownik o identyfikatorze 123 ma uprawnienia do odczytu i zapisu na kanale 456
Wszyscy użytkownicy, których ID pasuje do wyrażenia regularnego user-*, mogą czytać z dowolnego kanału, którego ID pasuje do wyrażenia regularnego global-*.
Użytkownik o identyfikatorze 123 ma uprawnienia do aktualizacji metadanych kanału (tj. kontekstu aplikacji).

Pełna lista uprawnień znajduje się w dokumentacji na stronie https://www.pubnub.com/docs/general/security/access-control#permissions.

Menedżer dostępu PubNub jest oparty na tokenach, a najłatwiejszym sposobem na jego opisanie jest przejście przez przepływ autoryzacji pokazany w dokumentacji i zapewnienie dodatkowego kontekstu, w jaki sposób ten przepływ odnosi się do moderacji:

Próba logowania. Klient uwierzytelnia się na serwerze, aby zalogować użytkowników do aplikacji. Prawdopodobnie odbywa się to za pośrednictwem dostawcy tożsamości; po tym kroku serwer ma pewność, że rozmawia z zarejestrowanym użytkownikiem aplikacji i kim on jest. Klient żąda tokenu uwierzytelniania PubNub Access Manager w ramach swojej inicjalizacji.
Żądanie przyznania uprawnień. Serwer obsługuje żądanie klienta o token, wywołując interfejs API SDK "grantToken()". Kilka punktów do odnotowania na temat tego API: Można go wywołać tylko za pomocą tajnego klucza PubNub, a zatem można go wywołać tylko z serwera; jest dostępny dla wszystkich naszych zestawów SDK po stronie serwera; i to API zaakceptuje obiekty JSON w celu zdefiniowania zasobów i uprawnień, które definiują dostęp użytkownika (użytkowników).
Zwrócony*token*. PubNub przyznaje żądane uprawnienia żądanym użytkownikom i zwraca token uwierzytelniający do serwera.
Token*przekazany*. Następnie serwer zwraca token uwierzytelniający do pierwotnego klienta wywołującego.
Token ustawiony. Klient może określić ten token uwierzytelniający podczas inicjalizacji lub w dowolnym momencie cyklu życia aplikacji za pomocą metody setToken(). Możliwość aktualizacji tokena w dowolnym momencie jest niezbędna, ponieważ tokeny wygasają, ale klient będzie również musiał zażądać nowego tokena, jeśli Channel Monitor zaktualizuje swoje uprawnienia (tj. zostanie wyciszony lub zbanowany).
Autoryzowane żądanie API. Wszelkie kolejne połączenia z PubNub będą teraz uznawane za autoryzowane. PubNub zezwoli lub odrzuci każde żądanie API w oparciu o uprawnienia przyznane w kroku 2 i ważność tokena klienta.

Jak wygląda bezpieczne rozwiązanie moderacyjne?

Pod koniec poprzedniego artykułu pokazałem demo tego, jak wyglądałoby wyciszanie lub banowanie po stronie klienta. Chat SDK zawiera zdarzenia moderacji, które informują klienta o tym, czy został wyciszony lub zbanowany; jednak poza aktualizacją interfejsu użytkownika nie uniemożliwia to klientowi dalszego wysyłania wiadomości, mimo że został wyciszony/zbanowany. Aby bezpiecznie wyciszyć lub zablokować klienta, należy cofnąć jego istniejące uprawnienia Menedżera dostępu i przyznać mu nowe, aby odzwierciedlić jego nowy status wyciszenia lub zablokowania.

Rozważmy następujący scenariusz, w którym użytkownik został wyciszony z kanału "musicale":

Użytkownik ma dostęp do dwóch kanałów, "filmy" i "musicale", ale administrator chce wyciszyć go tylko z kanału "musicale".
Moderator wycisza użytkownika za pomocą Monitora kanałów. Pod przykrywką jest to wywołanie interfejsu API "setRestrictions()
Aplikacja serwerowa otrzymuje powiadomienie o "wyciszeniu" za pośrednictwem zdarzenia moderacji i unieważnia istniejący token dostępu użytkownika.
Aplikacja kliencka otrzymuje powiadomienie "mute" powiązane z kanałem "musicals" poprzez zdarzenie moderacji.
Aplikacja aktualizuje swój interfejs użytkownika, aby zapobiec wysyłaniu większej liczby wiadomości. Użytkownik może obejść tę zmianę interfejsu użytkownika, modyfikując JavaScript strony, ale każda próba wysłania wiadomości zakończy się niepowodzeniem, ponieważ jego token uwierzytelniający został cofnięty.
Aplikacja żąda nowego tokenu uwierzytelniania z serwera, jak opisano w sekcji Menedżer dostępu powyżej. Nowo przyznany token będzie odzwierciedlał nowe uprawnienia użytkownika, w tym tylko dostęp "do odczytu" do kanału "musicale".

W poprzednim artykule opisano "Składniki rozwiązania do moderacji" i wymieniono interfejsy API dostępne zarówno dla klienta, jak i serwera, korzystając z poniższej grafiki. Interfejsy API omówione w powyższych krokach są również pokazane na tej grafice.

Przykładowa aplikacja Chat SDK

Ten sam zapracowany zespół inżynierów odpowiedzialny za rozwój Channel Monitor i Chat SDK stworzył również przykładową aplikację napisaną w React Native, która korzysta z Chat SDK.

Próbka pokazuje możliwości SDK i najlepsze praktyki tworzenia realistycznej i w pełni funkcjonalnej aplikacji czatu przy użyciu PubNub. Jest to open source i część tego samego repozytorium GitHub, które zawiera Chat SDK pod /samples/react-native-group-chat.

Ta aplikacja została niedawno zaktualizowana, aby żądać tokenów z serwera Access Manager i żądać nowego tokena, gdy uprawnienia użytkownika ulegną zmianie, tj. zostaną zablokowane lub wyciszone z kanałów. To ulepszenie zostało wprowadzone od czasu napisania poprzedniego artykułu, więc pamiętaj, aby pobrać najnowsze źródło z GitHub. W chwili pisania tego tekstu najnowszy identyfikator zatwierdzenia git to ae9dfa0

Bezpieczne wyciszanie i banowanie użytkowników: Demo przy użyciu przykładowej aplikacji

W tej sekcji opisano, jak uruchomić nasze kompleksowe demo, pokazujące bezpieczną moderację zarówno z perspektywy klienta, jak i serwera.

Tworzenie zestawu kluczy PubNub

Zalecam utworzenie nowego zestawu kluczy PubNub, aby uruchomić to demo w następujący sposób:

Zaloguj się do portalu administratora i utwórz nową aplikację lub nowy zestaw kluczy w istniejącej aplikacji. W razie potrzeby możesz znaleźć instrukcje krok po kroku w naszym Jak utworzyć klucze portalu administracyjnego.
Na stronie zestawów kluczy włącz następujące opcje konfiguracji. Możesz zaakceptować ustawienia domyślne, chyba że określono inaczej:

App Context. Przechowuje on metadane o kanałach i użytkownikach i został opisany w poprzednim artykule na temat"Zarządzania użytkownikami i kanałami". Włącz także zdarzenia metadanych użytkownika, zdarzenia metadanych kanału i zdarzenia członkostwa.
Trwałość wiadomości. Przechowuje historię wiadomości w PubNub, dzięki czemu administrator może przeglądać i edytować konwersacje.
Menedżer dostępu. Zapobiega nieautoryzowanemu dostępowi do danych i jest wymagany do stworzenia bezpiecznego rozwiązania moderacji.
Obecność. Służy do śledzenia, czy użytkownik jest online czy offline.

Zapisz zmiany.

W kolejnych krokach potrzebne będą klucze Publish Key, Subscribe Key i Secret Key.

Tworzenie przykładowej aplikacji

Jak opisano wcześniej, aplikacja Chat SDK Sample jest wieloplatformową aplikacją kliencką napisaną w React Native przy użyciu frameworka Expo.

Sklonuj i zbuduj przykładową aplikację, postępując zgodnie z instrukcjami podanymi w readme aplikacji. W szczególności upewnij się, że masz zainstalowane wymagania wstępne, w tym yarn i Node.js. ReadMe mówi o korzystaniu z XCode i iOS, ale można również uruchomić aplikację na emulatorze Androida. W chwili pisania tego tekstu najnowszy identyfikator zatwierdzenia git to ae9dfa0

Podając klucze Pub/Sub, użyj kluczy wygenerowanych w poprzednim kroku. Jeśli nie umieścisz kluczy w pliku .env, aplikacja będzie domyślnie korzystać z niektórych kluczy demonstracyjnych; możesz wyłączyć tę logikę na stronie https://github.com/pubnub/js-chat/blob/ae9dfa0/samples/react-native-group-chat/App.tsx#L60, aby uniknąć nieporozumień.

Uruchom aplikację. ReadMe instruuje, aby uruchomić yarn ios, ale można również uruchomić yarn android lub yarn run start, z których ten ostatni daje interaktywne menu.

Po zalogowaniu w konsoli powinno pojawić się następujące ostrzeżenie:

Dzieje się tak, ponieważ klient nie połączył się z serwerem Access Manager, więc zbudujmy go.

Tworzenie przykładowego serwera Access Manager

Sample Access Manager Server można znaleźć pod adresem https://github.com/pubnub/js-chat/tree/master/samples/access-manager-api, jest to ten sam monorepo, co aplikacja kliencka omówiona wcześniej.

Otwórz plik src/chatsdk.service. ts w wybranym edytorze i wypełnij pola publishKey, subscribeKey i secretKey. Klucze publish i subscribe muszą być zgodne z tymi, których użyto do utworzenia aplikacji klienckiej, a klucz tajny jest dostępny na stronie zestawu kluczy dla aplikacji w portalu administratora

Z katalogu REPO/samples/access-manager-api uruchom polecenie yarn run start, aby uruchomić serwer Access Manager, a powinieneś zobaczyć coś takiego jak poniżej:

Aby zobaczyć, co robi serwer Access Manager, spójrz na app.service.ts. Zobaczysz struktury uprawnień wygenerowane dla żądającego użytkownika i wywołanie chat.sdk.grantToken() w celu zastosowania tych uprawnień, zwracając wygenerowany klucz authKey do klienta wywołującego.

Są to uprawnienia wymagane przez aplikację demonstracyjną, ale Twoja aplikacja prawdopodobnie będzie potrzebować innych uprawnień. Możesz użyć tego dostarczonego zestawu reguł jako szablonu początkowego, ale podczas tworzenia serwera Access Manager dla swojej aplikacji skonsultuj się z https://www.pubnub.com/docs/chat/chat-sdk/build/features/users/permissions, aby dokładnie zrozumieć, jakie uprawnienia są wymagane przez poszczególne funkcje Chat SDK.

Uruchom ponownie aplikację demonstracyjną klienta i powinieneś być teraz w stanie zalogować się bez błędów. Będziesz wiedział, że wszystko się powiodło, gdy otrzymasz toast "Authkey refreshed".

Zainicjuj rozmowę między dwoma klientami.

Wyciszanie i banowanie użytkowników za pomocą Monitora kanałów

Ważne: Jeśli wcześniej nie zainicjowałeś konwersacji między dwoma klientami, zrób to teraz. Kanały są tworzone dynamicznie przez aplikację demonstracyjną, więc będą wyświetlane w Channel Monitor dopiero po rozpoczęciu czatu.

Należy pamiętać, że wszelkie aktualizacje interfejsu użytkownika pokazane poniżej, takie jak baner "auth key refreshed" lub modal "banned user", są częścią aplikacji demonstracyjnej - Twoja aplikacja wyświetli te informacje użytkownikowi za pośrednictwem własnego interfejsu użytkownika.

Uruchom Channel Monitor, logując się do portalu administratora i wybierając zestaw kluczy użyty dla próbki Access Manager i aplikacji klienckiej.
Przejdź do sekcji BizOps Workspace w lewym panelu nawigacyjnym i wybierz Channel Monitor. Jeśli nie widzisz sekcji BizOps Workspace, prawie na pewno musisz zaktualizować swój plan PubNub, ale w razie jakichkolwiek problemów skontaktuj się z naszym działem pomocy technicznej.
Zostaniesz poproszony o wybranie kanałów do rozpoczęcia moderacji. Nazwa kanału będzie miała postać 1:1 użytkownik z USER_ID, gdzie USER_ID to nazwa użytkownika osoby, która zainicjowała konwersację.
Wiadomości na kanale będą wyświetlane w czasie rzeczywistym, w tym poprzednie wiadomości, jeśli w zestawie klawiszy włączona jest funkcja trwałości.

Wycisz użytkownika, naciskając przycisk mikrofonu obok wiadomości wysłanej przez tego użytkownika. Na urządzeniu wyciszonego użytkownika pojawi się komunikat informujący, że klucz autoryzacji został odświeżony. Próba wysłania wiadomości jako wyciszony użytkownik spowoduje wyświetlenie okna dialogowego z informacją, że jest to zabronione, ale nie ma to wpływu na niewyciszonego użytkownika.

Wyłącz wyciszenie użytkownika, naciskając ponownie przycisk mikrofonu. Na urządzeniu niewyciszonego użytkownika pojawi się komunikat informujący, że klucz autoryzacji został odświeżony i wysyłanie wiadomości będzie teraz możliwe.

Zbanuj użytkownika, naciskając przycisk bana obok wiadomości wysłanej przez tego użytkownika i podając powód bana. Powód jest tekstem swobodnym, więc możesz podać dowolne istotne informacje. Klucz autoryzacji zostanie odświeżony, a użytkownik powróci do ekranu wyboru czatu w swojej aplikacji.

Próba uzyskania dostępu do zablokowanego kanału spowoduje wyświetlenie błędu:

Odblokuj użytkownika, wybierając opcję "Usuń blokadę" w Monitorze kanałów. Klucz autoryzacji zostanie odświeżony. Użytkownik zostanie odbanowany i będzie mógł ponownie uzyskać dostęp do czatu.

Podsumowanie

Opracowanie dowolnej aplikacji cz atu to tylko pierwszy krok. Najtrudniejsze wyzwania pojawiają się po wdrożeniu aplikacji do obsługi rosnącej bazy użytkowników. BizOps Workspace to zestaw narzędzi zaprojektowanych do zarządzania każdym aspektem aplikacji czatu, upraszczając wyzwania po uruchomieniu.

Chociaż w tym artykule skupiliśmy się na bezpiecznym wyciszaniu i banowaniu użytkowników, nadal rozszerzamy funkcje BizOps Workspace. Ten artykuł skupiał się również wyłącznie na Chat SDK, ale Channel Monitor można również skonfigurować do pracy z dowolnym z naszych SDK.

Jeśli potrzebujesz pomocy lub wsparcia, skontaktuj się z naszym dedykowanym zespołem wsparcia lub napisz do naszego zespołu ds. relacji z programistami na adres devrel@pubnub.com.

Jak PubNub może ci pomóc?

Ten artykuł został pierwotnie opublikowany na PubNub.com

Nasza platforma pomaga programistom tworzyć, dostarczać i zarządzać interaktywnością w czasie rzeczywistym dla aplikacji internetowych, aplikacji mobilnych i urządzeń IoT.

Poznaj PubNub

Sprawdź Live Tour, aby zrozumieć podstawowe koncepcje każdej aplikacji opartej na PubNub w mniej niż 5 minut.

Rozpocznij konfigurację

Załóż konto PubNub, aby uzyskać natychmiastowy i bezpłatny dostęp do kluczy PubNub.

Rozpocznij

Dokumenty PubNub pozwolą Ci rozpocząć pracę, niezależnie od przypadku użycia lub zestawu SDK.

Jak dodać czat w czasie rzeczywistym do gry Unity

PubNub Developer Relations — Thu, 16 May 2024 21:08:11 +0000

Czat w czasie rzeczywistym lub czat w grze zwiększa zaangażowanie graczy i pomaga im pozostać w grze. Czat w czasie rzeczywistym pozwala graczom komunikować się ze sobą, wspierając poczucie wspólnoty i zapewniając platformę do interakcji społecznych, które sprawiają, że gra jest przyjemniejsza.

Włączenie czatu w czasie rzeczywistym jest łatwiejsze do powiedzenia niż do zrobienia. Aby zacząć od zera, potrzeba wielu zasobów do zbudowania, utrzymania i skalowania wraz ze wzrostem liczby graczy. Na szczęście PubNub sprawił, że wprowadzanie funkcji czasu rzeczywistego do gier Unity jest łatwiejsze niż kiedykolwiek dzięki naszej platformie API czasu rzeczywistego o niskim opóźnieniu. Niezależnie od tego, czy tworzysz gry dla systemów Windows, Mac, iOS, Android, systemów rzeczywistości wirtualnej, takich jak Oculus i Meta Quest, czy też korzystasz z wielu platform, nasz pakiet Unity SDK jest dla Ciebie.

Czytaj dalej, aby dowiedzieć się, jak dodać czat w czasie rzeczywistym do swojej gry wideo Unity za pomocą PubNub, zaczynając od zrozumienia, jak skonfigurować różne wzorce kanałów, nauczyć się wysyłać / odbierać wiadomości, a następnie ulepszyć / zabezpieczyć czat w grze za pomocą innych funkcji, takich jak moderacja, emotikony, reakcje i GIF-y.

Pierwsze kroki z PubNub

Zanim zaczniesz rozumieć, jak skonfigurować czat w grze, musisz zrozumieć platformę PubNub i jak skonfigurować aplikację, aby korzystać z jej funkcji.

Przegląd

PubNub opiera się na modelu Pub/Sub (publikuj/subskrybuj). Użytkownik publikuje wiadomość, która jest zasadniczo ładunkiem zawierającym wszystkie istotne informacje, w sieci PubNub. Użytkownicy, którzy chcą odebrać lub odsłuchać wiadomość, subskrybują sieć PubNub i analizują wiadomość. Wiadomość może zawierać wszystko, co chcesz, o ile ma mniej niż 32 KB (i najlepiej w formacie JSON).

Aby zapewnić, że wiadomość dotrze do właściwych odbiorców, kanały są używane jako mechanizm, za pośrednictwem którego dane są przesyłane z jednego urządzenia do drugiego. Kanały są wymagane za każdym razem, gdy urządzenie chce publikować i subskrybować sieć PubNub. Podczas gdy użytkownik może publikować tylko jedną wiadomość na raz, użytkownik może subskrybować wiele różnych kanałów na raz, nasłuchując różnych wiadomości.

Podczas gdy podczas publikowania wiadomości należy określić dokładną nazwę kanału, można subskrybować wiele kanałów jednocześnie za pomocą multipleksowania, czyli subskrybowania jednego lub więcej kanałów poprzez podanie nazw kanałów jako tablicy ciągów znaków.

Dlaczego te informacje są niezbędne? Cały system przesyłania wiadomości w grze będzie opierał się na koncepcji kanałów: _sposób formatowania i zabezpieczania nazwy wzorca kanału określa rodzaj cz_atu.

Instalacja i konfiguracja PubNub Unity SDK

Aby rozpocząć, musisz skonfigurować PubNub Unity SDK, aby połączyć swoją aplikację z siecią PubNub. Aby uzyskać szczegółowe informacje, zapoznaj się z dokumentacją Unity SDK, ale jako przegląd, będziesz musiał:

Dodać pakiet Unity za pośrednictwem Menedżera pakietów.
Utworzyć bezpłatne konto PubNub i uzyskać klucze PubNub. Ważne jest, aby włączyć funkcje w zestawie kluczy, których potrzebuje aplikacja - w przypadku podstawowych funkcji Pub/Sub wystarczy włączyć Stream Controller. Z pewnością omówimy wszelkie inne ustawienia, które mogą być potrzebne do skonfigurowania zaawansowanych funkcji.
Przekaż Unity klucze publikowania i subskrybowania uzyskane w poprzednim kroku, aby skonfigurować obiekt PubNub GameObject. Powinieneś również podać UserId, ponieważ każdy obiekt PubNub wymaga unikalnego identyfikatora w celu nawiązania połączenia z PubNub. Gdy to zrobisz, zainicjalizuj obiekt PubNub:

using PubnubApi;
using PubnubApi.Unity;
…
PubNub pubnub = new Pubnub(pnConfiguration);

Dodaj detektory zdarzeń dla swojej gry, aby reagować na zdarzenia i wiadomości. Istnieją różne detektory zdarzeń, aby móc zaimplementować niestandardową logikę reagowania na każdy rodzaj wiadomości lub zdarzenia, ale do podstawowej funkcjonalności wymiany wiadomości na czacie potrzebny będzie po prostu detektor zdarzeń wiadomości (w dalszej części tego przewodnika dowiesz się, jak dodać dodatkowe funkcje do czatu w czasie rzeczywistym, aby uczynić go bardziej angażującym):

var listener = new SubscribeCallbackListener();
pubnub.AddListener(listener);
listener.onMessage += OnPnMessage;
…
private void OnPnMessage(Pubnub pn, PNMessageResult<object> result) {
    Debug.Log($"Message received: {result.Message}");
}

Zanim zaczniesz publikować, aby wysyłać wiadomości do innych urządzeń i subskrybować, aby otrzymywać wiadomości od wydawców, musisz zdefiniować nazwę swojego kanału. Pamiętaj: sposób formatowania wzorca kanału określa typ czatu, który chcesz wdrożyć.

Definiowanie różnych wzorców czatu

Musisz rozważyć, jakie typy czatu będziesz musiał zaimplementować w swojej grze. Ta sekcja ma na celu omówienie wzorca kanału, a nie całej konfiguracji uzyskiwania wymaganych informacji z gry lub użytkowników. Jeśli chcesz zobaczyć różne wzorce czatu w projekcie Unity wykorzystującym PubNub, sprawdź naszą grę pokazową Unity.

Czat ogólny/globalny

Czat ogólny lub globalny umożliwia komunikację między wszystkimi graczami w grze. Możesz skonfigurować ogólny czat, publikując i subskrybując wiadomości za pomocą wspólnego kanału, który subskrybują wszyscy gracze. Można skonfigurować strukturę kanałów dla graczy globalnych:

string allChat = “global”;

Każdy klient będzie wtedy subskrybował kanał i zapewni, że wszyscy otrzymają te same wiadomości w czasie rzeczywistym, tworząc wspólny czat, którego każdy może być częścią.

Czat prywatny/szeptany

Czat prywatny lub szeptany pozwala graczom na prowadzenie rozmów jeden na jednego, w których tylko dwaj zaangażowani gracze mogą ze sobą rozmawiać i nikt inny. We wzorcu kanału czatu prywatnego lub szeptanego każdy użytkownik subskrybuje strukturę kanału przeznaczoną do rozmów prywatnych:

string privateChatBase= “chat.private.*”;

Wykorzystuje to koncepcję Wildcard Subscribe. Ta funkcja może być używana do subskrybowania hierarchicznej listy kanałów, gdzie można subskrybować wiele kanałów za pomocą pojedynczej deklaracji nazwy.

Na przykład, gdy użytkownik ma zamiar wysłać prywatną wiadomość do innego użytkownika, należy połączyć bieżący identyfikator użytkownika PubNub (lub UUID/uuid), który reprezentuje unikalny identyfikator identyfikujący użytkownika w sieci PubNub i identyfikator użytkownika zamierzonego odbiorcy wiadomości. Chociaż zawsze można uzyskać identyfikator użytkownika dla bieżącego użytkownika (poprzez pubnub.GetCurrentUserId()), należy uzyskać identyfikator użytkownika zamierzonego odbiorcy. Po uzyskaniu identyfikatora użytkownika odbiorcy można połączyć kanał w następujący sposób:

string privateChatMessage = “chat.private.user-a-uuid&user-b-uuid”;

Ponieważ określono wieloznaczny wzorzec kanału, taki jak chat.private.*, aplikacja zasubskrybuje wszystkie nazwy kanałów pasujące do tego wzorca. Dzięki temu nie trzeba zawsze znać nazwy kanału w czasie działania aplikacji. Wreszcie, użycie identyfikatorów użytkowników gwarantuje, że nazwa kanału będzie unikalna, a rozmowa pozostanie między dwoma użytkownikami.

Czat znajomy/kolega

Utworzenie czatu Friend lub Buddy pozwala graczom na prywatną komunikację z konkretnymi graczami, z którymi chcą nawiązać bliższą więź, niezależnie od tego, czy są to nowo poznani gracze, czy znajomi spoza gry.

We wzorcu czatu przyjaciel/kumpel należy utworzyć wzorzec kanału, który jest unikalny dla każdego urządzenia lub gracza, podobnie jak w przypadku tworzenia wzorca kanału czatu prywatnego poprzez dołączenie identyfikatora użytkownika:

string chanFriendChat = "chat.friends.” + pubnub.GetCurrentUserId();”

Następnie powtórz tę czynność dla każdego użytkownika, z którym chcesz się zaprzyjaźnić - zastąp ich identyfikatory użytkownika w łańcuchu chanFriendChat identyfikatorem pubnub.GetCurrentUserId(). Chociaż masz już gotowy wzorzec kanału, nie możesz po prostu zasubskrybować go za pomocą wzorca wieloznacznego, takiego jak chat.friends.*; zamiast tego będziesz potrzebować mechanizmu określającego, którzy gracze są przyjaciółmi.

Rozwiązaniem tego problemu są grupy kanałów PubNub, które pozwalają zarządzać dużą liczbą kanałów jednocześnie. Grupy kanałów są zasadniczo wskaźnikiem do listy kanałów; w tym przypadku grupa kanałów jest unikalna dla gracza i będzie zawierać odniesienie do wszystkich znajomych gracza:

string chanGroupFriendChat = "chanGroupFriendChat_" + pubnub.GetCurrentUserId();

Uwaga: Nazwy grup kanałów są zgodne z tymi samymi konwencjami, co nazwy kanałów, ale nie mogą zawierać kropek w nazwie, stąd różnica w strukturze wzorca.

Podobnie jak w przypadku subskrybowania kanałów za pomocą obiektu pubnub (wyjaśnione w następnej sekcji), można również subskrybować grupy kanałów w tym samym czasie. Oznacza to, że skoro gracz jest subskrybowany do grupy kanałów swoich znajomych, to za każdym razem, gdy dodawany jest nowy znajomy, chanFriendChat tego znajomego jest dodawany do grupy kanałów znajomych gracza i będzie otrzymywał wiadomości w detektorze zdarzeń Message za każdym razem, gdy którykolwiek z tych kanałów opublikuje wiadomość. Chociaż nie można publikować w grupie kanałów, można po prostu opublikować wiadomość na dowolnym z powiązanych kanałów w grupie kanałów, a każdy subskrybent (znajomy) otrzyma tę wiadomość.

Korzystając z interfejsu API Channel Groups dla PubNub Unity SDK, możesz dodawać, wyświetlać i usuwać znajomych/kanały z grup kanałów, do których masz uprawnienia. Funkcja Channel Groups jest również używana do określania, kiedy znajomi są online/offline, znanego jako Obecność. Zostanie to szczegółowo omówione w naszym szczegółowym przewodniku Jak dodać listę znajomych w Unity.

Czat gildii/sojuszu/klanu

W grach, w których występują gildie, sojusze lub klany, dedykowane środowisko czatu może znacznie poprawić koordynację zespołu i koleżeństwo. Ten styl czatu grupowego umożliwia komunikację między wieloma użytkownikami, promując współpracę i pracę zespołową wśród większej liczby graczy niż tylko twoi znajomi. Czat gildii/sojuszu/klanu pozwala członkom tej samej grupy planować strategie, dzielić się osiągnięciami lub po prostu tworzyć bardziej osobistą społeczność w grze.

Konfiguracja czatu w PubNub jest taka sama, jak w przypadku czatu ze znajomymi. Należy utworzyć grupy kanałów dla każdego typu, zasubskrybować te grupy kanałów i dodać znajomych do tych grup kanałów po uzyskaniu autoryzacji. Wszelkie wiadomości publikowane na kanale powiązanym z tymi grupami kanałów będą wyzwalać detektor zdarzeń i można odpowiednio wyświetlić czat.

Grupy kanałów to świetny sposób na zarządzanie dużymi grupami, ponieważ grupa kanałów każdego gracza może zarządzać 2000 kanałów (w tym przypadku graczy), co jest więcej niż wystarczające nawet dla największych gildii w masowych grach online. Co więcej, każdy indywidualny klient podłączony do sieci PubNub może mieć 10 grup kanałów, co oznacza, że w razie potrzeby masz dostęp do subskrypcji 20 000 kanałów.

Czat Party/Lobby

Czaty Party lub Lobby są przeznaczone dla małych, tymczasowych grup utworzonych na potrzeby konkretnej sesji gry lub misji. Chociaż te style czatu są przeznaczone do różnych celów, ich implementacja jest podobna do wzorca tworzenia prywatnego/szeptanego kanału czatu.

Najpierw należy utworzyć ciąg bazowy dla każdego z typów czatu grupowego. Kiedy subskrybujesz tablicę kanałów (omówioną w następnym kroku), będziesz subskrybować za pomocą symboli wieloznacznych, aby nasłuchiwać wszystkich żądań:

string chanChatParty = “chat.party.” + “*”;
string chanChatLobby= “chat.lobby.” + “*”;

Po utworzeniu lobby lub grupy, gracz zostaje wyznaczony jako lider lub właściciel grupy, niezależnie od tego, czy zainicjował grupę, czy też został określony na podstawie połączenia internetowego i regionu. Tego typu gracze nazywani są liderami lub gospodarzami. Następnie należy połączyć identyfikator użytkownika gracza-gospodarza z ciągiem bazowym, tworząc unikalny wzorzec kanału. Każdy nowy gracz, który zostanie zaproszony do dołączenia do imprezy lub lobby, będzie dynamicznie subskrybował te kanały, skutecznie dołączając do grupy. Kanał można następnie usunąć po zakończeniu lub rozwiązaniu imprezy lub lobby.

Łączenie wszystkiego w całość

Po określeniu typów czatu, które chcesz zaimplementować w swojej grze w oparciu o wzorzec kanału, nadszedł czas, aby wysyłać i odbierać wiadomości w czasie rzeczywistym, publikując i subskrybując te kanały.

Publikowanie wiadomości

Proces rozpoczyna się od stworzenia ładunku wiadomości. Może to być prosty czat tekstowy lub bardziej złożone struktury danych, w zależności od wymagań gry Unity. Gdy ładunek jest gotowy, nadszedł czas, aby opublikować wiadomość.

Interfejs API Publish służy do wysyłania wiadomości do wszystkich subskrybentów określonego kanału czatu. Chociaż możesz publikować tylko na jednym kanale naraz, publikowanie odbywa się asynchronicznie, więc nie blokuje wykonywania reszty kodu (chociaż nadal możesz publikować synchronicznie, jeśli chcesz).

Na przykład, jeśli chcesz wysłać wiadomość czatu do strony, wykonaj następujące wywołanie, aby nie tylko opublikować, ale także określić, czy połączenie PubNub zostało pomyślnie wykonane (i obsłużyć, gdy połączenie się nie powiodło):

PNResult<PNPublishResult> publishResponse = await pubnub.Publish()
  .Message(“Ready to go!”)
  .Channel(chanChatParty )
  .ExecuteAsync();
PNPublishResult publishResult = publishResponse.Result;
PNStatus status = publishResponse.Status;
Debug.Log("pub timetoken: " + publishResult.Timetoken.ToString());
Debug.Log("pub status code : " + status.StatusCode.ToString());

Subscribe to Messages

Gdy wiadomości są publikowane, musimy zasubskrybować odpowiednie kanały, aby otrzymywać wszelkie przychodzące wiadomości i zdarzenia. Możesz subskrybować wiele kanałów czatu i grup kanałów za pomocą jednego połączenia:

pubnub.Subscribe<string>()
  .Channels(new List<string>() {
    chanChatAll,
    chanPrivateChat,
    chanChatParty + "*",
    chanChatLobby + "*"               
})
  .ChannelGroups(new List<string>() {
    chanFriendGroupChat + userId,
    chanGuildGroupChat + userId,
    chanAllianceGroupChat + userId
})
.Execute();

Odtwarzacz jest teraz podłączony do sieci PubNub, a nasłuchiwacze zdarzeń czekają na wystąpienie zdarzenia - w tym przypadku nadejście nowej wiadomości - a następnie wykonują kod powiązany z tym zdarzeniem.

Gdy nadejdzie wiadomość, słuchacz uruchamia wywołanie zwrotne, wykonując kod napisany do obsługi wiadomości przychodzących. Może to być tak proste, jak wyświetlenie wiadomości w pokoju czatu, lub coś bardziej złożonego, jak wyzwalanie zdarzeń w grze na podstawie wiadomości czatu.

Zaawansowane funkcje sprawiające, że czat w grze jest angażujący

Dobra robota - udało ci się zaimplementować czat w grze Unity, aby gracze mogli wysyłać i odbierać wiadomości w czasie rzeczywistym! Chociaż już teraz tworzy to przestrzeń dla graczy do wzajemnej interakcji, zaimplementowana funkcjonalność to tylko wierzchołek góry lodowej - istnieje wiele funkcji, które warto rozważyć, aby czat w grze był bardziej angażujący dla graczy.

Wczytywanie historii wiadomości: Trwałość wiadomości

W grze gracze mogą potrzebować powrócić do poprzednich rozmów lub nadrobić zaległości w pominiętych czatach. W tym miejscu pojawia się Message Persistence, umożliwiając zapisywanie i pobieranie historii wiadomości czatu. Wdrożenie interfejsu API Message Persistence w grze Unity umożliwia przechowywanie i pobieranie wiadomości czatu, akcji wiadomości i plików w razie potrzeby:

PNResult<PNFetchHistoryResult> fetchHistoryResponse = await pubnub.FetchHistory()
  .Channels(new string[] { chanPrivateChat })
  .IncludeMeta(true)
  .MaximumPerChannel(25)
  .ExecuteAsync();

Zapewniamy również elastyczność w kontrolowaniu czasu przechowywania wiadomości, umożliwiając zarządzanie pamięcią masową w oparciu o konkretne potrzeby i zasoby gry. Aby móc korzystać z Message Persistence, musisz włączyć tę funkcję w portalu administracyjnym dla swoich kluczy. Możesz dowiedzieć się więcej o tej funkcji, a także o tym, jak ją włączyć, postępując zgodnie z naszym przewodnikiem dotyczącym trwałości wiadomości.

Powiadamianie graczy o nieodebranych wiadomościach: Mobilne powiadomienia push

W przypadku gier mobilnych gracze mogą często wchodzić i wychodzić z aplikacji i mogą przegapić kluczowe wiadomości od swojej drużyny lub aktualizacje z gry. W tym miejscu do gry wkraczają mobilne powiadomienia push. Zapewniają one sposób na informowanie graczy o nieodebranych wiadomościach na czacie, aktualizacjach gry lub innych ważnych powiadomieniach, nawet gdy nie są oni aktywnie w grze.

Dzięki interfejsowi Mobile Push Notifications API zapewniamy ujednolicony interfejs API do wysyłania powiadomień push na urządzenia z systemem iOS i Android. Upraszcza to proces i umożliwia wysyłanie pojedynczego wywołania API w celu powiadomienia wszystkich urządzeń, niezależnie od platformy. Powiadomienia push można również dostosować do własnych potrzeb, na przykład wysyłając spersonalizowane powiadomienia do poszczególnych graczy lub rozgłaszając wiadomość do wszystkich graczy. Ta elastyczność pozwala skutecznie komunikować się z graczami, utrzymując ich zaangażowanie i informacje.

Aby móc korzystać z powiadomień Mobile Push w PubNub, należy je włączyć, postępując zgodnie z naszym przewodnikiem w portalu administratora. Mamy również bardziej szczegółowe instrukcje dotyczące powiadomień mobilnych FCM i APN.

Więcej niż tylko słowa: Emoji

Emoji służą jako uniwersalny język emocji w komunikacji cyfrowej. Pozwalają graczom wyrazić swoje uczucia i reakcje w zabawny i kolorowy sposób, czyniąc czat bardziej interaktywnym i wciągającym.

Dzięki PubNub możesz łatwo zaimplementować obsługę emoji w swojej grze Unity, pozwalając graczom publikować sygnały, a nie wiadomości. Sygnały są przeznaczone do wysyłania małych fragmentów danych, ponieważ ich wysyłanie jest znacznie szybsze i tańsze niż wiadomości. Ponieważ emoji są zazwyczaj bardzo małe pod względem rozmiaru danych, jest to doskonały sposób na szybkie wysyłanie danych.

Możesz użyć interfejsu API PubNub Signals, aby opublikować emoji na określonym czacie. Na przykład, jeśli gracz chce wysłać machające emoji do globalnego czatu, po naciśnięciu przycisku Wyślij zostanie wykonany następujący kod:

Dictionary<string, string> myMessage = new Dictionary<string, string>();
myMessage.Add("emoji", ":wave:");
pubnub.Signal()
  .Message(myMessage)
  .Channel("global")
  .Execute((result, status) => {
    if (status.Error) {
      Debug.Log(status.ErrorData.Information);
    } else {
      Debug.Log(result.Timetoken);
    }
  });

Zamierzeni odbiorcy otrzymają sygnał, jeśli są subskrybentami określonego kanału. W tym przypadku, ponieważ jest to kanał globalny, wszyscy otrzymają emoji. Aby móc nasłuchiwać sygnałów, należy zasubskrybować zdarzenie nasłuchiwania:

listener.onSignal += OnPnSignal;
private void OnPnSignal(Pubnub pn, PNSignalResult<object> result) {
    // Handle the emoji by looking up the value and displaying the result.
}

Musisz upewnić się, że wartość emoji reprezentuje rzeczywiste emoji zdefiniowane w Unity. Te emoji mogą być przechowywane i pobierane w sieci PubNub za pośrednictwem App Context (wcześniej znanego jako Objects), dzięki czemu wszelkie emoji, do których gracz ma dostęp, mogą być pobierane z bezserwerowej pamięci masowej. Więcej informacji na temat implementacji App Context w grze Unity można znaleźć w naszym poradniku.

Odpowiadanie na wiadomości: Reakcje na wiadomości

Reakcje na wiadomości, takie jak polubienia, serduszka, kciuki w górę, naklejki lub niestandardowe reakcje specyficzne dla gry, zapewniają graczom szybki i łatwy sposób reagowania na wiadomości na czacie. Nie tylko dodają one interaktywności do czatu, ale także wzmacniają poczucie wspólnoty, umożliwiając graczom wzajemne potwierdzanie i angażowanie się w wiadomości.

Interfejs API Message Actions aplikacji PubNub umożliwia tworzenie funkcji takich jak reakcje i potwierdzenia odczytu, a także powiązanie niestandardowych metadanych z wiadomościami. Podobnie jak aplikacje do czatowania, takie jak Discord, mają różne reakcje i emotikony dla różnych serwerów, tak samo może być w przypadku różnych typów czatu. Możesz pobrać dostępne reakcje na wiadomości dla określonego kanału czatu za pomocą następującego wywołania podczas ładowania czatu:

pubnub.GetMessageActions()
  .Channel(chanChatLobby)
  .Execute(new PNGetMessageActionsResult((result, status) => 
  {
    //result is of type PNGetMessageActionsResult.
  }));

Gdy gracz ma odpowiedzieć na wiadomość za pomocą reakcji, można to zrobić, dodając reakcję wiadomości do opublikowanej wiadomości:

pubnub.AddMessageAction()
  .Channel(chanChatLobby)
  .MessageTimetoken(5610547826969050)
  .Action(new PNMessageAction { Type = "reaction", Value = "smiley_face" })
  .Execute(new PNAddMessageActionResult((result, status) =>
  {
    //result is of type PNAddMessageActionResult.
  }));

PubNub używa tokenów czasowych do dokładnego śledzenia, kiedy wiadomość została opublikowana w sieci. Kiedy otrzymujesz wiadomości, czas jest również zawarty w ładunku. Następnie można podać odpowiednią wartość tokena czasu w argumencie MessageTimetoken(), aby móc zareagować na wiadomość.

Aby móc nasłuchiwać reakcji i powiadomić gracza, który wysłał oryginalną wiadomość, należy dodać słuchacza i obsłużyć reakcję w metodzie OnPNMessageAction:

listener.onMessageAction += OnPnMessageAction;
…
private void OnPnMessageAction(Pubnub pn, PNMessageActionEventResult result) {
   //Handle Message Reaction
}

Podobnie jak w przypadku emoji, można użyć App Context, aby pobrać i przechowywać sposób, w jaki te reakcje są wizualnie reprezentowane w grze. Aby móc korzystać z Message Reactions, musisz upewnić się, że Message Persistence jest włączone dla twoich kluczy w Admin Portal.

GIF-y i inne multimedia

Kolejną ważną funkcją, która zwiększa komfort korzystania z czatu, jest udostępnianie plików multimedialnych. Niezależnie od tego, czy chodzi o udostępnianie GIF-ów, zrzutów ekranu z zabawnych momentów, czy nawet udostępnianie zasobów gry, udostępnianie plików wprowadza kolejny poziom interakcji do gry.

Wdrażanie tego typu plików multimedialnych wykorzystuje PubNub File Sharing API. Dzięki tej funkcjonalności gracze mogą przesyłać, pobierać i usuwać pliki, do których mają dostęp. Aby móc wysłać plik, należy wykonać następujące połączenie:

PNResult<PNFileUploadResult> fileUploadResponse = await pubnub.SendFile()
  .Channel(string chanFriendChatSamantha)
  .File("cat_picture.jpg") //checks the bin folder if no path is provided
  .Message("Look at this photo!")
  .ExecuteAsync();
PNFileUploadResult fileUploadResult = fileUploadResponse.Result;
PNStatus fileUploadStatus = fileUploadResponse.Status;
if (!fileUploadStatus.Error && fileUploadResult != null)
{
  Debug.Log(pubnub.JsonPluggableLibrary.SerializeToJsonString(fileUploadResult));
}
else
{
  // Handle File Upload Error.
}

Aby subskrybenci mogli nasłuchiwać pliku, należy dodać detektor zdarzeń i obsłużyć sposób wyświetlania pliku w metodzie OnPNFile:

listener.onFile += OnPnFile;
…
private void OnPnFile(Pubnub pn, PNFileEventResult result) {
    //Handle how to display the file received
}

Można również uzyskać, wyświetlić listę informacji i usunąć dowolny plik powiązany z różnymi kanałami czatu. Będziesz musiał upewnić się, że włączyłeś funkcję udostępniania plików w portalu administracyjnym, a także Message Persistence. Możesz dowiedzieć się więcej o tym, jak to zrobić w naszym przewodniku Włączanie plików.

Zabezpieczanie kanałów czatu: Menedżer dostępu

W każdym środowisku gier zapewnienie bezpieczeństwa kanałów czatu jest sprawą najwyższej wagi. Niezależnie od tego, czy chodzi o ochronę graczy przed niechcianymi wiadomościami, czy o ochronę wrażliwych dyskusji strategicznych, system czatu w grze Unity musi być zaprojektowany z myślą o bezpieczeństwie.

W tym miejscu pojawia się menedżer dostępu PubNub. Zapewnia on solidną i elastyczną strukturę do zabezpieczania kanałów czatu. Dzięki Access Manager możesz kontrolować, kto może publikować lub subskrybować każdy z twoich kanałów, dodając dodatkową warstwę zabezpieczeń do systemu czatu w twojej grze Unity.

Access Manager umożliwia przyznawanie uprawnień na poziomie użytkownika, kanału, a nawet na poziomie poszczególnych kluczy. Możesz określić, czy użytkownik może odczytywać, zapisywać lub zarządzać kanałem, a uprawnienia te mogą być dynamicznie aktualizowane wraz ze zmianą potrzeb gry. Na przykład na prywatnym czacie między dwoma graczami możesz przyznać tylko tym dwóm graczom uprawnienia do odczytu i zapisu na ich prywatnym kanale. Podobnie, na czacie gildii można nadać uprawnienia do odczytu i zapisu wszystkim członkom gildii, a uprawnienia do zarządzania tylko liderowi gildii.

Access Manager obsługuje również uwierzytelnianie oparte na tokenach, umożliwiając bezpieczne uwierzytelnianie użytkowników i przyznawanie im odpowiednich uprawnień. Zapewnia to, że tylko autoryzowani gracze mogą uzyskać dostęp do kanałów czatu w grze, chroniąc społeczność gry przed potencjalnymi zagrożeniami.

Aby móc korzystać z tej funkcji, należy włączyć Menedżera dostępu w Portalu administratora. Możesz dowiedzieć się więcej o tym, jak to zrobić, postępując zgodnie z tą stroną wsparcia dotyczącą włączania tej dodatkowej funkcji.

Co dalej

W tym poradniku dowiedziałeś się, jak dodać solidny system czatu w czasie rzeczywistym do swojej gry Unity. Omówiliśmy wszystko, od inicjalizacji obiektu PubNub w środowisku, po konfigurację wzorca czatu, który reprezentuje różne typy czatu, a następnie wysyłanie i odbieranie wiadomości. Dowiedziałeś się nawet, jak zaimplementować zaawansowane funkcje, takie jak emotikony, reakcje na wiadomości i udostępnianie plików, a także ważne aspekty każdego dobrego systemu czatu z trwałością wiadomości, mobilnymi powiadomieniami push i bezpieczeństwem kanałów.

Niezależnie od tego, czy jesteś niezależnym deweloperem pracującym nad swoją pierwszą grą, czy doświadczonym deweloperem, który chce ulepszyć swoją grę wieloosobową, funkcjonalność PubNub w czasie rzeczywistym może służyć jako infrastruktura do obsługi czatu w grze, dzięki czemu możesz skupić się na tym, co najważniejsze.

Dowiedz się więcej, korzystając z poniższych zasobów:

Przeczytaj naszą dokumentację Unity, aby dowiedzieć się wszystkiego, co musisz wiedzieć o dodawaniu czatu w czasie rzeczywistym do swojej gry.
Dowiedz się, jak dodać listę znajomych, korzystając z naszego przewodnika Unity.
Dowiedz się, jak nasza gra pokazowa Un ity wykorzystuje wzorce czatu do zarządzania pokojami rozmów i nie tylko.
Zanurz się w kodzie źródłowym Unity SDK.

W razie jakichkolwiek pytań lub wątpliwości zachęcamy do kontaktu z zespołem ds. relacji z deweloperami pod adresem devrel@pubnub.com.

Jak skonfigurować Illuminate dla swojej gry?

PubNub Developer Relations — Wed, 15 May 2024 23:04:16 +0000

Czym jest Illuminate?

PubNub Illuminate to rozwiązanie do podejmowania decyzji i działania w czasie rzeczywistym, oparte na analizie i śledzeniu danych gry na żywo. Illuminate daje ci możliwość mapowania kluczowych wskaźników wydajności, które są ważne dla twojej gry, uruchamiania decyzji w oparciu o zachowania użytkowników i natychmiastowego sprawdzania wyników - a wszystko to bez konieczności angażowania zespołu inżynierów. Dzięki Illuminate możesz natychmiast podejmować inteligentne decyzje oparte na danych, gdy w czasie rzeczywistym zachodzą interakcje i rozgrywka, aby napędzać wzrost i optymalizować wydajność swojej gry.

W tym samouczku dowiesz się więcej o Illuminate, dlaczego jest to ważne dla sukcesu twojej gry (i twojego studia) oraz jak skonfigurować Illuminate, aby podejmować decyzje w czasie rzeczywistym, które wyzwalają działania w oparciu o dane twojej gry.

Dlaczego Illuminate dla gier?

W przypadku większości tradycyjnych narzędzi analitycznych podejmowanie działań na podstawie danych w czasie rzeczywistym jest zazwyczaj reaktywne. Dostosowania, takie jak zmiany cen w oparciu o opinie graczy, są utrudnione przez długie cykle poprawek, które obejmują gromadzenie danych, testowanie i wdrażanie na różnych platformach, co dodatkowo odciąga zasoby od rozwoju i tworzenia przyszłych treści. Istnieje krytyczna potrzeba wglądu w czasie rzeczywistym w zaangażowanie graczy i monetyzację, aby umożliwić podejmowanie szybkich decyzji taktycznych, ponieważ przydatne informacje stają się nieskuteczne, jeśli są opóźnione nawet o kilka godzin po wystąpieniu zdarzenia.

Illuminate to niskokodowy, konfigurowalny produkt, który umożliwia menedżerom gier i analitykom danych natychmiastowe zastosowanie i ocenę wpływu ich strategicznych decyzji. Illuminate umożliwia zespołom dokonywanie w locie korekt balansu gry, bardziej skutecznych i odpowiednich strategii monetyzacji poprzez eksperymenty w czasie rzeczywistym oraz spersonalizowane nagrody dla graczy w celu poprawy retencji i doświadczenia gracza, a wszystko to przy jednoczesnym wykrywaniu nieuczciwych działań bez obciążania twórców gier.

Dzięki Illuminate możesz zarządzać swoją platformą i podejmować działania w czasie rzeczywistym:

Uruchamiać ukierunkowane eksperymenty monetyzacji w kanałach i widzieć natychmiastowe wyniki
Natychmiastowe wysyłanie spersonalizowanych rekomendacji na podstawie działań graczy.
Wyzwalaj działania w oparciu o zachowania użytkowników lub kohorty i obserwuj natychmiastowe wyniki.
Lepsze wykrywanie oszustw oraz identyfikacja i reagowanie na podejrzane zachowania w czasie rzeczywistym.
Dostosowywanie i eksperymentowanie z cenami przedmiotów w sklepie w grze. Dostosuj ceny, jeśli gracze kupują wiele takich samych przedmiotów i uruchamiaj wydarzenia w grze, aby wpłynąć na wszystkie ceny w sklepie.
Nagradzaj graczy za ukończenie wyzwań/osiągnięć kodami rabatowymi na przedmioty w grze. Dostosuj miejsca, w których gracze spędzają najmniej czasu i rozważ nagradzanie graczy za spędzanie czasu w tym obszarze lub zmianę rodzaju nagród otrzymywanych przez graczy.
Pojawianie się przydatnych przedmiotów i dostosowywanie podstawowych funkcji rozgrywki w locie, bez konieczności bugowania inżynierów.

Możesz dowiedzieć się więcej o tym, jak Illuminate zasila gry, oglądając nasz film Illuminate for Gaming.

Jak skonfigurować Illuminate dla swojej gry

Zanim przejdziesz do konfiguracji Illuminate dla swojej gry, musisz zrozumieć kilka kluczowych terminów używanych podczas konfiguracji. Illuminate składa się z następujących trzech modułów:

Obiekt biznesowy: Sposób pobierania danych do Illuminate. Możesz definiować, tworzyć i aktywować obiekty biznesowe, które są kontenerami do przechwytywania danych z wybranych aplikacji i zestawów kluczy. Za pomocą szeregu opcji (miar, wymiarów lub metryk) możesz zdecydować, które konkretne dane chcesz śledzić w czasie rzeczywistym i jak chcesz je agregować.
Decyzja: Miejsce, w którym podejmowane są działania na podstawie utworzonych metryk. Można to zrobić, definiując reguły z warunkami, które muszą być spełnione, oraz akcje uruchamiane za każdym razem, gdy te reguły są spełnione.
Dashboard: Miejsce wizualizacji metryk utworzonych w Business Objects i akcji wykonanych w Decisions za pomocą wykresów i dashboardów (zbiorów wykresów).

Teraz, gdy zdefiniowaliśmy kluczową terminologię, integracja Illuminate z grą składa się z sześciu kroków:

Zrozumienie schematu wiadomości
Wybierz, skąd pochodzą dane.
Wybór danych
Wizualizacja danych
Wykorzystanie danych do pracy
Wizualizacja i wprowadzanie zmian

Zrozumienie schematu wiadomości

Zrozumienie schematu danych w grze ma kluczowe znaczenie. Oznacza to identyfikację typów danych, które chcesz śledzić i analizować, takich jak działania graczy, transakcje w grze i zdarzenia systemowe. Dzięki zrozumieniu i udokumentowaniu tego, co dokładnie zawiera ładunek, programiści mogą zapewnić, że analitycy i inni członkowie zespołu mogą skutecznie mapować dane do odpowiednich źródeł za pomocą JSONPath. Zrozumiesz, dlaczego jest to ważne przy wyborze danych podczas tworzenia obiektów biznesowych.

Wybór źródła danych

Illuminate może być używany z każdą grą, która łączy się online, niezależnie od tego, czy PubNub ją zasila, czy nie. Jeśli PubNub zasila infrastrukturę gry, wystarczy wybrać odpowiednią aplikację i zestaw kluczy używany w grze podczas tworzenia obiektu biznesowego (więcej na ten temat wkrótce) w portalu administracyjnym.

Jeśli twoja gra nie jest obsługiwana przez PubNub, dane mogą być przesyłane za pomocą interfejsu API Fire, za pośrednictwem interfejsu API REST lub jednego z naszych zestawów SDK. Punkt końcowy Fire umożliwia klientowi wysyłanie wiadomości do programów obsługi zdarzeń Functions. Wiadomości te trafią bezpośrednio do wszystkich programów obsługi zdarzeń zarejestrowanych na kanale, do którego wysyłasz wiadomość, i uruchomią ich wykonanie.

Aby korzystać z PubNub Fire API, należy utworzyć konto PubNub i skonfigurować zestaw kluczy z funkcjami potrzebnymi w grze. Ten zestaw kluczy zawiera klucze publikowania i subskrypcji niezbędne dla Fire API. Możesz dowiedzieć się, jak to zrobić, postępując zgodnie z naszym przewodnikiem.

Wybierz swoje dane: Obiekty biznesowe

Obiekty biznesowe mają fundamentalne znaczenie w Illuminate. Są to kontenery na dane, których chcesz używać do podejmowania decyzji i wizualizacji w programie Illuminate, i zasadniczo są sposobem pobierania danych do programu Illuminate.

Obiekt biznesowy składa się z trzech elementów:

Wybór danych (miary i wymiary)
Źródło danych (skąd pochodzą dane)
Warunki (metryki)

Chociaż nie jest to związane z bazami danych, pomaga myśleć o strukturze obiektu biznesowego w kategoriach SQL SELECT (miary i wymiary), FROM (źródło danych), WHERE (metryki). Podczas tworzenia obiektów biznesowych należy postępować zgodnie z dokumentacją w celu uzyskania szczegółowych informacji lub obejść, o których należy pamiętać.

Wybór danych

Istnieją dwa różne typy wartości, które można wybrać dla obiektu biznesowego: Miary i Wymiary.

Miary to wartości liczbowe, ilościowe. Przykłady miar obejmują czas trwania gry, liczbę monet, liczbę zabójstw, obrażenia broni lub wartość zamówienia.

Wymiary to wartości jakościowe, takie jak język gracza, wybrane kosmetyki, typ zadania, wybrany typ broni lub poziom gry.

W zależności od typu danych, które chcesz śledzić, musisz zmapować dane do swoich miar i wymiarów za pomocą JSONPath. Illuminate musi wiedzieć, gdzie szukać, aby rozpocząć przechwytywanie tych danych ze źródła danych (skonfigurowanego w poprzednim kroku). Aby zdefiniować źródło danych, wybierz przycisk Mapuj obok każdej miary i wymiaru i podaj odpowiednie ścieżki JSON.

Jest to najtrudniejsza część konfiguracji Business Objects, ponieważ musisz zrozumieć schemat wiadomości. Ponieważ schemat komunikatów został udokumentowany lub zrozumiany wcześniej, należy zmapować go do sposobu, w jaki Iluminate szuka danych.

Jeśli przechwytujesz komunikaty (w szczególności Publish Message API), Illuminate szuka następującej struktury. Jeśli Twoja infrastruktura nie jest obsługiwana przez PubNub, Twoje dane będą musiały zostać zmapowane w tej samej strukturze, co Publish Message API:

{
 "message":{ // data from the published message
   "body": JSON | message body payload defined by you
   "meta": JSON | meta query params defined by you
   "userId": string | user ID a.k.a UUID / sender ID
   "channel": string | the channel on which the message is published
 },
}

Aby poprawnie zmapować miarę lub wymiar, należy podać obiekt komunikatu, a następnie inne pole. Będzie on zawsze miał następującą strukturę: $.message.{obligatory-secondary-field}.{optional-further-fields}.

Sposób mapowania danych jest całkowicie oparty na strukturze wiadomości. Oto kilka przykładów mapowania danych dla wiadomości:

Śledź liczbę monet (wymiar) => $.message.meta.coins
Wyposażony przedmiot kosmetyczny (wymiar) => $.message.body
Nazwa kanału (wymiar) => $message.channel
Zadane obrażenia (miara) => $.message.body[6]
Uzyskanie określonych nazw użytkowników (wymiar) => $.message.userId
Liczba znajomych (miara) => $.message.body.user.friends_count

Illuminate może również przechwytywać dane przy użyciu PubNub App Context, który umożliwia przechowywanie metadanych o kanałach, członkach kanałów, członkach kanałów i użytkownikach wysyłanych przez sieć PubNub. Dostęp do tych informacji można uzyskać, śledząc dokładnie, w jaki sposób Illuminate przechwytuje te dane.

{
 "user": { // data from the sending user metadata, can be null
   "externalId": string | user’s external ID
   "type": string | user type
   "status": string | user status
   "custom": JSON | JSON user metadata defined by you
 },
 "channel":{ // data from the channel the message is sent on, can be null
   "name": string | channel name
   "type": string | channel type
   "status": string | channel status
   "custom": JSON | JSON channel metadata defined by you
 },
 "membership":{ // data from the user's membership to the channel, can be null
   "status": string | membership status
   "custom": JSON | JSON membership metadata defined by you
 }
}

Podobnie jak w przypadku komunikatów, aby poprawnie zmapować miarę lub wymiar, należy podać obiekt użytkownika, kanału lub członkostwa, a następnie co najmniej jeden klucz z pliku JSON. Będzie on zawsze miał następującą strukturę: $.user.{obligatory-secondary-field}.{optional-further-fields}. Oto kilka przykładów mapowania danych dla App Context:

Shop Item Details (wymiar) => $.channel.custom.details
Status listy znajomych (wymiar) => $.membership.status
Język gracza (wymiar) => $.user.custom.language
Średni wynik gracza (wymiar) => $.user.custom.team_deathmatch_score

Uwaga: Aby utworzyć obiekt biznesowy, należy dodać co najmniej jeden wymiar lub jedną miarę.

Źródło danych

Po zmapowaniu miar i wymiarów należy określić, skąd pochodzą dane. To jest to, co zostało określone wcześniej. Pamiętaj, aby wybrać odpowiednią aplikację i zestaw kluczy, które zdefiniowałeś wcześniej, aby upewnić się, że program Illuminate przechwytuje dane z właściwego źródła.

Warunki (metryki)

Po wybraniu źródła danych można dodać warunki zwane metrykami. Analogicznie do instrukcji WHERE w SQL, metryki nie są wymagane do przechwytywania danych przez Business Objects, ale są niezwykle przydatne do filtrowania i stosowania obliczeń do miar i wymiarów. Należy pamiętać, że metryki są wymagane do tworzenia decyzji lub wizualizacji na pulpitach nawigacyjnych za pomocą wykresów (więcej na ten temat później).

Podczas tworzenia metryk należy przypisać i wybrać pola do filtrów. Jest kilka pól, na które należy zwrócić uwagę:

Nazwij swoją metrykę, która ma sens, ponieważ wykres do wizualizacji danych na pulpicie nawigacyjnym będzie miał taką samą nazwę.
Wybierając funkcję, miary można obecnie agregować za pomocą SUM, AVG, MAX i MIN. Wymiary mogą wykorzystywać tylko funkcję COUNT. Wybór funkcji umożliwia wybranie miary lub wymiaru z listy rozwijanej.
W polu Okres należy wybrać okno agregacji lub okres dla funkcji.
Upewnij się, że wybrałeś wymiary, które mają być dostępne na wykresach i w decyzjach (ponieważ nie będziesz mógł segmentować na wykresach i stosować ich do reguł w decyzjach bez wybrania ich później).
Filtrowanie określonych wiadomości lub danych App Context na podstawie różnych wymiarów. Należy pamiętać, że do wizualizacji na Dashboardach i gromadzenia danych nie trzeba stosować filtrów do metryk.

Dla jednego obiektu biznesowego można utworzyć wiele metryk, które przechwytują różne dane. Poniżej znajduje się przykład metryki do przechwytywania obrażeń zadanych dla środka i typu broni, która zadała te obrażenia:

Wizualizacja danych: Pulpity nawigacyjne i wykresy

Illuminate pozwala wizualizować nie tylko metryki, które chcesz śledzić, ale także działania decyzyjne i ich wyniki za pomocą wykresów na pulpitach nawigacyjnych.

W ten sposób możesz obserwować trendy w swoim produkcie w czasie rzeczywistym, reagować i udoskonalać swoje podejście za pomocą decyzji biznesowych opartych na danych. Jest to również świetny sposób na określenie, czy Illuminate prawidłowo przechwytuje dane w oparciu o skonfigurowane wcześniej obiekty biznesowe!

Możesz utworzyć pulpit nawigacyjny, który jest zbiorem wykresów, który pozwala zobaczyć wszystkie wskaźniki w jednym miejscu i dodać wykresy do pulpitu nawigacyjnego. Wykres jest wizualną reprezentacją metryki zdefiniowanej dla danego obiektu biznesowego.

W dowolnym momencie można dostosować sposób wyświetlania danych metrycznych na wykresie, na przykład pokazując inny zakres czasu (np. 30 minut, 1 godzinę lub niestandardową datę) i wyświetlając dane metryczne za pomocą różnych typów wykresów, jako wykres słupkowy (widok domyślny) lub wykres liniowy.

Możesz dodać wiele wykresów (metryk) do jednego pulpitu nawigacyjnego, a także mieć różne pulpity nawigacyjne do wizualizacji różnych obszarów gry (monetyzacja, rozgrywka, nagrody za zadania itp.). Po skonfigurowaniu decyzji będziesz mógł przeglądać uruchamiane działania decyzyjne i ich wyniki za pomocą wykresów na pulpitach nawigacyjnych.

Wykorzystaj swoje dane: Decyzje i działania

Po utworzeniu metryki można rozpocząć ocenę tych danych, monitorowanie trendów i, co najważniejsze, podejmowanie działań.

Illuminate zawiera moduł Decisions, który pozwala zdefiniować metryki, na których chcesz działać, tworząc akcje różnych typów i reguły określające, kiedy te akcje mają być wykonywane.

Podczas tworzenia decyzji należy:

Wybrać obiekt biznesowy i jedną z powiązanych z nim metryk.
Zdefiniuj działania, które chcesz podjąć.
Skonfigurować [rules}(https://www.pubnub.com/docs/illuminate/decisions/basics#rules) przy użyciu wybranych warunków i skonfigurowanych akcji. Reguły te będą wyzwalać działania.

Decyzje mają na celu pomóc menedżerom produktu eksperymentować ze strategiami zaangażowania i monetyzacji przed ich skodyfikowaniem i wdrożeniem. Dzięki Illuminate mogą oni podejmować decyzje w oparciu o rzeczywiste dane zamiast założeń, a następnie działać na podstawie tych danych za pomocą zautomatyzowanych warunków i działań.

Decyzje składają się z dwóch części: Akcji i Reguł.

Akcje

Akcje definiują, co się stanie, gdy zostaną spełnione warunki (omówione dalej).

Istnieje pięć typów akcji, które można wybrać podczas konfigurowania akcji:

Wyślij wiadomość: Publikuje wiadomość do użytkownika lub kanału i wykorzystuje PubNub Publish API. Opcjonalnie można dodać zmienne (${variableThatChanges}), które można kontrolować i zmieniać dynamicznie podczas konfigurowania reguł decyzyjnych.
Webhook: Wysyła wywołanie do określonego adresu URL, łącząc się z integracją usługi innej firmy. Opcjonalnie można dodać zmienne (${variableThatChanges}), które można kontrolować i dynamicznie zmieniać podczas konfigurowania reguł decyzyjnych.
Update User: Ustawia dowolne predefiniowane lub niestandardowe metadane użytkownika, dostarczając żądane informacje jako pary klucz/wartość, wykorzystując interfejs API PubNub App Context dla użytkowników.
Update Channel: Ustawia dowolne predefiniowane lub niestandardowe metadane kanału, podając żądane informacje jako pary klucz/wartość, wykorzystując interfejs API PubNub App Context dla kanałów.
Update Membership: Ustawia dowolne predefiniowane lub niestandardowe metadane członkostwa, podając żądane informacje jako pary klucz/wartość, wykorzystując interfejs API PubNub App Context dla członkostwa.

Chociaż można skonfigurować tylko jedną metrykę na decyzję, można utworzyć wiele decyzji, aby uwzględnić przypadki użycia. Pamiętaj, aby postępować zgodnie z dokumentacją podczas tworzenia akcji dla decyzji.

Po zakończeniu konfigurowania akcji należy skonfigurować reguły ich wyzwalania.

Reguły

Reguły składają się z warunków, które są kryteriami, które muszą być spełnione, aby wyzwolić akcję, do oceny i akcji do wykonania, gdy warunki są spełnione. Pojedyncza reguła to definicja (wiersz w tabeli decyzyjnej) określająca, która akcja powinna zostać uruchomiona dla danego warunku.

Tabela decyzyjna składa się z czterech części:

Polityka trafień: Ustawienie określające, czy akcja(i) ma(ją) być wyzwalana(e) tylko dla pierwszej pasującej reguły (Pojedyncza), czy dla wszystkich (Wiele), jeśli ich warunki są spełnione.
Okno agregacji: Jedyna wartość, której nie można edytować w oknie konfiguracji reguły. Automatycznie wypełnia się na podstawie wartości Okresu wybranej dla funkcji podczas tworzenia metryki. Określa, jak często metryka uruchamia daną funkcję (COUNT, AVG, MAX lub inną) dla miary lub wymiaru.
Częstotliwość oceny: Okno podglądu reguły określające, jak często program Illuminate powinien uruchamiać reguły w tej decyzji.
Warunki: Zestaw wymagań zdefiniowanych samodzielnie przy użyciu tabeli konfiguracji. W tym miejscu definiuje się, które warunki (i progi, które spełniają) powinny wyzwalać określone działania.

Należy pamiętać, że każdy wiersz w tabeli decyzji jest oddzielną regułą decyzyjną, która składa się z warunków i akcji. Kolejność reguł określa kolejność ich wykonywania. Jeśli chcesz zmienić istniejącą kolejność, wybierz Edytuj reguły w decyzji i zmień kolejność, korzystając z opcji Przenieś w górę lub Przenieś w dół w menu "Akcje" obok każdej reguły.

Wizualizacja i wprowadzanie zmian

Po skonfigurowaniu obiektów biznesowych, pulpitów nawigacyjnych i wykresów oraz decyzji można analizować i eksperymentować ze zmianami w czasie rzeczywistym. Nie musisz już czekać na poprawki balansu, aby sprawdzić, czy wprowadzone zmiany mają pozytywny wpływ na graczy lub grę.

Większość czasu będziesz spędzać tutaj, gdzie będziesz podejmować decyzje dotyczące eksperymentów, aby wprowadzić poprawki, które pomogą zwiększyć zaangażowanie w grę.

Co dalej

Illuminate oddaje moc eksperymentowania w czasie rzeczywistym w ręce zespołów bezpośrednio odpowiedzialnych za rozwój i wyniki finansowe firmy. Jest to cenna platforma do eksperymentowania i podejmowania inteligentnych decyzji opartych na danych w oparciu o rozgrywkę i zachowania użytkowników poprzez mapowanie wskaźników KPI, które są ważne dla twojej gry i wyzwalanie decyzji w oparciu o te zachowania.

Zapoznaj się z naszymi zasobami Ill uminate, aby zobaczyć, jak Illuminate może pomóc Twojej grze i dowiedzieć się, jak samemu wypróbować Illuminate. Jak zawsze, jeśli masz jakiekolwiek pytania, skontaktuj się z zespołem ds. relacji z deweloperami pod adresem devrel@pubnub.com.