Forem: PubNub [Deutsch]

Verwendung von App Context

PubNub Developer Relations — Tue, 09 Jul 2024 06:59:33 +0000

PubNub App Context vereinfacht die Entwicklung komplexer Echtzeitfunktionen, indem es einen serverlosen Speichermechanismus für Benutzer-, Kanal- und Mitgliedschaftsinformationen bereitstellt. App Context löst Ereignisse aus, sobald sich die Daten ändern, so dass Ihre Anwendungen in Echtzeit aktualisiert werden können. Die gespeicherten Daten können in Illuminate, Funktionen und anderen PubNub-Diensten verwendet werden, um intelligentere Entscheidungen zu treffen. Sie können diese Daten auch über eine intuitive, codefreie Schnittstelle mit BizOps Workspace verwalten.

Was ist App Context?

App Context (früher bekannt als Objects) ermöglicht es Ihnen:

den Benutzern und Kanälen in Ihrer Anwendung und den Beziehungen zwischen ihnen eine Bedeutung zu geben.
Speichern von Metadaten für alle Ihre Entitäten auf dem Server, was die Bereitstellung einer globalen Wahrheitsquelle für Ihre Clients vereinfacht. Beachten Sie, dass ein Benutzer nicht unbedingt ein menschliches Wesen darstellen muss, und dass es üblich ist, stattdessen den Gerätestatus im Benutzerobjekt zu speichern.
Empfangen Sie sofortige Echtzeit-Ereignisse, wenn sich die Werte eines Objekts ändern.

Obwohl jede Anwendung App Context verwenden kann, ist es besonders bei Entwicklern beliebt, die Chat-Lösungen erstellen.

App Context bietet eine Reihe von vorgeschlagenen Feldern für Ihre Benutzer und Channels sowie vorgeschlagene Felder für die Mitgliedschaften zwischen ihnen. Die meisten dieser Felder sind optional, so dass Sie auswählen können, welche Felder Sie ausfüllen, und auch Ihre eigenen benutzerdefinierten Felder bereitstellen können.

App Context Anwendungsfälle

Wie bereits erwähnt, ist App Context besonders bei Entwicklern beliebt, die Chat-Lösungen erstellen, aber es kann in einer Vielzahl von Anwendungsfällen eingesetzt werden:

Chat: Speichern Sie Benutzerinformationen (Name, Profilfoto, Urlaubsstatus, Berufsbezeichnung), Kanalinformationen (Symbol, Beschreibung, Zielgruppe), Benutzerrollen und verfolgen Sie die zuletzt gelesene Nachricht pro Kanal und Benutzer.
Sport, Medien und Unterhaltung: Live-Abstimmungen und -Umfragen, Live-Quiz, Echtzeitgebote, CTA-Overlays (Call-to-Action) für Waren oder Werbeaktionen.
Spiele: Spielerstatistiken in Echtzeit, einschließlich Spielerlevel, gewonnene Spiele, Abzeichen; Verfolgung und Verwaltung von Ranglisten
Mehr: Abwesenheits-/Aktivitätsstatus des Nutzers, Vertrauenswürdigkeit des Nutzers für die Betrugserkennung, Verfolgung des Nutzerstandorts, IoT-Gerätestatus wie Batteriestand oder letzter Sensorwert

Aktivieren von App Context

App Context kann wie folgt aktiviert werden:

Loggen Sie sich in das Admin Portal ein
Klicken Sie auf die Registerkarte "Apps" auf der linken Seite des Portals
Klicken Sie auf eine Anwendung. Sie werden auf die Seite mit den Schlüsselsätzen für diese Anwendung weitergeleitet.
Wenn Sie dies noch nicht getan haben, erstellen Sie ein neues Keyset, indem Sie auf die Schaltfläche "Neues Keyset erstellen" klicken. Sie gelangen dann zur Konfigurationsseite für dieses Keyset
Aktivieren Sie App Context, indem Sie auf den Schieberegler klicken.
Die Einstellung " Bucket Region" ist die Region, in der Ihre Daten gespeichert werden. Bitte beachten Sie, dass die Region nach dem Speichern der Änderungen am Keyset nicht mehr geändert werden kann.
Wenn die Einstellungen Benutzer-Metadaten-Ereignisse und Channel-Metadaten-Ereignisse aktiviert sind, werden die Benutzer- und Channel-Ereignisse ausgelöst, wenn Daten in der Datenbank festgelegt oder entfernt werden, wie später beschrieben.
Wenn die Einstellung Mitgliedschaftsereignisse aktiviert ist, werden Mitgliedschaftsereignisse ausgelöst, wenn Mitgliedschaften hinzugefügt, aktualisiert oder entfernt werden (siehe unten).
Die übrigen Optionen werden in diesem Artikel nicht behandelt, aber weitere Informationen finden Sie in der App Context-Dokumentation
Klicken Sie auf Änderungen speichern, um diese aktualisierten Änderungen zu speichern.

Benutzer-App-Kontext

Wenn ein neuer Benutzer in Ihre Anwendung aufgenommen wird, z.B. über einen externen Identitätsanbieter, müssen Sie eine Möglichkeit haben, diesen Benutzer gegenüber PubNub eindeutig zu identifizieren; dies ist die Benutzer-ID, die der Client Ihres Benutzers zur Initialisierung des PubNub SDK verwendet. Die PubNub-Benutzer-ID ist möglicherweise nicht dieselbe wie die ID, die Sie an anderer Stelle in Ihrer Lösung zur Identifizierung desselben Benutzers verwenden, daher empfehlen wir, dies im Feld "Externe ID" festzuhalten.

Benutzername, E-Mail und Profil-URL bedürfen keiner Erläuterung, aber der Vorteil, diese innerhalb von App Context zu halten, bedeutet, dass, wenn ein Benutzer eines dieser Felder ändert, die Änderungen in großem Umfang an alle zuhörenden Clients weitergegeben werden können, indem App Context-Ereignisse verwendet werden, die von allen unseren SDKs unterstützt werden.

Wie erstelle ich eine Benutzerdarstellung in App Context?

Es gibt zwei Möglichkeiten, einen App Context-Benutzer zu erstellen.

Benutzer können über den BizOps Workspace im PubNub-Administrationsportal erstellt und verwaltet werden. Dies erfordert keinen Code und der Prozess wird mit Beispielen in einem separaten Artikel erklärt: Verwalten von Benutzern und Channels mit BizOps Workspace
Jedes unserer SDKs stellt APIs zur Verfügung, um Benutzer zu erstellen. Wenn Sie unser Chat-SDK verwenden, verwaltet dieses SDK den Anwendungskontext für Sie hinter den Kulissen; zum Beispiel ruft die Chat-SDK-MethodecreateUser()" im Verborgenen die JavaScript-Methode setUUIDMetadata auf, um einen Benutzer zu erstellen. Wenn Sie ein anderes SDK als das Chat-SDK verwenden, stehen spezielle APIs zur Verfügung, um Ihre App-Kontextdaten zu ändern. Ich habe bereits die JavaScript setUIDMetadata API erwähnt, aber es gibt Äquivalente für alle unsere APIs, einschließlich Java, Swift, Kotlin, Python, Unity, etc.

Kanal-App-Kontext

PubNub erstellt automatisch Channels, wenn ein Benutzer sie abonniert oder veröffentlicht, aber Channels repräsentieren wahrscheinlich etwas, das für Ihre Anwendung von Bedeutung ist, z. B. könnten Sie in einer Chat-App einen Gruppen-Chat haben, der einen Channel zur Kommunikation verwendet, oder ein Live-Event könnte einen dedizierten Channel zur Verwaltung von Umfragen verwenden.

Wenn Sie App Context für einen Kanal angeben, werden alle gewünschten Metadaten zu diesem Kanal gespeichert und aktualisiert, wobei diese Aktualisierungen optional an alle interessierten Clients weitergegeben werden. Sie könnten einem Kanal einen Namen geben, z. B. "Chat zwischen Benutzer A und Benutzer B", und vielleicht ist der Kanal mit einer Dokumentenspeicherung verbunden, die in einem benutzerdefinierten "URI"-Feld verfolgt werden könnte.

Wie erstelle ich eine Channel-Darstellung in App Context?

Ähnlich wie bei Benutzern gibt es zwei Möglichkeiten, einen App Context Channel zu erstellen.

Channels können mit BizOps Workspace erstellt und verwaltet werden. Dazu ist kein Code erforderlich, und der Prozess wird mit Beispielen in einem separaten Artikel erläutert: Verwalten von Benutzern und Channels mit BizOps Workspace
Jedes unserer SDKs stellt APIs zur Verfügung, um Channels zu erstellen. Wenn Sie unser Chat-SDK verwenden, wird der Anwendungskontext für Sie hinter den Kulissen gehandhabt; zum Beispiel ruft die Familie der" Kanalerstellen "-Methoden im Verborgenen die JavaScript-Funktion setChannelMetadata() auf. Wenn Sie ein anderes SDK als das Chat-SDK verwenden, stehen Ihnen spezielle APIs zur Verfügung, um Ihre App-Kontextdaten zu ändern, einschließlich JavaScript, Java, Swift, Kotlin, Python, Unity usw.

App-Kontext für die Mitgliedschaft

Nachdem wir App Context sowohl für unsere Benutzer als auch für unsere Channels definiert haben, können wir nun die Beziehung zwischen den beiden definieren, indem wir angeben, ob Benutzer "Mitglieder" eines Channels sind.

Wenn ein Benutzer einem Channel beitritt, kann er Aktualisierungen über jedes andere Mitglied desselben Channels erhalten; er kann benachrichtigt werden, wenn ein Benutzer beitritt oder austritt und wenn der App Context dieses Benutzers aktualisiert wird (z. B. wenn er seinen Namen aktualisiert).

Dies ist ein täuschend mächtiger Mechanismus, der vor allem für Entwickler von Chat-Apps von*großem Nutzen* ist. Wenn Sie App Context nicht verwenden würden, müssten Sie jeden Benutzer selbst verfolgen, in welchen Kanälen er Mitglied ist, und alle anderen im selben Kanal benachrichtigen, wenn dieser Benutzer beitritt oder austritt. Diese Herausforderung lässt sich nicht linear skalieren, d. h. je mehr Benutzer Sie in Ihrer Lösung haben, desto schwieriger wird es für Sie, all diese Informationen zentral zu verwalten.

Durch die Verwendung von App Context werden Ihren Chat-Clients alle Informationen zur Verfügung gestellt, die sie zur Aufrechterhaltung ihres internen Status benötigen, und Sie haben mit dem PubNub Access Manager die volle Kontrolle über diese Daten, um unbefugten Zugriff zu verhindern.

Wie kann ich eine Mitgliedschaft erstellen?

Ähnlich wie bei Benutzern und Channels gibt es zwei Möglichkeiten, eine Mitgliedschaft zu erstellen.

Mitgliedschaften können mit BizOps Workspace erstellt und verwaltet werden, ohne Code zu schreiben. Weitere Einzelheiten finden Sie im Abschnitt Mitgliedschaft verwalten in unserer Dokumentation.
Über jedes unserer SDKs werden APIs zum Erstellen von Channels bereitgestellt. Wenn Sie unser Chat-SDK verwenden, wird der Anwendungskontext für Sie hinter den Kulissen gehandhabt; beispielsweise ruft die Familie der" Channelerstellen "-Methoden im Verborgenen die JavaScript-Funktion setMemberships auf. Wenn Sie ein anderes SDK als das Chat-SDK verwenden, werden dedizierte APIs bereitgestellt, um Ihre App-Kontextdaten zu ändern, einschließlich JavaScript, Java, Swift, Kotlin, Python, Unity usw.

Empfangen von Echtzeit-Ereignissen bei App-Kontextänderungen

Wenn sich App Context-Daten ändern, erhält Ihre Anwendung ein Ereignis, das Sie in Echtzeit über die Änderungen informiert.

Empfangen von App Context Änderungen durch das PubNub SDK (außer Chat SDK)

Alle PubNub SDKs stellen "Event Listener" zur Verfügung. Über diese Listener können Sie auf Objekt-Ereignisse hören, die immer dann ausgelöst werden, wenn sich App Context-Daten ändern.

Beachten Sie, dass es hier eine kleine Nuance gibt, dass zum Zeitpunkt des Schreibens einige unserer SDKs ein neues Format für "Event Listener" unterstützen, wie in diesem Blog über Updates der Event Engine und Event Listener erklärt. Unabhängig vom Format des Ereignis-Listeners bleibt das Prinzip dasselbe: Ihre Anwendung sollte sich registrieren, um App-Kontext-Ereignisse über einen vom SDK bereitgestellten Listener zu empfangen.

Wie in der JavaScript-SDK-Dokumentation beschrieben, sieht die Registrierung für App Context-Ereignisse wie folgt aus:

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

Dokumentation, die beschreibt, wie man sich für App Context-Ereignisse in anderen Sprachen registriert, finden Sie an den folgenden Stellen: Java, Swift, Kotlin, Python (beachten Sie, dass Python die Ereignisse als "Metadaten" bezeichnet, während andere SDKs die Ereignisse als "Objekte" bezeichnen), Unity, usw.

Ein praktisches Beispiel und eine interaktive Demo finden Sie in dem Artikel How to Manage Users and Channels with BizOps Workspace

Empfangen von App-Kontextänderungen über das PubNub Chat SDK

Das PubNub Chat SDK stellt App Context Events durch die Familie der streamUpdates() APIs zur Verfügung.

Einige Beispiele, entnommen aus der Chat SDK Demo-App für das 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])

Für ein Beispiel, das auf unserem einfacheren Beispiel für das Chat SDK basiert, lesen Sie bitte den Artikel How to Manage Users and Channels with BizOps Workspace

Anwendungskontext und PubNub Illuminate

PubNub Illuminate ist ein Echtzeit-Entscheidungs- und -Analyseprodukt, das an den jeweiligen Anwendungsfall einer Organisation angepasst werden kann. Das Produkt wurde mit Blick auf Produktmanager und Analysten entwickelt und ermöglicht ihnen Folgendes:

Definieren von benutzerdefinierten aggregierten Echtzeit-Metriken.
Einrichten und Bereitstellen von Entscheidungsregeln mit Bedingungen und Aktionen.
Sofortige Visualisierung der von Ihnen verfolgten Metriken, der ausgeführten Aktionen und ihrer Ergebnisse.

Sie können all dies in Echtzeit tun, ohne dass Ihr Entwicklungsteam von seinen laufenden Projekten abgezogen werden muss.

Eine vollständige Erklärung, was PubNub Illuminte ist und wie es Ihnen sofort verwertbare Einblicke in Ihre Daten geben kann, würde den Rahmen dieses Artikels sprengen.

Kurz gesagt: Sie definieren Metriken, die sich auf Ihre Anwendung beziehen, d. h. Dinge, die Sie messen möchten. In einem Asset-Tracking-Szenario könnten dies zum Beispiel die Stunden seit der Auftragsannahme sein. Wenn eine Bedingung in Bezug auf diese Metrik erfüllt ist, z. B. wenn die "Stunden seit der Bestellung" einen bestimmten Wert überschreiten, können Sie eine Aktion durchführen.

Welche Aktion Sie ergreifen, ist flexibel, aber drei der möglichen Aktionen beziehen sich auf den App-Kontext:

Benutzer mit PubNub Illuminate aktualisieren

Ermöglicht es Ihnen, vordefinierte oder benutzerdefinierte Benutzer-Metadaten festzulegen. Der Screenshot unten zeigt, dass der Status des Benutzers mit der ID 123 auf den statischen Wert "New Status" gesetzt wurde, aber es ist auch möglich, einen dynamischen Wert basierend auf der Bedingung, die die Aktion ausgelöst hat, zu setzen.

Channel aktualisieren mit PubNub Illuminate

Ermöglicht es Ihnen, beliebige vordefinierte oder benutzerdefinierte Channel-Metadaten zu setzen. Der Screenshot unten zeigt, dass der Name des Channels mit der ID 123 auf den statischen Wert "New Name" gesetzt wurde, aber es ist auch möglich, einen dynamischen Wert auf der Grundlage der Bedingung zu setzen, die die Aktion ausgelöst hat.

Aktualisieren von Mitgliedschaften mit PubNub Illuminate

Ermöglicht es Ihnen, vordefinierte oder benutzerdefinierte Metadaten für die Mitgliedschaft zu setzen. Der Screenshot unten zeigt die Mitgliedschaft von User ID 123 im Channel 123, dessen Status auf den statischen Wert "New Status" gesetzt wurde. Es ist auch möglich, einen dynamischen Wert zu setzen, der auf der Bedingung basiert, die die Aktion ausgelöst hat.

App-Kontext und PubNub-Funktionen

PubNub bietet Funktionen zur Erfassung von Ereignissen, die auf der PubNub-Plattform stattfinden. Mit Funktionen können Sie Code schreiben oder bestehende Integrationen nutzen, um Daten umzuwandeln, umzuleiten, zu erweitern, zu filtern und sogar zu aggregieren. Einen genaueren Überblick über PubNub-Funktionen finden Sie in der Funktionsdokumentation. In diesem Artikel geht es jedoch darum, wie PubNub-Funktionen mit App Context zusammenhängen.

Aktualisierung von App Context aus PubNub Functions heraus

Die Umgebung, in der die Funktionen ausgeführt werden, hat Zugriff auf das PubNub-Modul; dieses Modul hat vollen Zugriff auf den App Context auf Ihrem Keyset, und einige Beispiele aus der Dokumentation sind unten aufgeführt. :

Beispiel für 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');
  });
};

Beispiel für Set Channel App Context Metadata (Kanal-App-Kontext-Metadaten)

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.');
  });
};

Umfassende Code-Beispiele finden Sie in der Dokumentation des PubNub-Moduls.

Auslösen einer PubNub-Funktion bei Änderung des App-Kontextes

Es gibt zahlreiche Ereignistypen, die eine Funktion auslösen können, wie in der Dokumentation Event Types beschrieben. Dazu gehört die Möglichkeit, zu erkennen, wann Nachrichten und Signale gesendet werden, Funktionen nach dem Auftreten von Präsenzereignissen auszulösen und Funktionen in einem bestimmten Intervall oder bei Bedarf auszuführen. Zum Zeitpunkt der Erstellung dieses Artikels ist es nicht möglich, Funktionen nach Aktualisierungen des App-Kontextes auszuführen, aber wenn Sie feststellen, dass Ihre Anwendung dies benötigt, wenden Sie sich bitte an unser Support-Team, das gerne Ihre Anwendungsfälle durchgehen wird.

Nächste Schritte

Um App Context in Aktion zu sehen, können Sie sich unsere Chat-Demo ansehen, die App Context zusammen mit unserem Chat-SDK verwendet, um zu zeigen, wie eine Chat-App mit serverlosem Speicher aussehen könnte. In der Chat-Demo können Sie Benutzer- und Channel-Metadaten festlegen und sehen, wie sich diese Änderungen in Echtzeit auf andere Zuhörer und Mitglieder übertragen.

Sehen Sie sich auch unsere 3-teilige Serie über den BizOps-Workspace an, der von App Context abhängt und die folgenden Themen behandelt: Verwalten von Benutzern und Kanälen, Überwachen und Moderieren von Konversationen und sicheres Moderieren von Chats.

Und schließlich können Sie sich jederzeit an das DevRel-Team unter devrel@pubnub.com oder an unser Support-Team wenden, wenn Sie Hilfe zu einem beliebigen Aspekt Ihrer PubNub-Entwicklung benötigen.

Wie kann PubNub Ihnen helfen?

Dieser Artikel wurde ursprünglich auf PubNub.com veröffentlicht.

Unsere Plattform hilft Entwicklern bei der Erstellung, Bereitstellung und Verwaltung von Echtzeit-Interaktivität für Webanwendungen, mobile Anwendungen und IoT-Geräte.

Die Grundlage unserer Plattform ist das größte und am besten skalierbare Echtzeit-Edge-Messaging-Netzwerk der Branche. Mit über 15 Points-of-Presence weltweit, die 800 Millionen monatlich aktive Nutzer unterstützen, und einer Zuverlässigkeit von 99,999 % müssen Sie sich keine Sorgen über Ausfälle, Gleichzeitigkeitsgrenzen oder Latenzprobleme aufgrund von Verkehrsspitzen machen.

PubNub erleben

Sehen Sie sich die Live Tour an, um in weniger als 5 Minuten die grundlegenden Konzepte hinter jeder PubNub-gestützten App zu verstehen

Einrichten

Melden Sie sich für einen PubNub-Account an und erhalten Sie sofort kostenlosen Zugang zu den PubNub-Schlüsseln

Beginnen Sie

Mit den PubNub-Dokumenten können Sie sofort loslegen, unabhängig von Ihrem Anwendungsfall oder SDK

Dokumentation Versionshinweise - Juni 2024

PubNub Developer Relations — Mon, 08 Jul 2024 12:56:30 +0000

Dieser Artikel wurde ursprünglich auf https://www.pubnub.com/docs/release-notes/2024/june veröffentlicht.

Hallo zusammen! Diesen Monat haben wir ein paar neue Updates für Sie.

Wir haben ein neues Flag für referentielle Integrität eingeführt, um die Konsistenz Ihrer Daten zu gewährleisten.
Sie können jetzt Channel-Gruppen-Grenzen direkt über das Admin-Portal festlegen.
Probieren Sie den Import von Daten aus Insights in BizOps aus, um die Funktionen zu testen.
Außerdem werden Sie feststellen, dass das Erscheinungsbild von Presence Management überarbeitet wurde.

Darüber hinaus haben wir eine Reihe von kleinen, aber wichtigen Verbesserungen in den Dokumenten vorgenommen, die hoffentlich einige Ihrer Fragen beantworten oder Ihre Zweifel bei der Arbeit mit PubNub ausräumen.

Viel Spaß beim Stöbern und vielen Dank, dass Sie Teil unserer Community sind!

Allgemein 🛠️

Benutzerdefinierte Felder in FCM Payloads

Typ: Verbesserung

Wir haben die Dokumente für die Android Mobile Push Notifications korrigiert, indem wir die fehlenden benutzerdefinierten PubNub-Parameter hinzugefügt haben, die Sie zu Ihrem FCM Mobile Push Notification Payload hinzufügen können: pn_debug, pn_exceptions und pn_dry_run.

Damit können Sie Benachrichtigungen testen oder debuggen und ausgewählte Geräte vom Empfang von Benachrichtigungen ausschließen.

Hier ist ein Beispiel für eine FCM-Nutzlast mit unseren benutzerdefinierten Feldern:

{
  "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
}

Kanalgruppengrenzen

Typ: Neue Funktion

Der Stream Controller im Admin-Portal verfügt über eine neue, konfigurierbare Option zur Begrenzung von Kanalgruppen für Kunden mit kostenpflichtigen Tarifen, mit der Sie die maximale Anzahl von Kanälen festlegen können, die Kanalgruppen in einem Keyset haben können. Sie können entweder das Standardlimit von 1.000 Channels herabsetzen oder es auf 2.000 Channels erhöhen.

Benutzer-Metadaten-Ereignisse im App-Kontext

Typ: Verbesserung

Wir haben die Dokumentation verbessert, um klarzustellen, dass bei aktivierter Option " Benutzer-Metadaten-Ereignisse " jede Änderung an einer Benutzerentität(Setzen und Löschen) dazu führt, dass Ereignisbenachrichtigungen an alle Mitgliedschaftsassoziationen gesendet werden, also sowohl an den Benutzer als auch an jeden Channel, in dem er Mitglied ist. Weitere Details finden Sie in der Dokumentation.

App Context Konfigurationsabhängigkeit

Typ: Verbesserung

Wir haben die Dokumente zu den Konfigurationsoptionen von App Context aktualisiert, um Informationen zu einer kritischen Abhängigkeit aufzunehmen.

Obwohl die Optionen Disallow Get All Channel Metadata und Disallow Get All User Metadata auf den ersten Blick selbsterklärend sind, funktionieren diese Optionen nur bei aktiviertem Access Manager.

Mit anderen Worten: Ohne Access Manager deaktivieren diese aktiven Optionen nicht wirklich den Abruf von Metadaten über Benutzer oder Kanäle auf einem Keyset. Wenn Sie den Zugriffsmanager aktivieren und damit standardmäßig den Zugriff auf alle Objekte in einem Keyset einschränken, können Sie die GET-Beschränkungen des Zugriffsmanagers für Benutzer und Channels leicht umgehen, indem Sie diese beiden Konfigurationsoptionen deaktivieren, ohne ein feinkörniges Berechtigungsschema zu erstellen.

Die Admin Portal UI wird diese Abhängigkeit bald ebenfalls widerspiegeln.

Neues Flag für referenzielle Integrität im App-Kontext

Typ: Neue Funktion

Wir haben eine neue Option Referentielle Integrität für Mitgliedschaften erzwingen hinzugefügt, die standardmäßig aktiviert wird, wenn Sie App Context für das Keyset Ihrer App im Admin Portal aktivieren.

Diese Option stellt sicher, dass Sie nur dann eine neue Mitgliedschaft einrichten können, wenn sowohl die Benutzer-ID als auch die Channel-ID, für die Sie die Mitgliedschaft erstellt haben, existieren. Gleichzeitig werden durch das Löschen einer übergeordneten Benutzer- oder Channel-Metadaten-Entität automatisch alle untergeordneten Mitgliedschaftszuordnungen für diese gelöschte Entität gelöscht. Auf diese Weise stellen Sie sicher, dass es keine fehlerhaften oder verwaisten Mitgliedschaftsobjekte in Ihrem Schlüsselsatz gibt.

SDKs 📦

Verbesserungen der Python-Dokumente

Typ: Verbesserung

Aufgrund des Feedbacks, das wir erhalten haben, haben wir die Informationen über die Verwendung und Ausführung von Methoden erweitert. Infolgedessen beschreibt jeder Abschnitt "Returns" in den Python SDK-Dokumenten nun die Datenfelder, die von jeder Methode zurückgegeben werden. Außerdem wird erklärt, wie die Ausführung von sync (.sync()) und async (.pn_async(callback)) Anfragen die zurückgegebenen Daten für jede Methode beeinflusst.

React SDK wurde veraltet

Typ: Verwerfungshinweis

Da wir das React SDK seit einiger Zeit nicht mehr aktiv weiterentwickelt haben, haben wir uns entschlossen, seine Dokumente offiziell abzulehnen und sie in den Abschnitt Call For Contributions in unseren Dokumenten zu verschieben.

Wenn Sie einen Fehler im React SDK finden oder seine Funktionalität erweitern wollen, können Sie gerne einen Pull Request im Repo erstellen und auf unser Feedback warten!

Funktionen

Exportieren von Funktionsprotokollen durch Events & Actions

Typ: Neue Funktion

Jede PubNub-Funktion speichert Logs im internen blocks-output-* Kanal, wie blocks-output-NSPiAuYKsWSxJl4yBn30, der bis zu 250 Zeilen Logs speichern kann, bevor neue sie überschreiben. Wenn Sie den Überblick über alte Protokolle nicht verlieren wollen, können Sie diese Protokolle jetzt mit Events & Actions an einen externen Dienst exportieren.

Einblicke 📊.

Benutzerdauer und Gerätemetriken in den REST-API-Dokumenten

Typ: Verbesserung

Letzten Monat haben wir die Gerätemetriken in das User Behavior Dashboard in den PubNub Insights auf dem Admin Portal eingeführt. Diesen Monat haben wir die REST-API-Dokumente aktualisiert, um sowohl die Benutzerdauer als auch die Gerätemetriken aufzunehmen, so dass Sie die PubNub Insights API direkt aufrufen können, um die Metriken zu erhalten, die Sie interessieren.

BizOps Arbeitsbereich 🏢

Top 20 Nutzer/Kanäle

Typ: Neue Funktion

Wenn Sie App Context nicht zum Speichern und Verwalten von Benutzern und Kanälen verwenden, können Sie die entsprechenden Funktionen von BizOps Workspace dennoch testen, indem Sie Testdaten importieren.

Wenn Sie Zugang zu PubNub Insights haben, können Sie darauf zugreifen, indem Sie zu den Modulen User Management und Channel Management in BizOps Workspace im Admin Portal gehen und auf die Schaltfläche Import from Insights klicken.

Als Ergebnis importieren Sie aus dem Keyset Ihrer App maximal 20 Benutzer, die innerhalb des letzten Tages die meisten Nachrichten veröffentlicht haben (wenn gestern keine Nachrichten gesendet wurden, werden die Benutzer anhand der Daten vom Vortag importiert).

Ähnlich wie bei den Nutzern können Sie aus dem Keyset Ihrer App bis zu 20 Kanäle mit der höchsten Anzahl an Nachrichten importieren, die innerhalb des letzten Tages veröffentlicht wurden.

Nutzen Sie diese Testdaten, um herauszufinden, was BizOps Workspace zu bieten hat.

Überarbeitetes Präsenzmanagement UX

Typ: Verbesserung

Wir haben vor kurzem das gesamte Präsenzmanagement-Modul in BizOps Workspace überarbeitet, um den Assistenten für die Regelerstellung zu vereinfachen, die Farben der Abzeichen in umfassendere Farben zu ändern und eine "Catch All"-Musterkonfiguration hinzuzufügen, die die Standardeinstellung "Präsenz auf allen Kanälen aktivieren" der Präsenzkonfiguration auf dem Keyset widerspiegelt.

Wir hoffen, dass Ihnen das neue Aussehen und die Bedienung gefällt!

Dokumentation Versionshinweise - Mai 2024

PubNub Developer Relations — Mon, 08 Jul 2024 11:22:42 +0000

Dieser Artikel wurde ursprünglich auf https://www.pubnub.com/docs/release-notes/2024/may veröffentlicht.

Willkommen zu den Versionshinweisen dieses Monats! PubNub bringt Ihnen ein Bündel von Aktualisierungen, die Ihre Arbeit vereinfachen und für mehr Komfort sorgen.

Was ist in dem Paket enthalten?

Wir haben die App Context-Datenfilterungsdokumente vereinheitlicht, die Event-Listener-Architektur für Python und Asyncio überarbeitet und neue Tools hinzugefügt, die Ihnen den Einstieg in die sichere Chat-Moderation erleichtern sollen.

Im Admin-Portal haben wir detaillierte Gerätemetriken eingeführt, die Ereignisverwaltung mit Stapel- und Umhüllungsoptionen verbessert und schicke neue gestapelte Balkendiagramme und variable Funktionen in Illuminate eingeführt.

Außerdem verfügen unsere Dokumente und unsere Website jetzt über eine neue Suchmaschine mit einer KI, die Ihnen hilft, genau das zu finden, was Sie brauchen.

Tauchen Sie gleich ein und erkunden Sie die Vorzüge!

Allgemein 🛠️

Vereinheitlichte Informationen zum Filtern von App-Kontextdaten

Typ: Erweiterung

Beschreibung: Basierend auf dem Feedback haben wir Informationen aus verschiedenen SDKs zum Filtern von Benutzer-, Channel- und Mitgliedschaftsdaten mit Hilfe der App Context API von PubNub überprüft und vereinheitlicht. Als Ergebnis haben wir ein App Context Filtering Dokument (mit zahlreichen Beispielen) erstellt, das als Einstiegspunkt für alle Datenfilterungsabfragen dient.

Lernen Sie:

Welche Benutzer-, Channel- und Mitgliedsdaten Sie filtern können.
Welche Filteroperatoren Sie verwenden können.
Wie Sie die Daten durch praktische Beispiele filtern können.

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

SDKs 📦

Aktualisierte Event-Listener-Architektur für Python & Asyncio

Typ: Neue Funktion

Beschreibung: Die neue Event-Listener-Architektur für Python- und Asyncio-SDKs bietet im Vergleich zum bisherigen monolithischen PubNub-Objekt Möglichkeiten zur Verwaltung von Abonnements und zum Abhören von Ereignissen mit engerem Umfang.

Während das PubNub-Objekt weiterhin als globaler Bereich dient und abwärtskompatibel bleibt, bietet die neue Architektur "Entity"-Objekte wie Kanäle, Kanalgruppen, Benutzer-Metadaten und Kanal-Metadaten, die Subscription-Objekte zurückgeben.

Diese Subscriptions ermöglichen subscribe/unscribe-Methoden und addListener/removeListener-Methoden, die für einzelne Entitäten spezifisch sind, und bieten so eine flexiblere und unabhängigere Möglichkeit, Echtzeit-Ereignisse zu verwalten und die Notwendigkeit einer globalen Zustandsverwaltung zu reduzieren.

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

Chat 💬.

Beispiel für eine sichere Moderation im Chat SDK

Typ: Neue Funktion

Beschreibung: Unser Chat-Team hat einen einfachen Access Manager-API-Dienst erstellt, um Ihnen zu helfen, das End-to-End-Szenario für die Sicherung von Chat-SDK-Anwendungen mit Access Manager zu verstehen. Dieser Dienst simuliert einen einfachen Endpunkt und enthält einen Beispielberechtigungssatz, den Sie verwenden können, um die serverseitige Autorisierung für Ihre Chat SDK-Anwendungen mit aktiviertem Access Manager einzurichten.

Gehen Sie das gesamte Testszenario mit unserer React Native Chat App (für die Benutzerinteraktion), Channel Monitor (für die Benutzermoderation, wie Stummschaltung und Verbot) und Access Manager API (für die Generierung von Autorisierungs-Tokens) durch.

Die detaillierten Schritte finden Sie im Blog How to Securely Moderate Chat and Users with BizOps Workspace.

Einblicke 📊.

Dashboard für Gerätemetriken

Typ: Erweitert

Beschreibung: Wir haben das User Behavior Dashboard in Insights um Metriken zum Gerätetyp erweitert. So können Sie tief in das Verhalten Ihrer Nutzer pro Gerätetyp eintauchen. Von nun an können Sie beobachten, wo Ihre App-Nutzer am häufigsten veröffentlichen oder abonnieren (iOS, Android und Windows) und die Anzahl der eindeutigen Nutzer pro Gerätetyp überprüfen.

Dieser Einblick kann Ihnen helfen, benutzerdefinierte Funktionen nach Gerät zu erstellen und so die Kundenerfahrung zu verbessern.

Ereignisse & Aktionen ⚡.

Webhook-Aktion unterstützt jetzt Batching

Typ: Enhancement

Beschreibung: Mit der Batching-Funktion in Events & Action können Sie eine große Anzahl von Ereignissen verwalten, indem Sie sie in einer einzigen Anfrage senden, anstatt jedes Ereignis einzeln zu senden. Diese Funktion ist ab Mai auch für den Aktionstyp Webhook verfügbar.

(Un)umhüllend

Typ: Erweiterung

Beschreibung: Sie können nun die Nutzdaten jeder Aktion in einen Umschlag verpacken, d.h. wählen, ob das Nutzdatenschema detaillierte Events & Actions JSON-Metadaten enthalten soll. Dies kann hilfreich sein, wenn man Metadaten außerhalb des Payloads verwenden möchte, wie z.B. Informationen über den Kanal, an den der Payload gesendet wurde oder den Listener, der ihn ausgelöst hat.

Beleuchten 💡.

Gestapelte Balkendiagramme

Typ: Neue Funktion

Beschreibung: Zusätzlich zu den Balken- und Liniendiagrammen bieten Illuminate Dashboards jetzt einen neuen Diagrammtyp mit gestapelten Balken, der die Lesbarkeit von Daten verbessert, wenn viele Dimensionen und Werte in einem einzigen Diagramm dargestellt werden.

Variablen

Typ: Erweiterung

Beschreibung: Wenn Sie in Decisions Aktionen erstellen (die angeben, was Sie mit den gesammelten Metriken tun möchten), können Sie in den Aktionskonfigurationstabellen Variablen hinzufügen, um zu steuern und dynamisch zu ändern, worauf sie sich beziehen. Sie können Variablen flexibler verwenden - entweder durch Bezugnahme auf die vordefinierten Bedingungen (geben Sie ${) ein und wählen Sie aus der Liste aus) oder indem Sie neue Variablen(${variable}) einrichten. Variablen sind jetzt für die meisten Aktionsfelder verfügbar, nicht nur in der Nutzlast oder dem Body von Aktionen.

Verbesserte Datenzuordnungsfelder

Typ: Verbesserung

Beschreibung: Wenn Sie ein Business-Objekt erstellen und Kennzahlen (welche Daten Sie verfolgen wollen) oder Dimensionen (um die zu verfolgenden Daten zu segmentieren) definieren, müssen Sie die Feldnamen den tatsächlichen Feldern in Ihrer Payload zuordnen, damit Illuminate weiß, wo diese Daten gesucht werden sollen. Bislang mussten Sie die genaue Zuordnung der einzelnen Felder in der Nutzlast manuell eingeben. Ab Mai bietet Illuminate benutzerfreundlichere Dropdown-Menüs, um den genauen Speicherort der Veröffentlichungs- und App-Kontextdaten zu ermitteln.

Sonstiges 🌟.

Neue Suche und KI-Assistent

Typ: Neue Funktion

Beschreibung: Zu guter Letzt haben wir die Algolia-Suche in unseren Dokumenten gegen die neue kombinierte Suche und den KI-Assistenten ausgetauscht, um das PubNub-Lernabenteuer noch genauer und interaktiver zu gestalten.

Es ist an der Zeit, Ihr Coding-Spiel zu verbessern und sich mit unserem neuen KI-Assistenten und der Suchfunktion anzufreunden. Wir werden sie auf der Grundlage deines Feedbacks verfeinern. Sollte also etwas fehlen, werden wir es auf jeden Fall aktualisieren. Viel Spaß beim Programmieren! 🚀

Überblick über Daten-Streaming-Technologien

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

Die Fähigkeit, große Datenmengen (Big Data) in Echtzeit zu verarbeiten, ist für viele Unternehmen von entscheidender Bedeutung geworden, und hier kommen die Daten-Streaming-Technologien ins Spiel. Diese Technologien ermöglichen es, große Datenmengen in Echtzeit oder nahezu in Echtzeit zu verarbeiten, während sie generiert werden, so dass Unternehmen unmittelbare Erkenntnisse gewinnen und zeitkritische datengestützte Entscheidungen treffen können.

Im Mittelpunkt dieser Technologien steht das Konzept der Datenströme, die auch als Ereignisströme bezeichnet werden. Bei den Datenströmen handelt es sich um Sequenzen, die von verschiedenen Quellen erzeugt werden, z. B. von Social-Media-Feeds, Internet-of-Things-Geräten (IoT), Protokolldateien, wissenschaftlichen Datensätzen und mehr. Diese Datenströme werden dann von Daten-Streaming-Technologien aufgenommen und verarbeitet.

Ein weiterer wichtiger Aspekt ist die Skalierbarkeit von Datenströmen. Wenn das Datenvolumen wächst, können die Technologien skaliert werden, um die erhöhte Last zu bewältigen und sicherzustellen, dass Unternehmen Echtzeitanalysen durchführen können. Dies bedeutet, dass Unternehmen ihre Daten analysieren können, sobald sie generiert werden, und so in der Lage sind, schnelle Entscheidungen zu treffen, was besonders in Szenarien nützlich ist, in denen das Timing wichtig ist, z. B. bei der Betrugserkennung oder der Optimierung der Kundenerfahrung.

Daten-Streaming-Technologien unterstützen verschiedene Formate, von strukturierten Daten wie SQL-Datenbanken bis hin zu unstrukturierten Daten wie Live-Events oder Social-Media-Feeds; dies stellt sicher, dass Unternehmen alle Arten von Daten verarbeiten und analysieren können, unabhängig von ihrer Quelle oder ihrem Format. Es ist wichtig zu beachten, dass diese Technologien zwar viele Vorteile bieten, aber auch Herausforderungen mit sich bringen. So erfordern sie zum Beispiel ausgefeilte datentechnische Fähigkeiten für die Implementierung und Verwaltung, geringe Latenzzeiten und einen hohen Durchsatz, insbesondere bei der Verarbeitung großer Datenmengen.

Grundlegende Konzepte der Daten-Streaming-Technologien

Daten-Streaming-Technologien beruhen auf mehreren grundlegenden Konzepten. Das Verständnis dieser Konzepte ist entscheidend, um die Möglichkeiten der Echtzeit-Datenverarbeitung voll auszuschöpfen:

Datenströme

Datenströme sind kontinuierliche Datenflüsse aus verschiedenen Quellen, wie IoT-Geräten, Protokolldateien, Börsen usw. Diese Datenquellen erzeugen Daten mit hoher Geschwindigkeit, oft in Echtzeit oder nahezu in Echtzeit, und die erzeugten Daten sind in der Regel zeitkritisch, d. h. ihre Relevanz nimmt mit der Zeit ab.

Stream-Verarbeitung

Stream Processing ist die Echtzeitverarbeitung von Datenströmen. Im Gegensatz zur Stapelverarbeitung, bei der die Daten in geplanten Intervallen verarbeitet werden, werden bei der Stream-Verarbeitung die Daten verarbeitet, sobald sie ankommen. Dies ermöglicht eine geringe Latenzzeit, die für zeitkritische Anwendungen wie die Verfolgung von Benutzerpositionen oder Rohstoffpreisen und die darauf basierende Entscheidungsfindung unerlässlich ist.

Stapelverarbeitung vs. Stream-Verarbeitung

Stapelverarbeitung und Stream Processing sind zwei unterschiedliche Ansätze für die Datenverarbeitung. Die Stapelverarbeitung verarbeitet große Datenmengen auf einmal und in geplanten Intervallen und eignet sich für nicht zeitabhängige Datenanalyseaufgaben. Die Stream-Verarbeitung hingegen verarbeitet Daten, sobald sie generiert werden, und liefert Erkenntnisse in Echtzeit.

Im Zusammenhang mit der Verarbeitung von Datenströmen wird auch der Begriff "Micro-Batch" verwendet. Dieser Ansatz liegt zwischen der Batch- und der Stream-Verarbeitung, wenn sehr frische Daten benötigt werden, aber nicht unbedingt in Echtzeit.

Architektur des Datenstroms

Die typische Architektur von Daten-Streaming-Technologien umfasst Datenquellen, Dateneingabesysteme, Stream-Verarbeitungssysteme und Datenspeichersysteme.

Datenquellen erzeugen Datenströme.
Datenaufnahmesysteme wie Apache Kafka oder Amazon Kinesis erfassen diese Datenströme zur Verarbeitung.
Ein Stream-Prozessor, wie z. B. Apache Flink oder Apache Spark Streaming, verarbeitet die aufgenommenen Daten in Echtzeit.
Die verarbeiteten Daten werden dann in Data Lakes oder Data Warehouses für weitere Analysen oder Visualisierungs-Dashboards gespeichert.
Die Daten können mit Systemen wie der PubNub Kafka Bridge direkt an den Rand Ihres Netzwerks gestreamt werden.

Die Daten fließen in Datenpipelines durch die Architektur von der Quelle zum Ziel. Im Wesentlichen stellen Datenpipelines den Weg der Daten von ihrem Ursprungsort über die Aufnahme, Verarbeitung und schließlich die Speicherung oder Visualisierung dar.

Datenkonsistenz

Die Datenkonsistenz ist ein wichtiges Anliegen beim Daten-Streaming. Daten-Streaming-Technologien verwenden verschiedene Techniken wie Ereignisreihenfolge, Exact-once-Verarbeitung und Fehlertoleranz, um die Konsistenz zu gewährleisten. Diese Techniken stellen sicher, dass die Daten in der richtigen Reihenfolge verarbeitet werden, dass keine Daten verloren gehen oder mehrfach verarbeitet werden und dass das System sich von Fehlern ohne Datenverlust erholen kann.

PubNub bietet beispielsweise mehrere Möglichkeiten, die Zustellung von Nachrichten zu garantieren, wie Lesebestätigungen, Nachrichtenreihenfolge und Warteschlangen.

Werkzeuge für Daten-Streaming-Technologien

Es gibt verschiedene Open-Source- und kommerzielle Tools für die Implementierung von Daten-Streaming-Technologien. Dazu gehören Apache Kafka, Apache Flink, AWS Kinesis und Microsoft Azure Stream Analytics. Jedes Tool hat seine eigenen Stärken und Anwendungsfälle, und die Wahl des Tools hängt von den spezifischen Anforderungen der Daten-Streaming-Anwendung ab.

Nächste Schritte mit PubNub Data Streaming

Nachdem Sie die grundlegenden Konzepte und die Architektur von Daten-Streaming-Technologien verstanden haben, ist der nächste Schritt die Implementierung dieser Technologien in Ihre eigenen Systeme. PubNub bietet eine robuste und skalierbare Echtzeit-Datenstreaming-Plattform, die sich leicht in Ihre bestehende Architektur integrieren lässt.

Hier sind die Schritte, um mit PubNub Data Streaming zu beginnen:

Demos erkunden: PubNub stellt eine Echtzeit-Daten-Streaming-Demo zur Verfügung, damit Sie verstehen, wie unsere Plattform funktioniert. Diese Demo eignet sich für eine Vielzahl von Anwendungsfällen, von Chat-Apps bis zur Steuerung von IoT-Geräten.
Verstehen Sie die Grundlagen: PubNub stellt ein umfassendes Glossar zur Verfügung, in dem die wichtigsten Begriffe und Konzepte beschrieben werden, einschließlich eines Eintrags zum Daten-Streaming.
Verstehen Sie PubNub Illuminate: Mit PubNub Illuminate können Sie Monetarisierungsstrategien im Handumdrehen anpassen, das Nutzerverhalten mit Anreizen verknüpfen, jede Aktion mit benutzerdefinierten Echtzeit-Aggregat- und Gerätemetriken verfolgen und die Ergebnisse sofort sehen - und das alles, ohne Ihr Entwicklerteam zu belasten.
Anmeldung: Melden Sie sich für ein PubNub-Konto an. Sie können dies auf der Registrierungsseite tun. Die kostenlose Version Ihres PubNub-Kontos verfügt über großzügige Limits und erfordert keine Kreditkarte, bis Sie zum Upgrade bereit sind.
Beginnen Sie zu bauen: Sobald Sie die Grundlagen beherrschen, können Sie Ihre eigenen Daten-Streaming-Anwendungen erstellen. PubNub bietet eine Vielzahl von Tutorials, die Sie durch die Erstellung verschiedener Anwendungstypen führen, darunter auch ein Tutorial zur Erstellung einer Echtzeit-Datenstreaming-Anwendung.
Erkunden Sie APIs: PubNub bietet eine breite Palette von APIs und SDKs, die Sie für die Erstellung Ihrer Anwendungen nutzen können. Weitere Informationen finden Sie auf unserer SDK-Dokumentationsseite.
Die*Preisgestaltung verstehen*: Bevor Sie mit der Entwicklung beginnen, sollten Sie wissen, wie viel das Ganze kosten wird. Weitere Informationen über die Preise von PubNub finden Sie auf der Preisseite des Unternehmens.

Tieferer Einblick in die Anwendungsfälle für Daten-Streaming-Technologien

Datenanalyse in Echtzeit

Einer der wichtigsten Anwendungsfälle für Daten-Streaming-Technologien ist die Datenanalyse in Echtzeit. Durch die Verarbeitung und Analyse von Datenströmen in Echtzeit können Unternehmen sofortige Einblicke in ihre Abläufe gewinnen und schnelle, fundierte Entscheidungen treffen. Dies kann besonders in Branchen wie dem Finanzwesen nützlich sein, wo Echtzeit-Datenanalysen für die Erkennung von Betrug, die Analyse von Markttrends und vieles mehr eingesetzt werden können.

PubNub Illuminate ist ein Beispiel für eine Echtzeit-Analyseplattform. PubNub Illuminate ist jedoch mehr als nur eine Plattform für die Datenverwaltung, sondern ermöglicht es Ihnen auch, Bedingungen auf der Grundlage Ihrer Datenmetriken zu definieren, die, wenn sie ausgelöst werden, dynamische Aktionen auf der Grundlage dieser Daten durchführen.

Internet der Dinge (IoT)

Eine weitere wichtige Anwendung von Datenstreaming-Technologien ist das Internet der Dinge (IoT), wo Geräte Datenströme erzeugen, die in Echtzeit verarbeitet werden können, um wertvolle Erkenntnisse zu gewinnen. Die Überwachung der Leistung von Industrieanlagen beispielsweise ermöglicht es Unternehmen, Probleme zu erkennen und zu beheben, bevor sie zu einem Ausfall der Anlagen führen.

Analyse sozialer Medien

Social-Media-Plattformen erzeugen jede Sekunde riesige Datenmengen, die mit Hilfe von Data-Streaming-Technologien in Echtzeit verarbeitet werden können. So können Unternehmen Trends überwachen, die Stimmung der Kunden verfolgen und sofort auf Kundenfeedback reagieren.

Elektronischer Handel

In der E-Commerce-Branche können Data-Streaming-Technologien das Kundenverhalten in Echtzeit verfolgen, so dass Unternehmen personalisierte Empfehlungen geben, das Kundenerlebnis verbessern und den Umsatz steigern können.

Zukünftige Trends bei Daten-Streaming-Technologien

Integration mit maschinellem Lernen und KI

Einer der wichtigsten Trends bei Daten-Streaming-Technologien ist die Integration von maschinellem Lernen und generativer KI. Modelle für maschinelles Lernen können mit den Echtzeitdaten versorgt werden, die für genaue und rechtzeitige Vorhersagen erforderlich sind. Dies kann insbesondere für die vorausschauende Wartung von Nutzen sein, bei der Modelle des maschinellen Lernens auf der Grundlage von Echtzeitdaten Ausfälle von Bauteilen vorhersagen können - zum Beispiel können die Entladezyklen eines mobilen Geräts genutzt werden, um die voraussichtliche Lebensdauer des Akkus abzuschätzen.

Vermehrter Einsatz von Open-Source-Frameworks

Open-Source-Frameworks wie Apache Kafka, Apache Flink und Spark Streaming sind zu beliebten Tools für die Implementierung von Daten-Streaming-Technologien geworden. Diese Frameworks bieten robuste Funktionen für die Verarbeitung großer Datenmengen in Echtzeit, und ihr Open-Source-Charakter macht sie in hohem Maße anpassungsfähig und für verschiedene Anwendungsfälle nutzbar. Wir erwarten, dass diese und andere Open-Source-Frameworks in Zukunft verstärkt zum Einsatz kommen werden.

Stärkere Betonung von Datensicherheit und Datenschutz

Da Unternehmen bei der Verarbeitung sensibler Daten zunehmend auf Data-Streaming-Technologien zurückgreifen, werden Datensicherheit und Datenschutz stärker in den Vordergrund rücken. Dazu gehört die Implementierung robuster Sicherheitsmaßnahmen, um Datenströme vor unbefugtem Zugriff zu schützen und die Einhaltung von Datenschutzbestimmungen zu gewährleisten.

Fortgeschrittenere Data-Engineering-Techniken

Wir erwarten, dass mit zunehmender Vertrautheit der Ingenieure mit den Technologien auch fortschrittlichere Data-Engineering-Techniken zum Einsatz kommen werden, einschließlich ausgefeilterer Algorithmen für die Verarbeitung von Datenströmen, die Optimierung von Datenpipelines und die Gewährleistung der Datenkonsistenz.

Fazit

Die Zukunft der Daten-Streaming-Technologien sieht rosig aus. Indem sie den Unternehmen bessere betriebliche Einblicke in Echtzeit bieten, können sie sofortige Maßnahmen ergreifen, ohne sich auf historische Daten verlassen zu müssen, und so die Kundenzufriedenheit, Effizienz und Rentabilität steigern. Unabhängig von Ihrer Branche, ob Kundenmanagement, E-Commerce, IoT oder Social-Media-Analyse, haben Data-Streaming-Technologien das Potenzial, die Arbeitsweise von Unternehmen zu verändern.

PubNub kann Ihnen dabei helfen, Ihr Unternehmen mit Streaming-Daten zu verändern. Wenden Sie sich an das DevRel-Team unter devrel@pubnub.com oder an unser Support-Team, wenn Sie Hilfe zu einem beliebigen Aspekt Ihrer PubNub-Entwicklung benötigen.

Wie kann PubNub Ihnen helfen?

Dieser Artikel wurde ursprünglich auf PubNub.com veröffentlicht.

Unsere Plattform hilft Entwicklern bei der Erstellung, Bereitstellung und Verwaltung von Echtzeit-Interaktivität für Webanwendungen, mobile Anwendungen und IoT-Geräte.

PubNub erleben

Sehen Sie sich die Live Tour an, um in weniger als 5 Minuten die grundlegenden Konzepte hinter jeder PubNub-gestützten App zu verstehen

Einrichten

Melden Sie sich für einen PubNub-Account an und erhalten Sie sofort kostenlosen Zugang zu den PubNub-Schlüsseln

Beginnen Sie

Mit den PubNub-Dokumenten können Sie sofort loslegen, unabhängig von Ihrem Anwendungsfall oder SDK

Chat-Moderation mit OpenAI

PubNub Developer Relations — Wed, 03 Jul 2024 15:37:11 +0000

Jede Anwendung, die einen In-App-Chat enthält, benötigt eine Möglichkeit, die Nachrichten, die Nutzer austauschen können, zu regulieren und zu moderieren. Da es nicht möglich ist, alle unangemessenen Inhalte durch menschliche Moderatoren zu moderieren, muss das Moderationssystem automatisch sein. Da Nutzer häufig versuchen werden, die Moderation zu umgehen, sind maschinelles Lernen, generative KI und große Sprachmodelle (LLMs) [und GPT-Modelle wie GPT-3 und GPT-4] beliebte Methoden zur Moderation von Inhalten.

Moderation ist ein komplexes Thema, und PubNub bietet verschiedene Lösungen, um alle Anwendungsfälle unserer Entwickler zu erfüllen.

PubNub-Funktionen können Nachrichten abfangen und verändern, bevor sie ihr Ziel erreichen. Sie können innerhalb einer Funktion benutzerdefinierte Logik anwenden, einschließlich des Aufrufs einer externen REST-API, so dass Sie jeden externen Dienst für die Nachrichtenmoderation nutzen können. Dieser Ansatz wird in diesem Artikel für die Integration mit OpenAI verwendet.
PubNub-Funktionen bieten benutzerdefinierte Integrationen, die Inhaltsmoderation und Stimmungsanalyse unterstützen, darunter Lasso Moderation, Tisane, ein RegEx-basierter Profanitätsfilter, Lexalytics und Community Sift.
Der BizOps Workspace von PubNub kann Konversationen überwachen und moderieren, einschließlich der Möglichkeit, Nachrichten zu bearbeiten und zu löschen.

Der Open AI Moderationsendpunkt

Dieser Artikel befasst sich mit der Moderation API von OpenAI, einer REST-API, die mithilfe von künstlicher Intelligenz (KI) feststellt, ob der bereitgestellte Text potenziell schädliche Begriffe enthält. Die API soll es Entwicklern ermöglichen, schädliche Inhalte zu filtern oder zu entfernen, und wird zum Zeitpunkt der Erstellung dieses Artikels kostenlos zur Verfügung gestellt, unterstützt jedoch nur Englisch.

Das Modell hinter der Moderations-API kategorisiert den bereitgestellten Text wie folgt (aus der API-Dokumentation):

Hass: Inhalte, die Hass aufgrund von Rasse, Geschlecht, ethnischer Zugehörigkeit, Religion, Nationalität, sexueller Orientierung, Behinderungsstatus oder Kaste ausdrücken, dazu auffordern oder fördern. Hassvolle Inhalte, die sich gegen nicht geschützte Gruppen richten (z. B. Schachspieler), gelten als Belästigung.
Hass / Bedrohung: Hassvolle Inhalte, die auch Gewalt oder ernsthaften Schaden gegenüber der Zielgruppe aufgrund von Rasse, Geschlecht, ethnischer Herkunft, Religion, Nationalität, sexueller Orientierung, Behinderung oder Kaste beinhalten.
Belästigung: Inhalte, die eine belästigende Sprache gegenüber einer beliebigen Zielperson ausdrücken, dazu auffordern oder fördern.
Belästigung/Bedrohung: Belästigende Inhalte, die auch Gewalt oder ernsthaften Schaden für eine beliebige Zielgruppe beinhalten.
Selbstbeschädigung: Inhalte, die zu selbstbeschädigenden Handlungen wie Selbstmord, Schneiden und Essstörungen auffordern, ermutigen oder diese darstellen.
Selbstbeschädigung/Absicht: Inhalte, in denen der Sprecher zum Ausdruck bringt, dass er selbstschädigende Handlungen wie Selbstmord, Schneiden und Essstörungen vornimmt oder vorhat, diese vorzunehmen.
Selbstbeschädigung/Anweisungen: Inhalte, die zu selbstschädigenden Handlungen wie Selbstmord, Schneiden und Essstörungen ermutigen oder Anweisungen oder Ratschläge geben, wie man solche Handlungen vornimmt.
Sexuell: Inhalte, die sexuelle Erregung hervorrufen sollen, wie z. B. die Beschreibung sexueller Aktivitäten, oder die für sexuelle Dienstleistungen werben (ausgenommen Sexualerziehung und Wellness).
Sexuell / Minderjährige: Sexuelle Inhalte, die eine Person unter 18 Jahren zeigen.
Gewalttätigkeit: Inhalte, in denen Tod, Gewalt oder körperliche Verletzungen dargestellt werden.
Gewalt/Grafik: Inhalte, die Tod, Gewalt oder Körperverletzung in grafischen Details darstellen.

Die Ergebnisse werden in einer JSON-Struktur wie folgt bereitgestellt (wiederum aus der API-Dokumentation entnommen):

{
  "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
      }
    }
  ]
}

Aufrufen der Open AI Moderation API von PubNub

Die*Integration der Moderations-API in eine beliebige PubNub-Anwendung ist mit Hilfe von PubNub-Funktionen ganz einfach*, wenn Sie dieser Schritt-für-Schritt-Anleitung folgen:

Funktionen ermöglichen es Ihnen, Echtzeit-Ereignisse auf der PubNub-Plattform zu erfassen, z. B. gesendete und empfangene Nachrichten; Sie können dann innerhalb dieser Funktionen benutzerdefinierten serverlosen Code schreiben, um Nachrichten nach Bedarf zu ändern, umzuleiten, zu ergänzen oder zu filtern.

Sie müssen den Ereignistyp "Before Publish or Fire" verwenden; dieser Funktionstyp wird aufgerufen , bevor die Nachricht zugestellt wird, und muss seine Ausführung beenden, bevor die Nachricht zur Zustellung an die Empfänger freigegeben wird. Die PubNub-Dokumentation bietet weitere Hintergründe und Details, aber zusammenfassend lässt sich sagen: "Before Publish or Fire" ist ein synchroner Aufruf, der eine Nachricht oder ihre Nutzlast ändern kann .

Erstellen Sie die PubNub-Funktion

Loggen Sie sich in das PubNub-Administrationsportal ein und wählen Sie die Anwendung und das Keyset für die App aus, die Sie moderieren möchten.
Wählen Sie "Funktionen", die Sie unter dem Reiter "Erstellen" finden.
Wählen Sie '+ CREATE NEW MODULE' und geben Sie dem Modul einen Namen und eine Beschreibung
Wählen Sie "+ NEUE FUNKTION ERSTELLEN" und geben Sie der Funktion einen Namen.
Wählen Sie für den Ereignistyp "Vor Veröffentlichung oder Feuer".
Geben Sie für den Kanalnamen * ein (in dieser Demo wird * verwendet, aber Ihre Anwendung kann hier nur die Kanäle angeben, die Sie moderieren möchten)

Nachdem Sie die PubNub-Funktion erstellt haben, müssen Sie Ihren Open AI API-Schlüssel als Geheimnis angeben.

Wählen Sie 'MY SECRETS' und erstellen Sie einen neuen Schlüssel mit dem Namen 'OPENAI_API_KEY'.
Generieren Sie einen Open AI API-Schlüssel und stellen Sie sicher, dass dieser Schlüssel Zugriff auf die moderate API hat.
Geben Sie den generierten API-Schlüssel an das gerade erstellte PubNub-Funktionsgeheimnis weiter.

Der Körper der PubNub-Funktion sieht wie folgt aus:

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";
    });
}

Die Funktion selbst ist recht einfach:

Für jede empfangene Nachricht:

Übergeben Sie sie an die Open AI-Moderationsfunktion
Fügen Sie das zurückgegebene Moderationsobjekt als neuen Schlüssel an das Message (JSON) Objekt an.

Speichern Sie Ihre Funktion und stellen Sie sicher, dass Ihr Modul gestartet ist.

Latenzzeit

Die PubNub-Funktion, die Sie soeben erstellt haben, wird jedes Mal synchron ausgeführt, wenn eine Nachricht gesendet wird, und die Nachricht wird erst ausgeliefert, wenn die Funktion fertig ausgeführt ist. Da die Funktion einen Aufruf an eine externe API enthält, hängt die Auslieferungslatenz davon ab, wie schnell der API-Aufruf an Open AI zurückkommt, was außerhalb der Kontrolle von PubNub liegt und ziemlich hoch sein kann.

Es gibt mehrere Möglichkeiten, die Beeinträchtigung des Benutzererlebnisses abzumildern. Die meisten Implementierungen geben dem Absender eine sofortige Rückmeldung, dass die Nachricht gesendet wurde und verlassen sich dann auf Lesebestätigungen, um anzuzeigen, dass die Nachricht zugestellt (oder gemeldet) wurde.

Aktualisieren der Client-Anwendung

Betrachten wir, was erforderlich wäre, um den Moderations-Payload innerhalb Ihrer Anwendung zu handhaben, indem wir die Chat-Demo verwenden, die eine React-Anwendung ist, die das PubNub Chat SDK verwendet, um die meisten Funktionen einer typischen Chat-Anwendung zu zeigen.

Richten Sie ein Attribut ein, um zu verfolgen, ob eine potenziell schädliche Nachricht angezeigt werden soll oder nicht:

 const [showHarmfulMessage, setShowHarmfulMessage] = useState(false)

Und fügen Sie eine Logik hinzu, um eine potenziell schädliche Nachricht standardmäßig nicht anzuzeigen, in diesem Fall in 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>
}

Beachten Sie, dass diese Änderungen nicht in der gehosteten Version der Chat-Demo enthalten sind, aber die ReadMe enthält vollständige Anweisungen, um sie selbst zu erstellen und von Ihrem eigenen Keyset aus auszuführen.

Einpacken

Und da haben Sie es, eine schnelle und einfache (und kostenlose) Möglichkeit, Ihrer Anwendung mit Open AI sowohl Moderation als auch Sentiment-Analyse hinzuzufügen.

Um mehr über die Integration von Open AI mit PubNub zu erfahren, schauen Sie sich diese anderen Ressourcen an:

OpenAI GPT API Integration mit Funktionen
Erstellen Sie einen Chatbot mit PubNub und ChatGPT (Hinzufügen eines Chatbots zu unserem PubNub-Showcase)
Erweitern Sie eine Geo-App mit PubNub & Chat GPT / OpenAI

Wenden Sie sich an das DevRel-Team unter devrel@pubnub.com oder an unser Support-Team, wenn Sie Hilfe zu einem beliebigen Aspekt Ihrer PubNub-Entwicklung benötigen.

Wie kann PubNub Ihnen helfen?

Dieser Artikel wurde ursprünglich auf PubNub.com veröffentlicht.

Unsere Plattform hilft Entwicklern bei der Erstellung, Bereitstellung und Verwaltung von Echtzeit-Interaktivität für Webanwendungen, mobile Anwendungen und IoT-Geräte.

PubNub erleben

Sehen Sie sich die Live Tour an, um in weniger als 5 Minuten die grundlegenden Konzepte hinter jeder PubNub-gestützten App zu verstehen

Einrichten

Melden Sie sich für einen PubNub-Account an und erhalten Sie sofort kostenlosen Zugang zu den PubNub-Schlüsseln

Beginnen Sie

Mit den PubNub-Dokumenten können Sie sofort loslegen, unabhängig von Ihrem Anwendungsfall oder SDK

So verwenden Sie Illuminate für die Balance Ihrer Spiele

PubNub Developer Relations — Wed, 03 Jul 2024 06:51:05 +0000

Die neueste Produktversion von PubNub, Illuminate, ist ein skalierbares Entscheidungsfindungstool, das wir entwickelt haben, um Spieleentwicklern, Produktmanagern und Projektmanagern bei der Entwicklung, Iteration und beim Experimentieren innerhalb der PubNub-Plattform zu helfen.

Illuminate wurde von Grund auf mit einer großartigen Benutzeroberfläche entwickelt und hilft Ihnen, Entscheidungen zu treffen, um das Spielerlebnis zu verbessern und die Monetarisierung in Echtzeit zu beschleunigen.

Was also ist Game Balancing und wie kann man es in Echtzeit nutzen?

Die Spielbalance ist ein Teilbereich des Spieldesigns, der das Gameplay und die Benutzererfahrung verbessert, indem er Schwierigkeit und Fairness ausbalanciert. Die Spielbalance besteht aus der Anpassung von Belohnungen, Herausforderungen und/oder Elementen eines Spiels, um das gewünschte Spielerlebnis zu schaffen.

Unter Spielbalance versteht man im Allgemeinen die Einführung von Fairness für die Spieler. Dies beinhaltet;

Anpassen der Schwierigkeit,
Änderung der Gewinn-/Verlustbedingungen
Spielzustände
Wirtschaftliches Gleichgewicht

Weitere Informationen zum Spielbalancing finden Sie auf Wikipedia.

Der Einsatz von Spielbalance in Echtzeit kann dazu beitragen, die Spieler bei der Stange zu halten, neuen Spielern das Gefühl zu geben, willkommen zu sein, und möglicherweise das Gameplay zu monetarisieren.

Wie kann Illuminate Ihnen helfen, Ihre Spieler bei der Stange zu halten?

Wie bereits erwähnt, ist Illuminate ein Werkzeug zur Entscheidungsfindung in Echtzeit. Um unsere Spieler bei der Stange zu halten, werden wir uns auf neue Spieler konzentrieren, die neu im Spiel sind und möglicherweise etwas Hilfe brauchen, um sich an die Spielweise zu gewöhnen.

In diesem Beispiel habe ich eine altmodische Kopie von Asteroids gebaut, die in JavaScript geschrieben ist und vollständig auf PubNub-Funktionen gehostet wird. Weitere Informationen über PubNub-Funktionen finden Sie unter https://www.pubnub.com/docs/serverless/functions/overview.

Zunächst zur Einführung in die Szene.

Stellen Sie sich vor, ein neuer Spieler tritt Ihrem Spiel bei und fängt an zu spielen, er verliert und beginnt sich zu langweilen, weil es keine Fortschritte gibt.

Über eine Veröffentlichung können wir eine Nachricht aus dem Spiel an PubNub senden, die Illuminate über den Fortschritt und den Punktestand des Spielers informiert. Illuminate trifft einige Entscheidungen auf der Grundlage vordefinierter Metriken und sendet dann eine Nachricht an den Spieler zurück, in der ihm die Möglichkeit geboten wird, drei Leben zu kaufen oder eine kostenpflichtige Werbeaktion im Austausch für zwei Leben anzusehen.

Schauen wir uns die Bildschirme an.

Das Spiel beginnt ganz normal, aber wie Sie sehen können, bin ich wirklich kein guter Spieler und starb mit nur 70 Punkten.

Um mir zu helfen, weiterzuspielen, hat Illuminate diese Punktzahl erhalten und berechnet, dass ich die Möglichkeit haben sollte, ein paar Leben zu kaufen oder eine Werbung zu sehen, um ein paar Leben zu bekommen.

Ich entschied mich dafür, etwas Geld auszugeben, und konnte so einige Leben kaufen und schnell wieder ins Spiel einsteigen.

Ein Blick hinter die Kulissen von Illuminate.

Du findest Illuminate in deinem PubNub-Kontoportal - https://admin.pubnub.com/, unter der Rubrik "Optimieren".

Als erstes schauen wir uns unsere Business Objects an. Business Objects sind der Weg, um Daten in Illuminate zu erhalten, sie helfen uns zu definieren, welche Art von Daten wir erfassen müssen und woher sie kommen.

Sie können definieren, welche Daten Sie verfolgen wollen, indem Sie Kennzahlen hinzufügen und wie Sie diese Daten segmentieren wollen, indem Sie Dimensionen hinzufügen.

Wenn du Hilfe bei der Einrichtung von Illuminate brauchst, findest du die entsprechenden Dokumente hier: https://www.pubnub.com/docs/illuminate/basics

Um ein Spiel auszubalancieren, muss man wissen, was man nachverfolgen will und was man neuen Spielern anbieten will, um sie bei der Stange zu halten.

Das ist die Stärke von Illuminate: Ohne jegliche Programmierung können wir Variablen hinzufügen, entfernen oder ändern, um das Angebot für verschiedene Spieler zu verfeinern und sogar anzupassen.

In diesem einfachen Beispiel habe ich mich dafür entschieden, die Punktzahl des Spiels zu messen, aber Sie könnten leicht andere Messgrößen hinzufügen; Beispiele hierfür sind;

Ist der Spieler ein Gast, oder hat er ein Konto auf Ihrer Spielplattform
Gesamtlänge des Spiels
Gerätetyp - Web, Handy, TV.
Hat der Spieler bei früheren Veranstaltungen oder Spielen bereits etwas von Ihnen gekauft?

Um auf meine Geschäftsziele zurückzukommen, möchte ich Ihnen die Maßnahmen vorstellen, mit denen ich arbeite.

Ich fasse das mal zusammen:

Maßnahmen: Numerische Werte, die man messen oder addieren kann.

Dimensionen: Qualitative Werte, die zur Segmentierung von Maßnahmen verwendet werden können.

Metriken: Die Aggregation Ihrer Kennzahlen, segmentiert nach den von Ihnen gewählten Dimensionen.

Entscheidungen: Eine Sammlung von Bedingungen und Aktionen. Wenn die Bedingungen erfüllt sind, wird die entsprechende Aktion ausgelöst.

Dashboards: Eine Sammlung von Echtzeit-Diagrammen, die Ihre Messgrößen und Entscheidungen visualisieren.

In meinem Beispiel ist eine Kennzahl, die ich verwende, dass der Kunde Illuminate um Hilfe bittet, wenn der Punktestand unter 500 Punkten liegt.

Dies habe ich dann auf eine Entscheidung übertragen: "Wenn ein Spieler weniger als 500 Punkte hat, biete ihm die Möglichkeit an, Leben zu kaufen oder eine Werbung zu sehen".

Sobald der Spieler auswählt, ob er sich eine Werbung ansehen oder Leben kaufen möchte, wird dies als Metrik zurückgemeldet, die dann auf meinem Dashboard angezeigt wird.

Hier sehen Sie eine vereinfachte Ansicht meines Game-Balancing-Dashboards. Sie können sehen, dass wir verfolgen, welche Spieler weniger als 500 Punkte bekommen haben und welche Spieler sich dafür entschieden haben, für ihre Leben zu bezahlen, anstatt eine Werbung zu sehen.

Auch hier gibt es viele Möglichkeiten, die Komplexität zu erhöhen;

Würden mehr Spieler für zusätzliche Leben bezahlen, wenn die Leben billig wären?
Würden sie sich eine 30-sekündige oder eine 3-minütige Werbung ansehen?

Vs. der traditionelle Ansatz?

Strategiespiele? Online-Spiele? Es kann ein langwieriger Prozess sein, das Spielerlebnis und die Spielmechanik für alle Spieler in Einklang zu bringen. Vor der Markteinführung sollten Sie die verschiedenen Spielelemente testen, das Einführungs-Tutorial erstellen und auf der Grundlage des Spielerverhaltens für ein progressives Leveldesign sorgen, um sowohl die Spielzeit zu maximieren als auch zu verhindern, dass das Spiel zu leicht ist. Nach der Markteinführung können Sie die Spielerforen überwachen, die Analyse der Spielerbindung und der Spieleraktionen überprüfen und dann Patches veröffentlichen, um etwaige Gleichgewichtsprobleme zu beheben ... und dabei hoffentlich nicht Ihr Spiel zu verschlimmbessern!

Dies kann ein sehr langer Analyse- und Veröffentlichungszyklus sein, und genau dabei kann Illuminate helfen. Sie können unabhängig von Ihrem Spieltyp Entscheidungen in Echtzeit treffen: Vielleicht haben Sie ein Multiplayer-Spiel wie ein FPS oder ein RPG, ein Einzelspieler-Kampfspiel auf Steam oder eine Kampfarena wie League of Legends. Solange es sich um ein Online-Videospiel handelt, bei dem das Gleichgewicht zwischen den Spielern beeinflusst werden kann, indem man in diesem Moment handelt, kann Illuminate das Spielerlebnis verbessern - ich habe bei der PM nachgefragt, und sie sagen, dass Brett- und Kartenspiele noch nicht auf der Roadmap stehen :(

Einpacken

Die Verwendung von PubNub's Illuminate für die Spielbalance ist ein schneller, codefreier Weg, um sofortige Entscheidungsreaktionen und Werkzeuge in Ihre App einzuführen, die Ihr Spielerlebnis verbessern.

Um mehr darüber zu erfahren, wie du dein erstes Spiel mit Echtzeit-Aktionen erstellst, sieh dir unsere Illuminate for gaming Seite und unsere Dokumentation an. Unser Support-Team kann Ihnen auch mit Richtlinien und Empfehlungen helfen. Hoffentlich sehen wir Sie auf der nächsten GDC-Konferenz, wo wir gerne hören würden, was Sie mit PubNub entwickelt haben!

Wie kann PubNub Ihnen helfen?

Dieser Artikel wurde ursprünglich auf PubNub.com veröffentlicht.

Unsere Plattform unterstützt Entwickler bei der Erstellung, Bereitstellung und Verwaltung von Echtzeit-Interaktivität für Webanwendungen, mobile Anwendungen und IoT-Geräte.

PubNub erleben

Sehen Sie sich die Live Tour an, um in weniger als 5 Minuten die grundlegenden Konzepte hinter jeder PubNub-gestützten App zu verstehen

Einrichten

Melden Sie sich für einen PubNub-Account an und erhalten Sie sofort kostenlosen Zugang zu den PubNub-Schlüsseln

Beginnen Sie

Mit den PubNub-Dokumenten können Sie sofort loslegen, unabhängig von Ihrem Anwendungsfall oder SDK

JavaScript Geolocation Tracking mit Google Maps API

PubNub Developer Relations — Fri, 31 May 2024 14:40:47 +0000

Hier ist der aktualisierte Blogbeitrag, in den alle Schlüsselwörter nahtlos eingebettet sind.

Dies ist der Abschluss der vierteiligen Serie über die Erstellung von Live-Echtzeit-Webanwendungen mit Geolokalisierungsfunktionen mithilfe der Google Maps JavaScript API und PubNub. Unser Tutorial führt Sie durch die Benutzererfahrung bei der Erstellung von Flugrouten mit JavaScript und PubNub.

Ein Beispiel dafür, wie dies alles umgesetzt wird, finden Sie in unserer Showcase-Demo auf der PubNub-Website. Navigieren Sie zur Geolocation-Demo, um zu sehen, wie wir PubNub mit Echtzeit-Tracking einbinden. Den Code hinter der Demo finden Sie auf unserer Github-Website.

Was sind Flugpfade?

Flugpfade, wie sie in diesem Tutorial implementiert sind, beziehen sich auf Polylinien, die das dynamische Zeichnen von Pfaden durch benutzerdefinierte Punkte auf einer Karte ermöglichen, die sich entweder auf Ihrem mobilen Gerät oder im Webbrowser befindet. Sie sind integraler Bestandteil der HTML5 Geolocation API und der Google Maps API zur Verfolgung von Bewegungsmustern.

Überblick über das Tutorial

Vergewissern Sie sich, dass Sie die Voraussetzungen aus den Teilen eins, zwei und drei erfüllt haben, , in denen wir unsere JavaScript-Umgebung eingerichtet und Kartenmarkierungen und Standortverfolgung behandelt haben.

Wenn Sie dies getan haben, fahren Sie mit dem nächsten Teil fort.

Code-Walkthrough

Beginnen wir mit der Definition der let'-Variablen \map, \markund \lineCoords, um unsere Karten-, Markierungs- und **Polylinien-Koordinatenobjekte** zu speichern. Auf diese Weise können wir sie anpassen, wenn PubNub-Ereignisse eintreffen. Anschließend definieren wir den \initialize-Callback, der von der [Google Maps JavaScript-API](https://developers.google.com/maps/documentation/javascript/overview) verwendet werden kann, wenn sie bereit zum Laden ist. Stellen Sie sicher, dass Sie \YOUR_GOOGLE_MAPS_API_KEY` durch Ihren tatsächlichen API-Schlüssel ersetzen.

js 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;

Mit dem 'redraw'-Ereignishandler aktualisieren wir nun die neuen Standortinformationen, indem wir die Methode 'getCurrentPosition()' von Geolocation aufrufen.

Lat/Long

Als Nächstes definieren wir einen "redraw"-Ereignishandler, den wir immer dann aufrufen, wenn wir ein neues Positionsänderungsereignis erhalten. Im ersten Teil der Funktion setzen wir den Breiten- und Längengrad auf die neuen Werte aus der Nachricht. Dann rufen wir die entsprechenden Methoden auf den Objekten Karte, Marker und Polylinie auf, um die Position zu aktualisieren, sie dem Ende der Linie hinzuzufügen und die Karte neu zu zentrieren.

js 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); };

PubNub initialisieren

Nachdem wir unsere Callbacks definiert haben, initialisieren wir die PubNub-Echtzeitdaten-Streaming-Funktionalität, die auf Mobiltelefonen, Tablets, Browsern und Laptops über Tech-Stacks wie iOS, Android, JavaScript, .NET, Java, Ruby, Python, PHP und mehr funktioniert.

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

Die PubNub-Funktionalität zum Veröffentlichen und Abonnieren von Themen in Echtzeitkanälen bietet effiziente Daten-Streaming-Funktionen.

Veröffentlichung von Lat/Long

Für dieses einfache Tutorial richten wir einen einfachen JavaScript-Intervall-Timer ein, um neue Positionen auf der Grundlage der aktuellen Zeit zu veröffentlichen. Alle 500 Millisekunden rufen wir die anonyme Callback-Funktion auf, die ein neues Latitude/Longitude-Objekt (mit Koordinaten, die sich nach Nordosten bewegen) im angegebenen PubNub-Kanal veröffentlicht. In Ihrer Anwendung werden Sie die Position wahrscheinlich von einer Live-Geräteposition oder einem vom Benutzer gemeldeten Standort erhalten.

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

Zu guter Letzt initialisieren wir die Google Maps API, um sicherzustellen, dass die DOM-Elemente und JavaScript-Voraussetzungen erfüllt sind.

`js

Zusammenfassung

Diese Tutorial-Serie hat uns gezeigt, wie die Google Maps API und PubNub außergewöhnlich gut für die Echtzeit-Standortverfolgung in Web- und Mobil-Apps zusammenarbeiten. Dies ist vergleichbar mit der Art und Weise, wie Ride-Hailing-Dienste wie Uber und Lyft die Bewegung ihrer Fahrzeuge in Echtzeit anzeigen.

PubNub erleben

Schauen Sie sich die Live Tour an, um in weniger als 5 Minuten die grundlegenden Konzepte hinter jeder von PubNub betriebenen App zu verstehen. Hören Sie sich die Erfahrungen unserer Nutzer direkt auf unserer GitHub-Seite und in den Testimonials auf unserer Website an.

Einrichten

Melden Sie sich für einen PubNub-Account an, um sofort kostenlosen Zugang zu PubNub-Schlüsseln zu erhalten.

Starten Sie

Die PubNub-Dokumente werden Sie unabhängig von Ihrem Anwendungsfall zum Laufen bringen. Wir haben Abschnitte, die der JavaScript Google Maps API gewidmet sind und wie man sie mit Echtzeit-Tracking in unserem SDK verwendet.

Erkundung von Anwendungsfällen für kognitive Dienste

PubNub Developer Relations — Fri, 31 May 2024 14:06:20 +0000

Schauen wir uns einige Beispiele für Anwendungen und Unternehmen an, die durch kognitive Dienste verändert wurden, und einige zukünftige Anwendungsfälle, um zu sehen, wie sehr sie die Technologielandschaft verändern.

Dank der kognitiven Dienste von Cloud-Giganten wie AWS, IBM und Microsoft Azure haben Entwicklerteams jeder Größe jetzt Zugang zu kognitiven Diensten von atemberaubender Leistungsfähigkeit. Diese Dienste werden über APIs bereitgestellt und machen es einfach, Anwendungen mit der Intelligenz der nächsten Generation auszustatten.

Chat und soziale Interaktion

Im Jahr 2015 übertrafen die monatlich aktiven Nutzer von Chat-Apps die von sozialen Netzwerken, und die Kluft wird immer größer. Messaging ist zu einem wesentlichen Bestandteil der sozialen Netzwerke geworden. Und mit diesem rasanten Wachstum haben sich Messaging-Apps von einfachen Tools zum Senden und Empfangen von kurzen, textbasierten Nachrichten zu innovativen, vollwertigen Erlebnissen mit überraschenden und interessanten Funktionen entwickelt. Und die treibende Kraft dieser Innovation sind kognitive APIs.

Chatbots und kognitives Rechnen

Chatbots sind eine der frühesten Formen von KI-Algorithmen. Es ist zwar unwahrscheinlich, dass sie bald den Turing-Test bestehen, aber sie sind die natürliche Weiterentwicklung von sprachgesteuerten Anwendungen. Wo Sie früher eine Support-Hotline anriefen und die 1 für die Kreditorenbuchhaltung drückten, können Sie jetzt in ganzen Sätzen mit einem System sprechen, das Ihre Absicht erkennt.

Ob Sie sich dessen bewusst sind oder nicht, die Akzeptanz von Chatbots ist explodiert, da Unternehmen versuchen, Wartezeiten zu verkürzen, die Kundenerfahrung zu verbessern und die Kosten für menschliche Telefonisten zu minimieren. Im Moment werden sie hauptsächlich für einfache Aufgaben eingesetzt: Sie verstehen einfache Anfragen und reagieren auf der Grundlage vordefinierter Regeln, indem sie Fragen wie "Wo ist meine Bestellung?" oder "Chatbot, schalte das Stimmungslicht ein" beantworten.

APIs wie Watson Assistant oder Amazon Lex machen es jedoch einfach, Dienste zu entwickeln, die Logik auf beobachtete Muster in diesen natürlichsprachlichen Anfragen anwenden können. Diese Dienste können z. B. einen plötzlichen Ansturm von Anrufen von einem Flughafen mit Startverspätungen beobachten und die Reihenfolge der Optionen ändern, um die Umplanung von Flügen zu priorisieren. Oder sie stellen fest, dass Anrufe aus einem bestimmten Land oder einer bestimmten Region tendenziell in einer anderen Sprache getätigt werden, und ändern die Standardeinstellung entsprechend. Sie können sogar grammatikalische Muster erkennen, die darauf hinweisen, dass Kunden sofort an einen Vorgesetzten weitergeleitet werden sollen.

Intelligente Konversationsschnittstellen, die Spracherkennung, Text-to-Speech, Gesichtserkennung und Modelle für maschinelles Lernen nutzen, können für verschiedene Zwecke äußerst ansprechende Erlebnisse und lebensnahe Gespräche bieten. Und was noch besser ist: Sie werden aus diesen Erfahrungen lernen.

Chatbots werden die Art und Weise verändern, wie wir Bankgeschäfte tätigen, einkaufen und lernen: Sie geben Empfehlungen, verstehen abstrakte Konzepte und lernen Menschen auf der Grundlage früherer Kontakte kennen. Irgendwann werden sie so gut sein, dass man gar nicht mehr merkt, dass man mit einem Menschen spricht.

Code-Beispiel: Chatbot für Hausautomatisierung

Mit Watson und der PubNub ChatEngine können Sie ganz einfach einen Chatbot mit künstlicher Intelligenz erstellen, der Ihr Smart Home steuert.

Dieses Tutorial zeigt Ihnen, wie Sie einen Chatbot erstellen, der Textbefehle annimmt, sie analysiert und darauf basierend Aktionen ausführt. Beispiel: Ein Benutzer gibt ein: "Schalte das Licht im Wohnzimmer ein", und der Bot schaltet das Licht ein.

{

  "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"
    }

Verarbeitung natürlicher Sprache

Ein weiterer wichtiger Bereich ist die Datenwissenschaft und die Verarbeitung natürlicher Sprache (Natural Language Processing, NLP), der Oberbegriff für KI-Lösungen, die große Mengen von Daten in natürlicher Sprache verarbeiten können. NLP kann nicht nur Wörter und Grammatik aus einer semantischen Perspektive bewerten, sondern auch Gefühle und Emotionen erkennen, indem es die Gefühle der Nutzer zu einem Thema oder einer Sache durch die Analyse von Nachricht zu Nachricht herausfindet.

NLP ist ein enormer Vorteil für Marken, Persönlichkeiten des öffentlichen Lebens und Organisationen, die die Meinungen der Nutzer verstehen und darauf reagieren müssen - und das in einer Zeit, in der ein guter Ruf innerhalb von Minuten auf- oder abgebaut werden kann. Stellen Sie sich vor, eine Marke bringt einen neuen Werbespot für ein Produkt auf den Markt. Mit den richtigen kognitiven Diensten kann sie einen Social-Media-Stream zu einem bestimmten Hashtag oder dem Produktnamen anzapfen und ihre NLP-API alle relevanten Nachrichten analysieren und Feedback dazu geben, wie die Öffentlichkeit auf das Produkt reagiert.

Unten sehen Sie ein Beispiel für eine App, die entwickelt wurde, um zu analysieren und zu bewerten, wie die Menschen auf Twitter über US-Politiker denken. Sie überwacht bestimmte Schlüsselwörter und Phrasen und kann dann die Emotionen der Nutzer in bestimmten geografischen Regionen darstellen.

Wenn ein Nutzer zum Beispiel den Text "Ich bin glücklich" eingibt...

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

analysiert Watson den Text und liefert folgende Ergebnisse:

{
   "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
}

Marken geben bereits große Summen für die Analyse von Marktstimmungen aus. Da diese Systeme immer intelligenter, robuster und automatisierter werden, können sie die Öffentlichkeit zu geringeren Kosten viel besser verstehen.

eCommerce

Obwohl das Online-Shopping die Art und Weise, wie wir Waren einkaufen, völlig verändert hat, fehlt dem elektronischen Handel eine Schlüsselkomponente eines stationären Geschäfts: hilfsbereite Mitarbeiter. In der Größenordnung, in der Online-Shops arbeiten, ist es wirtschaftlich nicht tragbar, echte Mitarbeiter für den Live-Chat einzusetzen.

Aus diesem Grund setzen viele Online-Shops auf intelligente Shopping-Assistenten, die das Einkaufserlebnis optimieren, den Kunden bei Fragen helfen, Empfehlungen geben und sogar die Kasse bedienen.

Nordstrom hat die vergangenen Weihnachtssaisonen mit seinem Messenger-Chatbotdominiert, der über einfache vordefinierte Fragen und Antworten hinausging und kognitive Dienste nutzte, um wirklich zu verstehen, wonach der Kunde suchte, und ihm bei Bedarf zu helfen. Er bot Geschenkempfehlungen an und konnte sogar bei der Ausführung der Bestellung helfen.

Chatbots ersparen uns auch den gefürchteten Anruf beim Kundensupport, bei dem wir eine Stunde auf einen Mitarbeiter warten müssen, um ein einfaches Problem zu lösen. Amazon hat Chatbots eingesetzt, die kleinere Probleme lösen können, die die meisten Kunden haben, wenn sie Hilfe bei ihren Bestellungen benötigen.

Nachdem wir uns nun einige Beispiele für Intelligenz in der realen Welt angesehen haben, wollen wir einen Blick in die Zukunft werfen und sehen, wie kognitive Dienste unsere Welt in Zukunft verändern werden.

Intelligente Städte

Die Städte der Zukunft werden auf verschiedene integrierte intelligente Dienste angewiesen sein, um sie sicherer, effizienter und umweltbewusster zu machen. Bilderkennung, Computer Vision und Vision-APIs werden bei diesem Wandel eine entscheidende Rolle spielen, indem sie Bilder im städtischen Raum verarbeiten und Maßnahmen ergreifen.

Landwirtschaft

Die Weltbevölkerung wächst weiter, und die Ernährung dieser Milliarden von Menschen wird in den kommenden Jahren eine große Herausforderung darstellen. Kognitive Dienste werden eine entscheidende Rolle bei der Bewirtschaftung von Feldern und Fabriken spielen und es uns ermöglichen, intelligente Entscheidungen zu treffen und Ressourcen mit einer nie dagewesenen Präzision zu steuern.

Intelligente Bauernhöfe und das Internet der Dinge werden so viele wertvolle Datenpunkte wie möglich einbeziehen, um intelligente landwirtschaftliche Entscheidungen zu treffen, selbst solche, die kontraintuitiv erscheinen. Durch die Zusammenführung von Echtzeit-Wetterdaten, Fernsensordaten und historischen Leistungsdaten können kognitive Dienste beispielsweise den individuellen Bewässerungsplan perfektionieren und an die tagesaktuellen Gegebenheiten anpassen.

Datensicherheit

In dem Maße, in dem wir immer stärker vernetzt sind und unser digitales Leben unser physisches Leben überschattet, werden Datenschutz und Datensicherheit von etwas, dessen wir uns nur vage bewusst sind, zu einer beunruhigenden, allgegenwärtigen persönlichen Bedrohung.

Vorschriften und Regeln - HIPAA, GDPR, SOC II - sind eine Möglichkeit, um sicherzustellen, dass Unternehmen und Organisationen über die richtigen Leitplanken verfügen. Die Umsetzung dieser komplexen Vorschriften im Detail kann eine Menge Arbeit bedeuten, und genau hier kommt das maschinelle Lernen ins Spiel.

Kognitive Dienste können darauf trainiert werden, Regeln und Vorschriften zu verstehen und zu interpretieren, und schlagen dann Wege zur Einhaltung der Vorschriften vor. Mit kognitiven Diensten lassen sich wertvolle Einblicke in die Datensicherheit gewinnen, von relevanten Regeln und Gesetzen bis hin zur Moderation von Inhalten.

Gesundheitswesen

Innovationen kommen in der Gesundheitsbranche in der Regel langsamer voran als in anderen Branchen, und zwar aus mehreren Gründen: enge Gewinnspannen, strenge Vorschriften und isolierte Forschung und Entwicklung. Kognitive Dienste bieten die Möglichkeit, Innovationsbarrieren zu beseitigen und das Versorgungssystem von den Organisationen bis hin zu den Patienten zu verbessern.

Die Entscheidungsfindung im Gesundheitswesen erfolgt in der Regel auf einer isolierten Basis von Patient zu Patient. Kognitive Dienste hingegen analysieren und handeln auf der Grundlage eines umfassenden Überblicks über die Faktoren, die die Gesundheit beeinflussen: sozioökonomischer Status, Umfeld, Zugang zur Gesundheitsversorgung usw. Kognitive Dienste können dem Arzt eine bessere, gezieltere Patientenversorgung empfehlen, einschließlich Gesundheits- und Wellnessprogrammen.

Kognitive Dienste können die Integration und Verknüpfung bestehender Systeme in Gesundheitsorganisationen vorantreiben und wichtige Erkenntnisse zutage fördern. Wenn Organisationen plötzlich in der Lage sind, Daten zu aggregieren und die Bedürfnisse der Beteiligten miteinander zu verbinden, können sie eine bessere Versorgung bieten und gleichzeitig effizienter arbeiten.

Intelligenz jetzt

In diesem Artikel wurde nur ein winziger Ausschnitt dessen beschrieben, wie kognitive Dienste die Art und Weise, wie wir über Unternehmen denken, und die Rolle, die Anwendungen spielen können, verändern werden. In der Vergangenheit folgte die Software den Anweisungen. Mit kognitiven Diensten können sich Lösungen anpassen, weiterentwickeln und Dinge vollbringen, die noch vor wenigen Jahren unmöglich erschienen. Wir können noch nicht alle Auswirkungen absehen, aber nach dem, was wir wissen, besteht kaum ein Zweifel daran, dass die Auswirkungen auf die Wirtschaft tiefgreifend und positiv sein werden - und dass sie schneller da sein werden, als Sie es sich vorstellen können.

Wie kann PubNub Ihnen helfen?

Dieser Artikel wurde ursprünglich auf PubNub.com veröffentlicht.

Unsere Plattform unterstützt Entwickler bei der Erstellung, Bereitstellung und Verwaltung von Echtzeit-Interaktivität für Webanwendungen, mobile Anwendungen und IoT-Geräte.

PubNub erleben

Sehen Sie sich die Live Tour an, um in weniger als 5 Minuten die grundlegenden Konzepte hinter jeder PubNub-gestützten App zu verstehen

Einrichten

Melden Sie sich für einen PubNub-Account an und erhalten Sie sofort kostenlosen Zugang zu den PubNub-Schlüsseln

Beginnen Sie

Mit den PubNub-Dokumenten können Sie sofort loslegen, unabhängig von Ihrem Anwendungsfall oder SDK

Verfolgung von GitHub Dashboard Commits in Echtzeit

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

Im Bereich der Softwareentwicklung bieten C3.js-Echtzeitdiagramme eine effektive Möglichkeit zur Überwachung der Aktivitäten in Ihrem Unternehmen. Für Entwicklungsteams ist eine der verfolgbaren Metriken GitHub Commits. Dieser Blog-Beitrag bietet ein Tutorial, das Sie durch den Prozess der Nutzung der GitHub-API führt, um GitHub-Commit-Daten in einem interaktiven Echtzeitdiagramm abzurufen und anzuzeigen. Wir nutzen die Möglichkeiten von HTML, Javascript und CSS und verwenden PubNub, um das GitHub-Dashboard zu erstellen und die Commit-Daten zu streamen, während C3.js bei der Visualisierung hilft.

Um mehr über Echtzeit-C3.js-Diagramme zu erfahren , haben wir ein großartiges Tutorial. Jetzt können wir eintauchen!

Wie man ein Echtzeit-GitHub-Dashboard erstellt

Um ein GitHub-Dashboard in Echtzeit zu erstellen, müssen Sie eine Verbindung zu verschiedenen Datenquellen wie dem GitHub-Repository herstellen und sich um einige notwendige Abhängigkeiten kümmern. Achten Sie auf die notwendigen Cybersicherheitsmaßnahmen wie sichere Kodierung und Datenverschlüsselung. Die Einhaltung der branchenüblichen Sicherheitsprotokolle ist unabdingbar.

Hier ist eine Schritt-für-Schritt-Anleitung:

Hinzufügen eines GitHub-Webhooks

Führen Sie folgende Schritte aus, um den Webhook einzurichten:

Erstellen Sie ein GitHub-Repository oder verwenden Sie ein vorhandenes Git-Repository.
Klicken Sie auf "Einstellungen" auf der rechten Seite der Seite
Klicken Sie auf "Webhooks" auf der linken Seite der Seite
Klicken Sie oben rechts auf "Webhook hinzufügen".
GitHub fragt Sie nach Ihrem Passwort, geben Sie es ein
Geben Sie unter 'Payload URL' ein: http://pubnub-git-hook.herokuapp.com/github/ORG-NAME/TEAM-NAME. Ersetzen Sie ORG-NAME durch den Namen Ihrer Organisation und TEAM-NAME durch das Team, das das Repo kontrolliert.

Laden Sie das Visual Dashboard

Besuchen Sie diese Seite. Sie werden eine Liste aller Commits sehen, die über das PubNub-Dashboard gesendet wurden - toll! Wenn Sie einen Ihrer Commits an GitHub senden, sollten Sie innerhalb weniger Millisekunden eine Nachricht auf Ihrem GitHub-Commit-Dashboard sehen, und die Diagramme werden in Echtzeit aktualisiert.

Wie wir das Github Commit Dashboard aufgebaut haben

Das Dashboard ist ein Mashup aus GitHub, dem PubNub Data Stream Network und D3-Diagrammvisualisierungen, die von C3.js unterstützt werden. Wenn ein Commit auf GitHub gepusht wird, werden die Commit-Metadaten an eine kleine Heroku-Instanz gesendet, die sie im PubNub-Netzwerk veröffentlicht. Wir hosten die Dashboard-Seite auf den GitHub-Seiten.

Sobald unsere Heroku-Instanz die Commit-Daten von GitHub erhält, veröffentlicht sie eine Zusammenfassung dieser Daten auf PubNub unter Verwendung der öffentlichen Publish/Subscribe-Schlüssel im Kanal pubnub-git. Sie können den pubnub-git-Kanal über unsere Entwicklerkonsole hier überwachen.

Hier ist ein Beispiel für die Nutzlast einer Nachricht:

{ 
  "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"
}

Die zweite Hälfte der Magie geschieht, wenn das Dashboard diese Informationen über seinen Subscribe-Callback erhält. Wenn Sie sich den Quelltext des Dashboards ansehen, werden Sie diesen Code sehen:

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

});

Dieser subscribe-Aufruf stellt sicher, dass die JavaScript-Funktion displayLiveMessage() jedes Mal aufgerufen wird, wenn eine Nachricht auf dem pubnub-git-Kanal empfangen wird. displayLiveMessage() fügt die Commit-Push-Benachrichtigung an den Anfang des Protokolls und aktualisiert die C3-Visualisierungsdiagramme.

Aber Moment, wie wird das Dashboard beim ersten Laden gefüllt?

Die Nutzung der PubNub Storage & Playback API für Ihr Dashboard

PubNub speichert jede gesendete Nachricht und bietet Entwicklern mit der Storage & Playback (History) API eine Möglichkeit, auf diese gespeicherten Nachrichten zuzugreifen. Tiefer im Web-Dashboard werden Sie den folgenden Code sehen:

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

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

Dies ist eine Anfrage zum Abrufen der letzten 1.000 Nachrichten, die über den pubnub-git-Kanal gesendet wurden. Auch wenn das Web-Dashboard zum Zeitpunkt des Versands dieser Nachrichten offline war, kann es sie abrufen und diese Daten verwenden, um das Dashboard so aufzufüllen, als ob es ständig online wäre.

Diese Funktion ist besonders nützlich, wenn es um Geräte mit unterbrochener oder unzuverlässiger Konnektivität geht, wie z. B. mobile Anwendungen in Mobilfunknetzen oder vernetzte Autos. Dank des PubNub-Netzwerks benötigt unser Visualisierungs-Dashboard kein Backend, um den Zustand der Anwendung zu speichern.

Bauen Sie Ihr eigenes GitHub-Dashboard

Um mit der Erstellung Ihres Github-Dashboards zu beginnen, forken Sie das Git Commit UI-Repository auf github.com und folgen Sie den README-Anweisungen zur Einrichtung. Pull Requests sind als Teil der Open-Source-Community-Zusammenarbeit willkommen.

Zukünftige Trends und Entwicklungen bei Echtzeit-Dashboards

Es ist wichtig, die letzten Trends und Entwicklungen bei Echtzeit-Dashboards und verwandten Technologien im Auge zu behalten. Dazu gehören Websockets für die Datenübertragung in Echtzeit, die Verwendung von Benachrichtigungen für sofortige Einblicke und die Verwendung von Echtzeit-Dashboards in verschiedenen Arbeitsabläufen.

Erfahrung mit PubNub

PubNub hat zahlreichen Kunden geholfen, mit ihren Echtzeitanwendungen erfolgreich zu sein. Zum Beispiel das Echtzeit-Benachrichtigungssystem von LinkedIn...

Einrichten

Melden Sie sich für ein PubNub-Konto an, um sofort und kostenlos Zugang zu den PubNub-Schlüsseln zu erhalten. Die neuesten Funktionen in Ihrem PubNub-Konto umfassen ...

Anfangen

Mit unseren umfassenden PubNub-Dokumenten sind Sie im Handumdrehen startklar, unabhängig von Ihrem Anwendungsfall oder SDK.

PubNub bietet eine benutzerfreundliche Plattform zur Verbesserung der Benutzerfreundlichkeit. Unsere Dienste sind so konzipiert, dass sie Entwicklern einen nahtlosen Integrationsprozess ermöglichen.

Vergessen Sie nicht, dass wir hier sind, um Ihre Echtzeit-Entwicklungsreise reibungsloser und effizienter zu gestalten. Richten Sie Ihre Nutzdaten-URL ein und lassen Sie uns beginnen!

Offizielle Dokumentationen und maßgebliche Quellen können im gesamten Blogpost referenziert werden, um die Gültigkeit der Informationen zu bestätigen.

Wie kann PubNub Ihnen helfen?

Dieser Artikel wurde ursprünglich auf PubNub.com veröffentlicht.

Unsere Plattform unterstützt Entwickler bei der Erstellung, Bereitstellung und Verwaltung von Echtzeit-Interaktivität für Webanwendungen, mobile Anwendungen und IoT-Geräte.

PubNub erleben

Sehen Sie sich die Live Tour an, um in weniger als 5 Minuten die grundlegenden Konzepte hinter jeder PubNub-gestützten App zu verstehen

Einrichten

Melden Sie sich für einen PubNub-Account an und erhalten Sie sofort kostenlosen Zugang zu den PubNub-Schlüsseln

Beginnen Sie

Mit den PubNub-Dokumenten können Sie sofort loslegen, unabhängig von Ihrem Anwendungsfall oder SDK

Sichere Moderation von Chats und Benutzern mit BizOps Workspace

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

Dieser How-to-Artikel ist Teil einer Reihe von Artikeln, die sich mit den Datenverwaltungsfunktionen von PubNub befassen, die unter dem Namen BizOps Workspace bekannt sind:

Verwalten von Benutzern und Kanälen mit BizOps Workspace
Überwachung und Moderation von Konversationen mit BizOps Workspace
Sichere Moderation von Konversationen und Benutzern mit BizOps Workspace

BizOps Workspace ist eine Reihe von Tools, die Sie bei der Verwaltung Ihrer Anwendung unterstützen. Dieser Artikel erweitert den vorherigen Artikel "Überwachen und Moderieren von Konversationen mit BizOps Workspace", um eine sichere End-to-End-Chat-Anwendung mit manuellen Moderationsfunktionen zu zeigen, d. h. die Möglichkeit, Konversationen in Echtzeit zu überwachen und Benutzer stummzuschalten oder zu sperren.

Obwohl dieser Artikel für sich alleine gelesen werden kann, empfehle ich dringend, den vorherigen Artikel "How to Monitor and Moderate Conversations with BizOps Workspace" zu lesen, um den Hintergrund der hier besprochenen Konzepte besser zu verstehen.

Was ist der Channel Monitor?

Mit dem Channel Monitor können Chat-Moderatoren eine Live-Vorschau von Unterhaltungen sehen, die in Echtzeit über mehrere Kanäle laufen. Wenn der Moderator etwas Beunruhigendes entdeckt, wie z. B. einen sich daneben benehmenden Benutzer oder beleidigende Nachrichten, kann er sofort eingreifen, um das Problem zu beseitigen.

Der Moderator hat einen großen Spielraum bei der Wahl seiner Maßnahmen:

Einen Benutzer beobachten, ohne seine Zugriffsrechte einzuschränken
Bearbeiten oder Löschen der beleidigenden Nachricht
die Fähigkeit des Benutzers, Nachrichten zu veröffentlichen, einschränken(stummschalten)
die Fähigkeit des Benutzers, Nachrichten zu lesen oder zu veröffentlichen, einschränken(Verbot)

Alle Funktionen der Funktion "Überwachen" sind manuell: manuelle Überprüfung von Nachrichten, manuelles Stummschalten von Benutzern usw. Dieser Artikel befasst sich nicht mit der automatischen Moderation.

Um den Channel Monitor nutzen zu können, müssen Sie mehrere Funktionen in Ihrem PubNub Keyset aktiviert haben, insbesondere App-Kontext und Nachrichtenpersistenz. Weitere Details finden Sie im Abschnitt "Anforderungen an das Keyset für den Channel Monitor" im vorherigen Artikel.

Was ist der PubNub Access Manager?

Entwickler müssen verhindern, dass Benutzer versuchen, ihr Moderationssystem zu umgehen; dies wird durch den PubNub Access Manager erreicht.

Mit dem Access Manager können Sie eine Reihe von Regeln definieren, die die Berechtigungen des oder der angegebenen Benutzer beschreiben und welche Aktionen sie auf bestimmten Ressourcen durchführen können. Zum Beispiel:

Benutzer mit der ID 123 hat die Berechtigung zum Lesen und Schreiben auf Channel 456
Alle Benutzer, deren ID mit dem regulären Ausdruck user-* übereinstimmt, können von jedem Channel lesen, dessen ID mit dem regulären Ausdruck global-* übereinstimmt
Benutzer mit der ID 123 hat die Berechtigung, die Channel-Metadaten (d. h. den App-Kontext) zu aktualisieren.

Eine vollständige Liste der Berechtigungen finden Sie in der Dokumentation unter https://www.pubnub.com/docs/general/security/access-control#permissions.

Der PubNub Access Manager ist Token-basiert, und der einfachste Weg, ihn zu beschreiben, ist, den in der Dokumentation dargestellten Autorisierungsfluss durchzugehen und einige zusätzliche Informationen darüber zu geben, wie dieser Fluss mit der Moderation zusammenhängt:

Anmeldeversuch. Ihr Client authentifiziert sich gegenüber Ihrem Server, um Ihre Benutzer bei Ihrer Anwendung anzumelden. Dies geschieht wahrscheinlich über einen Identitätsanbieter; nach diesem Schritt ist Ihr Server sicher, dass er mit einem registrierten App-Benutzer spricht und wer dieser ist. Der Client fordert ein PubNub Access Manager Authentifizierungs-Token als Teil seiner Initialisierung an.
Antrag auf Erlaubniserteilung. Der Server bearbeitet die Anfrage des Clients nach einem Token, indem er die SDK 'grantToken()' API aufruft. Zu dieser API sind einige Punkte zu beachten: Sie kann nur mit dem geheimen PubNub-Schlüssel aufgerufen werden und kann daher nur von einem Server aus aufgerufen werden; sie ist für alle unsere serverseitigen SDKs verfügbar; und diese API akzeptiert JSON-Objekte, um die Ressourcen und Berechtigungen zu definieren, die den Zugriff des/der Benutzer(s) bestimmen.
Token zurückgegeben. PubNub gewährt dem/den angeforderten Benutzer(n) die angeforderten Berechtigungen und gibt ein Authentifizierungs-Token an den Server zurück.
Token übergeben. Ihr Server gibt das Authentifizierungs-Token an den ursprünglich aufrufenden Client zurück.
Token gesetzt. Der Client kann dieses Authentifizierungs-Token während seiner Initialisierung oder zu einem beliebigen Zeitpunkt während des Lebenszyklus der Anwendung mit der Methode setToken() festlegen. Die Möglichkeit, das Token jederzeit zu aktualisieren, ist wichtig, da Token ablaufen, ein Client aber auch ein neues Token anfordern muss, wenn der Channel Monitor seine Berechtigungen aktualisiert (d. h. wenn er stummgeschaltet oder gesperrt wird).
Autorisierte API-Anfrage. Alle nachfolgenden Aufrufe an PubNub werden nun als autorisiert betrachtet. PubNub erlaubt oder verweigert jede API-Anfrage basierend auf den in Schritt 2 erteilten Berechtigungen und der Token-Gültigkeit des Clients.

Wie sieht eine sichere Moderationslösung aus?

Gegen Ende des letzten Artikels habe ich eine Demo gezeigt, wie das Stummschalten oder Sperren von der Client-Seite aus aussehen würde. Das Chat-SDK enthält Moderationsereignisse, die einem Client mitteilen, ob er stummgeschaltet oder gesperrt wurde oder nicht; abgesehen von der Aktualisierung der Benutzeroberfläche hindert dies den Client jedoch nicht daran, weiterhin Nachrichten zu senden, obwohl er stummgeschaltet/gesperrt wurde. Um den Client sicher stumm zu schalten oder zu sperren, müssen Sie ihm die bestehenden Access Manager-Berechtigungen entziehen und ihm neue erteilen, die seinen neuen Stumm- oder Sperrstatus widerspiegeln.

Stellen Sie sich das folgende Szenario vor, in dem ein Benutzer für den Channel "Musicals" stummgeschaltet ist:

Ein Benutzer kann auf zwei Kanäle zugreifen, "Filme" und "Musicals", aber der Administrator möchte ihn nur für den Kanal "Musicals" stummschalten.
Der Moderator schaltet den Benutzer mit Hilfe des Channel-Monitors stumm. Im Verborgenen wird dabei die API 'setRestrictions()' aufgerufen.
Die Serveranwendung erhält die Stummschaltungsmitteilung über ein Moderationsereignis und entzieht dem Benutzer das bestehende Zugriffstoken.
Die Client-Anwendung erhält über ein Moderationsereignis den Hinweis, dass der Kanal "Musicals" stummgeschaltet wurde.
Die Anwendung aktualisiert ihre Benutzeroberfläche, um das Senden weiterer Nachrichten zu verhindern. Der Benutzer könnte diese UI-Änderung umgehen, indem er das JavaScript der Seite ändert, aber jeder Versuch, Nachrichten zu senden, schlägt fehl, da sein Authentifizierungstoken widerrufen wurde.
Die Anwendung fordert ein neues Authentifizierungs-Token vom Server an, wie im obigen Abschnitt über den Zugriffsmanager beschrieben. Das neu gewährte Token spiegelt die neuen Berechtigungen des Benutzers wider, einschließlich des "Lese"-Zugriffs auf den Kanal "Musicals".

Im vorangegangenen Artikel wurden die "Komponenten einer Moderationslösung" beschrieben und die APIs, die sowohl dem Client als auch dem Server zur Verfügung stehen, in der folgenden Grafik aufgelistet. Die APIs, die in den obigen Schritten besprochen wurden, sind auch in dieser Grafik dargestellt.

Die Chat-SDK-Beispielanwendung

Dasselbe Team, das für die Entwicklung des Channel Monitor und des Chat SDK verantwortlich ist, hat auch eine in React Native geschriebene Beispielanwendung erstellt, die das Chat SDK verwendet.

Das Beispiel zeigt die Möglichkeiten des SDKs und die besten Praktiken für die Entwicklung einer realistischen und voll funktionsfähigen Chat-App mit PubNub. Es ist Open Source und Teil desselben GitHub-Repositorys, das auch das Chat-SDK unter /samples/react-native-group-chat enthält.

Diese Anwendung wurde kürzlich aktualisiert, um Token von einem Access Manager Server anzufordern und ein neues Token anzufordern, wenn sich die Berechtigungen des Benutzers ändern, d.h. wenn er von Kanälen ausgeschlossen oder stummgeschaltet wird. Diese Verbesserung wurde seit dem Verfassen des letzten Artikels vorgenommen, also stellen Sie sicher, dass Sie den neuesten Quellcode von GitHub erhalten. Zum Zeitpunkt der Erstellung dieses Artikels lautet die neueste Git-Commit-ID ae9dfa0

Sicheres Stummschalten und Verbannen von Benutzern: Demo mit der Beispielanwendung

In diesem Abschnitt wird beschrieben, wie Sie unsere End-to-End-Demo zum Laufen bringen und die sichere Moderation sowohl aus der Client- als auch aus der Serverperspektive zeigen.

PubNub Keyset erstellen

Ich empfehle, ein neues PubNub Keyset zu erstellen, um diese Demo wie folgt zu starten:

Loggen Sie sich in das Admin Portal ein und erstellen Sie entweder eine neue Anwendung oder ein neues Keyset innerhalb einer bestehenden Anwendung. Bei Bedarf finden Sie eine Schritt-für-Schritt-Anleitung in unserem How to Create Admin Portal Keys.
Aktivieren Sie auf der Seite Keysets die folgenden Konfigurationsoptionen. Sofern nicht anders angegeben, können Sie die Standardeinstellungen übernehmen:

App-Kontext. Dieser speichert Metadaten über Ihre Channels und Benutzer und wird im vorherigen Artikel über"Benutzer- und Channel-Verwaltung" näher beschrieben. Aktivieren Sie auch Benutzer-Metadatenereignisse, Channel-Metadatenereignisse und Mitgliedschaftsereignisse
Nachrichten-Persistenz. Dies speichert Ihren Nachrichtenverlauf mit PubNub, so dass der Administrator Konversationen überprüfen und bearbeiten kann.
Zugriffsmanager. Verhindert den unbefugten Zugriff auf Daten und ist erforderlich, um eine sichere Moderationslösung zu erstellen.
Anwesenheit. Wird verwendet, um zu verfolgen, ob ein Benutzer online oder offline ist.

Speichern Sie Ihre Änderungen.

Sie benötigen den Publish Key, Subscribe Key und Secret Key in den folgenden Schritten.

Erstellen Sie die Beispielanwendung

Wie bereits beschrieben, handelt es sich bei der Chat SDK-Beispielanwendung um eine plattformübergreifende Client-Anwendung, die in React Native unter Verwendung des Expo-Frameworks geschrieben wurde.

Klonen und erstellen Sie die Beispielanwendung, indem Sie den Anweisungen in der Readme-Datei der Anwendung folgen. Stellen Sie insbesondere sicher, dass Sie die Voraussetzungen installiert haben, einschließlich Garn und Node.js. In der ReadMe wird die Verwendung von XCode und iOS beschrieben, aber Sie können die Anwendung auch auf einem Android-Emulator ausführen. Zum Zeitpunkt der Erstellung dieses Artikels lautet die neueste Git-Commit-ID ae9dfa0

Wenn Sie die Pub/Sub-Schlüssel bereitstellen, verwenden Sie die Schlüssel, die Sie im vorherigen Schritt erzeugt haben. Wenn Sie die Schlüssel nicht in die .env-Datei aufnehmen, wird die Anwendung standardmäßig einige Demo-Schlüssel verwenden; Sie können diese Logik unter https://github.com/pubnub/js-chat/blob/ae9dfa0/samples/react-native-group-chat/App.tsx#L60 deaktivieren, um Verwirrung zu vermeiden.

Führen Sie die Anwendung aus. In der ReadMe werden Sie angewiesen, yarn ios auszuführen, aber Sie können auch yarn android oder yarn run start ausführen, wobei letzteres Ihnen ein interaktives Menü bietet.

Wenn Sie sich anmelden, sollten Sie die folgende Warnung in Ihrer Konsole sehen:

Das liegt daran, dass der Client sich nicht mit dem Access Manager Server verbinden konnte, also bauen wir ihn.

Erstellen Sie den Access Manager-Beispielserver

Der Sample Access Manager Server ist unter https://github.com/pubnub/js-chat/tree/master/samples/access-manager-api zu finden . Dies ist die gleiche Monorepo wie die zuvor besprochene Client-Anwendung.

Öffnen Sie die Datei src/chatsdk.service.ts in einem Editor Ihrer Wahl und füllen Sie die Felder publishKey, subscribeKey und secretKey aus. Der publishKey und der subscribeKey müssen mit den Schlüsseln übereinstimmen, die Sie zum Erstellen der Client-Anwendung verwendet haben, und der geheime Schlüssel ist auf der Keyset-Seite für die Anwendung im Admin-Portal verfügbar

Führen Sie im Verzeichnis REPO/samples/access-manager-api den Befehl yarn run start aus, um den Access Manager-Server zu starten, und Sie sollten etwas wie das folgende Bild sehen:

Um zu sehen, was der Access-Manager-Server tut, schauen Sie sich app.service.ts an. Sie sehen die für den anfragenden Benutzer generierten Berechtigungsstrukturen und den Aufruf von chat.sdk.grantToken(), um diese Berechtigungen anzuwenden und den generierten authKey an den aufrufenden Client zurückzugeben.

Dies sind die Berechtigungen, die die Demoanwendung benötigt, aber Ihre Anwendung wird wahrscheinlich andere Berechtigungen benötigen. Sie können diesen mitgelieferten Regelsatz als Startvorlage verwenden, aber wenn Sie den Access Manager Server für Ihre Anwendung erstellen, konsultieren Sie https://www.pubnub.com/docs/chat/chat-sdk/build/features/users/permissions, um genau zu verstehen, welche Berechtigungen von welchen Chat SDK Funktionen benötigt werden.

Starten Sie die Client-Demoanwendung neu, und Sie sollten sich jetzt ohne Fehler anmelden können. Sie werden wissen, dass alles erfolgreich war, wenn Sie einen 'Authkey refreshed' Toast erhalten.

Initiieren Sie eine Unterhaltung zwischen zwei Clients.

Stummschalten und Sperren von Benutzern mit dem Channel Monitor

Wichtig: Wenn Sie noch keine Konversation zwischen zwei Clients initiiert haben, sollten Sie dies jetzt tun. Kanäle werden von der Demo-Anwendung dynamisch erstellt, so dass sie im Kanalmonitor erst angezeigt werden, wenn der Chat begonnen hat.

Beachten Sie, dass alle unten gezeigten Aktualisierungen der Benutzeroberfläche, wie z. B. das Banner "Auth Key Refreshed" oder das Modal "Banned User", Teil der Demo-Anwendung sind - Ihre Anwendung wird diese Informationen dem Benutzer über ihre eigene Benutzeroberfläche anzeigen.

Starten Sie den Channel Monitor, indem Sie sich im Admin-Portal anmelden und das Keyset auswählen, das Sie für das Access Manager-Beispiel und die Client-Anwendung verwendet haben.
Gehen Sie zum Abschnitt BizOps Workspace im linken Navigationsbereich und wählen Sie Channel Monitor. Wenn Sie den Abschnitt BizOps Workspace nicht sehen, müssen Sie höchstwahrscheinlich ein Upgrade Ihres PubNub-Tarifs durchführen, aber bitte kontaktieren Sie unseren Support, wenn Sie Probleme haben.
Sie werden aufgefordert, Ihre Channels auszuwählen, um die Moderation zu starten. Der Name des Channels lautet 1:1 Benutzer mit USER_ID, wobei USER_ID der Benutzername der Person ist, die die Unterhaltung initiiert hat.
Die Kanalnachrichten werden in Echtzeit angezeigt, einschließlich früherer Nachrichten, wenn Sie die Persistenz auf Ihrem Keyset aktiviert haben.

Schalten Sie den Benutzer stumm, indem Sie die Mikrofontaste neben einer von diesem Benutzer gesendeten Nachricht drücken. Auf dem Gerät des stummgeschalteten Benutzers wird eine Nachricht angezeigt, die besagt, dass der Authentifizierungsschlüssel erneuert wurde. Wenn Sie versuchen, eine Nachricht als stummer Benutzer zu senden, wird eine Meldung angezeigt, die besagt, dass dies verboten ist, obwohl der stummgeschaltete Benutzer davon nicht betroffen ist.

Heben Sie die Stummschaltung des Benutzers auf, indem Sie die Mikrofontaste erneut drücken. Auf dem Gerät des stummgeschalteten Benutzers wird eine Nachricht angezeigt, die Sie darüber informiert, dass der Authentifizierungsschlüssel aktualisiert wurde und das Senden von Nachrichten nun möglich ist.

Sperren Sie den Benutzer, indem Sie auf die Schaltfläche "Sperren" neben der von diesem Benutzer gesendeten Nachricht drücken und einen Sperrgrund angeben. Der Grund ist ein Freitext, so dass Sie alle relevanten Informationen angeben können. Der Authentifizierungsschlüssel wird aktualisiert und der Benutzer kehrt zum Chat-Auswahlbildschirm in seiner App zurück.

Beim Versuch, auf den gesperrten Kanal zuzugreifen, wird dem Benutzer eine Fehlermeldung angezeigt:

Heben Sie die Sperre des Benutzers auf, indem Sie im Channel-Monitor "Sperre aufheben" wählen. Der Authentifizierungsschlüssel wird aktualisiert. Die Sperre wird aufgehoben und der Benutzer kann wieder auf den Chat zugreifen.

Zusammenfassung

Die Entwicklung einer Chat-Anwendung ist nur der erste Schritt. Die schwierigsten Herausforderungen kommen nach der Bereitstellung der Anwendung, um Ihre wachsende Benutzerbasis zu unterstützen. BizOps Workspace ist eine Reihe von Tools, die für die Verwaltung aller Aspekte Ihrer Chat-Anwendung entwickelt wurden und die Herausforderungen nach der Einführung vereinfachen.

Obwohl sich dieser Artikel auf das sichere Stummschalten und Sperren von Benutzern konzentriert hat, werden wir die Funktionen von BizOps Workspace weiter ausbauen. Dieser Artikel hat sich auch ausschließlich auf das Chat SDK konzentriert, aber der Channel Monitor kann auch so konfiguriert werden, dass er mit jedem unserer SDKs funktioniert.

Wenn Sie Hilfe oder Unterstützung benötigen, wenden Sie sich bitte an unser engagiertes Support-Team oder senden Sie eine E-Mail an unser Developer Relations Team unter devrel@pubnub.com.

Wie kann PubNub Ihnen helfen?

Dieser Artikel wurde ursprünglich auf PubNub.com veröffentlicht.

Unsere Plattform hilft Entwicklern bei der Erstellung, Bereitstellung und Verwaltung von Echtzeit-Interaktivität für Webanwendungen, mobile Anwendungen und IoT-Geräte.

PubNub erleben

Sehen Sie sich die Live Tour an, um in weniger als 5 Minuten die grundlegenden Konzepte hinter jeder PubNub-gestützten App zu verstehen

Einrichten

Melden Sie sich für einen PubNub-Account an und erhalten Sie sofort kostenlosen Zugang zu den PubNub-Schlüsseln

Beginnen Sie

Mit den PubNub-Dokumenten können Sie sofort loslegen, unabhängig von Ihrem Anwendungsfall oder SDK

Hinzufügen von Echtzeit-Chat zu Ihrem Unity-Spiel

PubNub Developer Relations — Thu, 16 May 2024 21:24:52 +0000

Echtzeit-Chat oder In-Game-Chat erhöht das Engagement der Spieler und fördert die Benutzerbindung. Der Echtzeit-Chat ermöglicht es den Spielern, miteinander zu kommunizieren, fördert das Gemeinschaftsgefühl und bietet eine Plattform für soziale Interaktion, die das Spielerlebnis noch angenehmer macht.

Die Einführung eines Echtzeit-Chats ist leichter gesagt als getan. Wenn man bei Null anfängt, braucht man eine Menge Ressourcen, um es aufzubauen, zu warten und zu skalieren, wenn die Spielerzahl steigt. Zum Glück ist es mit PubNub einfacher denn je, Echtzeitfunktionen in Unity-Spiele einzubauen - mit unserer Echtzeit-API-Plattform mit niedriger Latenz. Ganz gleich, ob Sie für Windows, Mac, iOS, Android, Virtual Reality-Systeme wie Oculus und Meta Quest oder plattformübergreifend entwickeln, unser Unity-SDK bietet Ihnen alles.

Lesen Sie weiter, um zu erfahren, wie Sie mit PubNub einen Echtzeit-Chat zu Ihrem Unity-Videospiel hinzufügen können. Sie erfahren, wie Sie verschiedene Kanalmuster einrichten, wie Sie Nachrichten senden und empfangen und wie Sie Ihren Chat im Spiel mit anderen Funktionen wie Moderation, Emojis, Reaktionen und GIFs verbessern und absichern.

Erste Schritte mit PubNub

Bevor du mit der Einrichtung deines Ingame-Chats beginnst, musst du die PubNub-Plattform verstehen und wissen, wie du deine Anwendung konfigurierst, um die Funktionen der Plattform zu nutzen.

Überblick

PubNub basiert auf dem Pub/Sub (Publish/Subscribe) Modell. Ein Benutzer veröffentlicht eine Nachricht, die im Wesentlichen eine Nutzlast ist, die alle relevanten Informationen enthält, im PubNub-Netzwerk. Benutzer, die die Nachricht empfangen oder anhören wollen, abonnieren das PubNub-Netzwerk und analysieren die Nachricht. Die Nachricht kann alles Mögliche enthalten, solange sie weniger als 32 KB groß ist (und vorzugsweise in JSON).

Um sicherzustellen, dass die Nachricht an die richtigen Empfänger gelangt, werden Kanäle als Mechanismus verwendet, über den die Daten von einem Gerät zum anderen übertragen werden. Kanäle werden jedes Mal benötigt, wenn ein Gerät im PubNub-Netzwerk veröffentlichen und abonnieren möchte. Während ein Benutzer immer nur eine Nachricht veröffentlichen kann, kann ein Benutzer viele verschiedene Kanäle gleichzeitig abonnieren und so auf eine Reihe von Nachrichten warten.

Während Sie den genauen Kanalnamen angeben müssen, wenn Sie eine Nachricht veröffentlichen, können Sie mehrere Kanäle gleichzeitig über Multiplexing abonnieren, d. h. Sie abonnieren einen oder mehrere Kanäle, indem Sie die Kanalnamen als Array von Strings angeben.

Warum ist diese Information notwendig? Dein gesamtes Nachrichtensystem im Spiel wird auf dem Konzept der Channels basieren: Wie du deinen Channel-Musternamen formatierst und sicherst, bestimmt, welche Art von Chat du willst.

Installieren und konfigurieren Sie das PubNub Unity SDK

Zu Beginn müssen Sie das PubNub Unity SDK konfigurieren, um Ihre Anwendung mit dem PubNub-Netzwerk zu verbinden. Bitte lesen Sie die Unity SDK-Dokumentation für alle Details, aber als Überblick müssen Sie Folgendes tun:

Fügen Sie das Unity-Paket über den Paketmanager hinzu.
Erstellen Sie ein kostenloses PubNub-Konto und erhalten Sie Ihre PubNub-Keys. Es ist wichtig, dass Sie die Funktionen in Ihrem Keyset aktivieren, die Ihre Anwendung benötigt - für die wesentliche Pub/Sub-Funktionalität müssen Sie lediglich den Stream Controller aktivieren. Alle anderen Einstellungen, die Sie für erweiterte Funktionen konfigurieren müssen, werden wir natürlich auch behandeln.
Geben Sie Unity die Publish- und Subscribe-Keys, die Sie im vorherigen Schritt erhalten haben, um das PubNub GameObject zu konfigurieren. Du solltest auch eine UserId angeben, da jedes PubNub-Objekt einen eindeutigen Identifikator benötigt, um eine Verbindung zu PubNub herzustellen. Danach initialisieren Sie das PubNub-Objekt:

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

Fügen Sie Ereignis-Listener für Ihr Spiel hinzu, um auf Ereignisse und Nachrichten zu reagieren. Es gibt verschiedene Ereignis-Listener, um eine eigene Logik zu implementieren, die auf jede Art von Nachricht oder Ereignis reagiert, aber für die Kernfunktionalität des Austauschs von Chat-Nachrichten benötigen Sie lediglich den Nachrichten-Ereignis-Listener (Sie werden später in diesem Leitfaden lernen, wie Sie Ihrem Echtzeit-Chat zusätzliche Funktionen hinzufügen können, um ihn interessanter zu gestalten):

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

Bevor Sie mit dem Veröffentlichen beginnen können, um Nachrichten an andere Geräte zu senden, und mit dem Abonnieren, um Nachrichten von den Veröffentlichern zu erhalten, müssen Sie den Namen Ihres Kanals festlegen. Denken Sie daran: Wie Sie Ihr Kanalmuster formatieren, bestimmt, welche Art von Chat Sie implementieren möchten.

Definieren verschiedener Chat-Muster

Sie müssen sich überlegen, welche Arten von Chat Sie für Ihr Spiel implementieren wollen. In diesem Abschnitt geht es um das Muster, dem der Kanal folgen sollte, und nicht um die gesamte Einrichtung, um die erforderlichen Informationen von Ihrem Spiel oder Ihren Benutzern zu erhalten. Wenn Sie die verschiedenen Chat-Muster in einem Unity-Projekt sehen möchten, das PubNub verwendet, schauen Sie sich unser Unity Showcase Game an.

All/Global Chat

Der All- oder Global-Chat ermöglicht die Kommunikation zwischen allen Spielern in einem Spiel. Du kannst einen allgemeinen Chat einrichten, indem du Nachrichten in einem gemeinsamen Kanal veröffentlichst und abonnierst, den alle Spieler abonniert haben. Sie können die Channel-Struktur für globale Spieler einrichten:

string allChat = “global”;

Jeder Client abonniert dann den Kanal und stellt sicher, dass alle Spieler dieselben Nachrichten in Echtzeit erhalten, wodurch ein gemeinsames Chaterlebnis entsteht, an dem alle Spieler teilnehmen können.

Privater/Flüster-Chat

Der Privat- oder Flüster-Chat ermöglicht es den Spielern, persönliche Unterhaltungen zu führen, bei denen nur die beiden beteiligten Spieler miteinander chatten können und niemand sonst. Bei einem Privat- oder Flüster-Chat-Channel-Muster würde jeder Benutzer eine Channel-Struktur abonnieren, die für private Unterhaltungen vorgesehen ist:

string privateChatBase= “chat.private.*”;

Dabei wird das Konzept des Wildcard-Abonnements verwendet. Diese Funktion kann verwendet werden, um eine hierarchische Liste von Channels zu abonnieren, wobei Sie mit einer einzigen Namensangabe viele Channels abonnieren können.

Wenn ein Benutzer beispielsweise eine private Nachricht an einen anderen Benutzer senden möchte, würde man die aktuelle PubNub-Benutzer-ID (oder UUID/uuid), die den eindeutigen Identifikator des Benutzers im PubNub-Netzwerk darstellt, mit der Benutzer-ID des beabsichtigten Empfängers der Nachricht verknüpfen. Während Sie die Benutzer-ID des aktuellen Benutzers immer abrufen können (über pubnub.GetCurrentUserId()), müssen Sie die Benutzer-ID des Empfängers abfragen. Sobald Sie die Benutzer-ID des Empfängers haben, können Sie den Kanal wie folgt verketten:

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

Da Sie ein Platzhalter-Kanalmuster wie chat.private.* angeben, wird Ihre Anwendung alle Kanalnamen abonnieren, die diesem Muster entsprechen. Dadurch wird sichergestellt, dass Sie den Kanalnamen zur Laufzeit nicht immer kennen müssen. Schließlich wird durch die Verwendung der Benutzer-IDs sichergestellt, dass der Kanalname eindeutig ist und die Unterhaltung zwischen den beiden Benutzern bleibt.

Freund/Buddy-Chat

Mit einem Freundschafts- oder Buddy-Chat können Spieler privat mit bestimmten Spielern kommunizieren, mit denen sie eine engere Beziehung aufbauen möchten, egal ob es sich um neu kennengelernte Spieler oder um Freunde außerhalb des Spiels handelt.

In einem Freundes-/Buddy-Chat müssen Sie ein Kanalmuster erstellen, das für jedes Gerät oder jeden Spieler eindeutig ist, ähnlich wie Sie das Kanalmuster für den privaten Chat erstellen würden, indem Sie Ihre Benutzer-ID anhängen:

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

Dies wiederholst du dann für jeden Benutzer, mit dem du befreundet sein möchtest - du ersetzt ihre Benutzer-IDs in der chanFriendChat-Zeichenfolge durch die von pubnub.GetCurrentUserId(). Obwohl das Channel-Muster nun vorhanden ist, kann man sich nicht einfach mit einem Wildcard-Muster wie chat.friends.* anmelden; stattdessen braucht man einen Mechanismus, um festzustellen, welche Spieler Freunde sind.

Eine Lösung für dieses Problem sind die Channel Groups von PubNub, mit denen man eine große Anzahl von Channels auf einmal verwalten kann. Channel Groups sind im Wesentlichen ein Zeiger auf eine Liste von Channels; in diesem Fall ist die Channel Group eindeutig für den Spieler und enthält einen Verweis auf alle Freunde des Spielers:

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

Hinweis: Die Namen der Kanalgruppen folgen den gleichen Konventionen wie die Namen der Kanäle, sie können jedoch keine Punkte in ihrem Namen enthalten, daher der Unterschied in der Musterstruktur.

Ähnlich wie beim Abonnieren von Kanälen mit dem pubnub-Objekt (wird im nächsten Abschnitt erläutert) können Sie auch gleichzeitig Kanalgruppen abonnieren. Da der Spieler die Channel-Gruppe seines Freundes abonniert hat, wird jedes Mal, wenn ein neuer Freund hinzugefügt wird, der chanFriendChat dieses Freundes zur Friend-Channel-Gruppe des Spielers hinzugefügt und erhält Nachrichten im Message-Ereignis-Listener, sobald einer dieser Channels eine Nachricht veröffentlicht. Sie können zwar nicht in einer Kanalgruppe veröffentlichen, aber Sie können einfach eine Nachricht in einem der angeschlossenen Kanäle innerhalb der Kanalgruppe veröffentlichen, und jeder Abonnent (Freund) würde diese Nachricht erhalten.

Mit der Channel Groups API für das PubNub Unity SDK können Sie Freunde/Kanäle zu Channel Groups hinzufügen, auflisten und entfernen, wenn Sie die Berechtigung dazu haben. Die Channel-Gruppen-Funktion wird auch verwendet, um zu bestimmen, wann Freunde online/offline sind, was als Präsenz bezeichnet wird. Dies wird in unserer detaillierten Anleitung zum Hinzufügen einer Freundesliste in Unity ausführlich behandelt.

Gilden-/Allianz-/Clan-Chat

In Spielen, die Gilden, Allianzen oder Clans beinhalten, kann eine spezielle Chat-Umgebung die Teamkoordination und Kameradschaft stark fördern. Diese Art des Gruppenchats ermöglicht die Kommunikation zwischen mehreren Benutzern und fördert die Zusammenarbeit und das Teamwork unter einer größeren Anzahl von Spielern als nur Ihren Freunden. Ein Gilden-/Bündnis-/Clan-Chat ermöglicht es den Mitgliedern einer Gruppe, Strategien zu planen, Errungenschaften auszutauschen oder sich einfach zusammenzuschließen, um eine persönlichere Gemeinschaft innerhalb des Spiels zu bilden.

Die Einrichtung eines solchen Chats mit PubNub erfolgt nach demselben Konzept wie die Einrichtung eines Freundes-/Buddy-Chats. Du erstellst Channel-Gruppen für jeden Typ, abonnierst diese Channel-Gruppen und fügst Freunde zu diesen Channel-Gruppen hinzu, wenn sie dazu berechtigt sind. Alle Nachrichten, die in einem mit diesen Channel-Gruppen verbundenen Channel veröffentlicht werden, lösen den Event-Listener aus und Sie können den Chat entsprechend anzeigen.

Kanalgruppen sind eine großartige Möglichkeit, große Gruppen zu verwalten, da die Kanalgruppe eines Spielers 2000 Kanäle (in diesem Fall Spieler) verwalten kann, was selbst für die größten Gilden in Massive Online Games mehr als ausreichend ist. Noch besser ist, dass jeder einzelne Client, der mit dem PubNub-Netzwerk verbunden ist, 10 Channel Groups haben kann, was bedeutet, dass du bei Bedarf Zugang zu 20.000 Channels hast.

Party-/Lobby-Chat

Party- oder Lobby-Chats sind für kleine, zeitlich begrenzte Gruppen gedacht, die für eine bestimmte Spielsitzung oder Mission gebildet werden. Obwohl diese Chatarten für unterschiedliche Zwecke gedacht sind, ähnelt ihre Implementierung dem Muster für die Erstellung eines privaten/geflüsterten Chatkanals.

Erstellen Sie zunächst eine Basiszeichenkette für jede Art von Gruppenchat. Wenn Sie Ihr Array von Kanälen abonnieren (im nächsten Schritt besprochen), verwenden Sie einen Platzhalter, um auf alle Anfragen zu hören:

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

Wenn die Lobby oder Gruppe gebildet wird, wird ein Spieler als Anführer oder Besitzer der Gruppe bestimmt, unabhängig davon, ob er die Gruppe initiiert hat oder ob er aufgrund seiner Internetverbindung und Region bestimmt wurde. Diese Art von Spielern werden Gruppenleiter oder Gastgeber genannt. Sie würden dann die Benutzer-ID des Host-Spielers mit einer Basiszeichenkette verketten und so ein eindeutiges Kanalmuster erstellen. Jeder neue Spieler, der eingeladen wird, der Gruppe oder der Lobby beizutreten, abonniert diese Channels dynamisch, so dass er effektiv der Gruppe beitritt. Der Channel kann dann gelöscht werden, wenn die Party oder Lobby beendet oder aufgelöst wurde.

Alles zusammenfügen

Sobald Sie festgelegt haben, welche Chat-Typen Sie auf der Grundlage des Kanalmusters in Ihr Spiel implementieren möchten, ist es an der Zeit, Nachrichten in Echtzeit zu senden und zu empfangen, indem Sie diese Kanäle veröffentlichen und abonnieren.

Nachrichten veröffentlichen

Der Prozess beginnt mit der Erstellung des Nachrichteninhalts. Dies kann ein einfacher Text-Chat oder eine komplexere Datenstruktur sein, je nach den Anforderungen Ihres Unity-Spiels. Sobald die Nutzlast fertig ist, ist es an der Zeit, die Nachricht zu veröffentlichen.

Die Publish-API wird verwendet, um eine Nachricht an alle Abonnenten des angegebenen Chat-Kanals zu senden. Obwohl Sie nur einen Kanal gleichzeitig veröffentlichen können, wird die Veröffentlichung asynchron durchgeführt, so dass der Rest Ihres Codes nicht blockiert wird (obwohl Sie auch synchron veröffentlichen können, wenn Sie möchten).

Wenn Sie zum Beispiel eine Chat-Nachricht an den Teilnehmer senden möchten, würden Sie den folgenden Aufruf machen, um nicht nur zu veröffentlichen, sondern auch festzustellen, ob der PubNub-Aufruf erfolgreich war (und zu behandeln, wenn der Aufruf fehlgeschlagen ist):

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());

Abonnieren von Nachrichten

Wenn Nachrichten veröffentlicht werden, müssen wir die entsprechenden Kanäle abonnieren, um alle eingehenden Nachrichten und Ereignisse zu empfangen. Sie können mehrere Chat-Kanäle und Kanalgruppen mit einem einzigen Aufruf abonnieren:

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

Der Player ist nun mit dem PubNub-Netzwerk verbunden, und die Ereignis-Listener warten auf das Eintreten eines Ereignisses - in diesem Fall das Eintreffen einer neuen Nachricht - und führen dann den mit diesem Ereignis verbundenen Code aus.

Wenn eine Nachricht eintrifft, löst der Listener einen Callback aus und führt den Code aus, den Sie für die Behandlung eingehender Nachrichten geschrieben haben. Das kann so einfach sein wie die Anzeige der Nachricht in einem Chatraum oder etwas Komplexeres wie das Auslösen von Ereignissen im Spiel auf der Grundlage von Chatnachrichten.

Erweiterte Funktionen, um den Chat im Spiel fesselnd zu gestalten

Gute Arbeit - Sie haben erfolgreich einen In-Game-Chat in Ihr Unity-Spiel implementiert, über den die Spieler Nachrichten in Echtzeit senden und empfangen können! Die implementierte Funktionalität ist jedoch nur die Spitze des Eisbergs - es gibt noch viele weitere Funktionen, die Sie implementieren sollten, um den Chat im Spiel für Ihre Spieler noch interessanter zu machen.

Nachrichtenverlauf laden: Persistenz von Nachrichten

In einem Spiel kann es vorkommen, dass Spieler frühere Unterhaltungen nachlesen oder verpasste Chats nachholen müssen. Hier kommt die Message Persistence ins Spiel, die es ermöglicht, den Verlauf von Chat-Nachrichten zu speichern und abzurufen. Durch die Implementierung der Message Persistence-API in Ihrem Unity-Spiel können Sie Chat-Nachrichten, Nachrichtenaktionen und Dateien bei Bedarf speichern und abrufen:

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

Wir bieten auch die Flexibilität zu kontrollieren, wie lange Nachrichten gespeichert werden, so dass Sie die Speicherung basierend auf den spezifischen Bedürfnissen und Ressourcen Ihres Spiels verwalten können. Um die Nachrichtenpersistenz nutzen zu können, müssen Sie die Funktion im Admin-Portal für Ihre Schlüssel aktivieren. Weitere Informationen zu dieser Funktion und wie Sie sie aktivieren können, finden Sie in unserer Anleitung zur Nachrichtenaufbewahrung.

Spieler über verpasste Nachrichten benachrichtigen: Mobile Push-Benachrichtigungen

Bei mobilen Spielen kann es vorkommen, dass Spieler die App immer wieder verlassen und wichtige Nachrichten von ihrem Team oder Aktualisierungen des Spiels verpassen. Hier kommen die mobilen Push-Benachrichtigungen ins Spiel. Sie bieten eine Möglichkeit, Spieler über verpasste Chat-Nachrichten, Spiel-Updates oder andere wichtige Benachrichtigungen zu informieren, auch wenn sie nicht aktiv im Spiel sind.

Mit der API für mobile Push-Benachrichtigungen bieten wir eine einheitliche API, um Push-Benachrichtigungen sowohl an iOS- als auch an Android-Geräte zu senden. Dies vereinfacht den Prozess und ermöglicht es Ihnen, einen einzigen API-Aufruf zu senden, um alle Geräte zu benachrichtigen, unabhängig von der Plattform. Sie können Ihre Push-Benachrichtigungen auch individuell anpassen, z. B. personalisierte Benachrichtigungen an einzelne Spieler senden oder eine Nachricht an alle Spieler senden. Dank dieser Flexibilität können Sie effektiv mit Ihren Spielern kommunizieren und sie auf dem Laufenden halten.

Um Mobile Push-Benachrichtigungen mit PubNub nutzen zu können, müssen Sie Mobile Push-Benachrichtigungen aktivieren, indem Sie unserer Anleitung im Admin-Portal folgen. Wir haben auch spezifischere, detaillierte Anleitungen für FCM und APNs Mobile Push-Benachrichtigungen.

Mehr als nur Worte: Emojis

Emojis dienen als universelle Sprache der Gefühle in der digitalen Kommunikation. Sie ermöglichen es den Spielern, ihre Gefühle und Reaktionen auf eine lustige und farbenfrohe Weise auszudrücken und machen den Chat interaktiver und ansprechender.

Mit PubNub können Sie Emoji-Unterstützung ganz einfach in Ihr Unity-Spiel implementieren, indem Sie die Spieler Signale statt Nachrichten veröffentlichen lassen. Signale sind für das Senden von kleinen Datenmengen gedacht, da sie viel schneller und billiger zu senden sind als Nachrichten. Da Emojis in der Regel sehr kleine Datenmengen enthalten, ist dies der perfekte Weg, um die Daten schnell zu senden.

Sie können die Signals API von PubNub verwenden, um Emojis in einem bestimmten Chat zu veröffentlichen. Wenn ein Spieler zum Beispiel ein winkendes Emoji an den globalen Chat senden möchte, wird der folgende Code ausgeführt, wenn er auf Senden drückt:

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);
    }
  });

Die Spieler, die als Empfänger vorgesehen sind, erhalten das Signal, wenn sie den angegebenen Kanal abonniert haben. Da es sich in diesem Fall um den globalen Kanal handelt, würde jeder das Emoji erhalten. Um auf Signale warten zu können, müssen Sie das Ereignis "Listener" abonnieren:

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

Sie müssen sicherstellen, dass der Wert des Emojis ein tatsächliches Emoji darstellt, das in Unity definiert ist. Diese Emojis können im PubNub-Netzwerk über App Context (früher als Objects bezeichnet) gespeichert und abgerufen werden, sodass alle Emojis, auf die der Player Zugriff hat, aus dem serverlosen Speicher abgerufen werden können. Weitere Informationen zur Implementierung von App Context in Ihrem Unity-Spiel finden Sie in unserem Leitfaden.

Reagieren Sie auf Nachrichten: Nachrichten-Reaktionen

Nachrichtenreaktionen wie Likes, Herzen, Daumen hoch, Sticker oder benutzerdefinierte spielspezifische Reaktionen bieten Spielern eine schnelle und einfache Möglichkeit, auf Chat-Nachrichten zu reagieren. Sie bringen nicht nur Interaktivität in den Chat, sondern fördern auch das Gemeinschaftsgefühl, indem sie den Spielern die Möglichkeit geben, die Nachrichten der anderen zu bestätigen und sich mit ihnen auseinanderzusetzen.

Mit der Message Actions API von PubNub können Sie Funktionen wie Reaktionen und Lesebestätigungen erstellen oder Nachrichten mit benutzerdefinierten Metadaten verknüpfen. Ähnlich wie Chat-Anwendungen wie Discord unterschiedliche Reaktionen und Emojis für verschiedene Server haben, könnten auch Ihre verschiedenen Chat-Typen. Sie können die verfügbaren Nachrichtenreaktionen für den angegebenen Chat-Kanal mit dem folgenden Aufruf abrufen, wenn der Chat geladen wird:

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

Wenn ein Spieler im Begriff ist, auf eine Nachricht mit einer Reaktion zu antworten, können Sie dies tun, indem Sie eine Nachrichtenreaktion zu einer veröffentlichten Nachricht hinzufügen:

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 verwendet Zeit-Token, um genau zu verfolgen, wann eine Nachricht im Netzwerk veröffentlicht wurde. Wenn Sie Nachrichten empfangen, ist die Zeit auch in der Nutzlast enthalten. Sie können dann den entsprechenden Zeit-Token-Wert im MessageTimetoken()-Argument angeben, um auf die Nachricht reagieren zu können.

Um auf die Reaktion zu warten und den Player zu benachrichtigen, der die ursprüngliche Nachricht gesendet hat, müssen Sie einen Listener hinzufügen und die Reaktion in der Methode OnPNMessageAction verarbeiten:

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

Ähnlich wie bei Emojis können Sie App Context verwenden, um abzurufen und zu speichern, wie diese Reaktionen in Ihrem Spiel visuell dargestellt werden. Um Message Reactions nutzen zu können, müssen Sie sicherstellen, dass Message Persistence für Ihre Schlüssel im Admin Portal aktiviert ist.

GIFs und andere Multimedia

Eine weitere wichtige Funktion, die das Chat-Erlebnis verbessert, ist der Austausch von Multimedia-Dateien. Ob GIFs, Screenshots von lustigen Momenten oder sogar die gemeinsame Nutzung von Spielressourcen - die gemeinsame Nutzung von Dateien bringt eine weitere Interaktionsebene in Ihr Spiel.

Die Implementierung dieser Arten von Multimedia-Dateien erfolgt über die PubNub File Sharing API. Mit dieser Funktion können Spieler Dateien, auf die sie Zugriff haben, hochladen, herunterladen und löschen. Um eine Datei zu senden, müssen Sie den folgenden Aufruf tätigen:

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.
}

Damit die Abonnenten auf die Datei warten können, müssen Sie den Ereignis-Listener hinzufügen und in der OnPNFile-Methode festlegen, wie die Datei angezeigt werden soll:

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

Sie können auch Informationen abrufen, auflisten und alle Dateien löschen, die mit verschiedenen Chat-Kanälen verbunden sind. Sie müssen sicherstellen, dass Sie die Dateifreigabefunktion im Verwaltungsportal sowie die Nachrichtenpersistenz aktivieren. Mehr dazu erfahren Sie in unserer Anleitung zum Aktivieren von Dateien.

Sichern Sie Ihre Chat-Kanäle: Zugriffsmanager

In jeder Spielumgebung ist die Gewährleistung der Sicherheit von Chat-Kanälen von größter Bedeutung. Ob es darum geht, Spieler vor unerwünschten Nachrichten zu schützen oder sensible strategische Diskussionen zu sichern, das Chatsystem Ihres Unity-Spiels muss mit Blick auf die Sicherheit entwickelt werden.

Hier kommt der Access Manager von PubNub ins Spiel. Er bietet einen robusten und flexiblen Rahmen für die Sicherung Ihrer Chat-Kanäle. Mit dem Access Manager können Sie kontrollieren, wer jeden Ihrer Channels veröffentlichen oder abonnieren kann, und so dem Chatsystem Ihres Unity-Spiels eine zusätzliche Sicherheitsebene hinzufügen.

Mit Access Manager können Sie Berechtigungen auf Benutzerebene, Channelebene oder sogar auf der Ebene einzelner Schlüssel erteilen. Sie können festlegen, ob ein Benutzer einen Kanal lesen, schreiben oder verwalten darf, und diese Berechtigungen können dynamisch aktualisiert werden, wenn sich die Anforderungen Ihres Spiels ändern. In einem privaten Chat zwischen zwei Spielern können Sie beispielsweise nur diesen beiden Spielern die Lese- und Schreibberechtigung für ihren privaten Kanal erteilen. Ebenso können Sie in einem Gilden-Chat allen Gildenmitgliedern Lese- und Schreibrechte erteilen, während Sie nur dem Gildenleiter Verwaltungsrechte erteilen.

Access Manager unterstützt auch die Token-basierte Authentifizierung, die es Ihnen ermöglicht, Benutzer sicher zu authentifizieren und ihnen die entsprechenden Berechtigungen zu erteilen. Auf diese Weise wird sichergestellt, dass nur autorisierte Spieler auf die Chat-Kanäle Ihres Spiels zugreifen können, um Ihre Spielgemeinschaft vor potenziellen Bedrohungen zu schützen.

Um diese Funktion nutzen zu können, müssen Sie sicherstellen, dass Sie Access Manager im Admin-Portal aktivieren. Weitere Informationen dazu finden Sie auf dieser Support-Seite zur Aktivierung dieser Zusatzfunktion.

Wie geht's weiter?

In dieser Anleitung haben Sie gelernt, wie Sie ein robustes Echtzeit-Chat-System zu Ihrem Unity-Spiel hinzufügen können. Wir haben alles besprochen, von der Initialisierung eines PubNub-Objekts in Ihrer Umgebung über das Einrichten eines Chat-Musters, das verschiedene Chat-Typen repräsentiert, bis hin zum Senden und Empfangen von Nachrichten. Sie haben sogar gelernt, wie man fortgeschrittene Funktionen wie Emojis, Nachrichtenreaktionen und Dateifreigabe implementiert, sowie die wichtigen Aspekte eines guten Chatsystems mit Nachrichtenpersistenz, mobilen Push-Benachrichtigungen und Kanalsicherheit.

Ganz gleich, ob Sie ein Indie-Entwickler sind, der an seinem ersten Spiel arbeitet, oder ein erfahrener Entwickler, der sein Multiplayer-Spiel verbessern möchte - die Echtzeit-Funktionalität von PubNub kann als Infrastruktur zur Unterstützung Ihres In-Game-Chats dienen, so dass Sie sich auf das Wesentliche konzentrieren können.

Erfahren Sie mehr mit den folgenden Ressourcen:

Lesen Sie unsere Unity-Dokumentation, um alles zu erfahren, was Sie über das Hinzufügen von Echtzeit-Chat zu Ihrem Spiel wissen müssen.
Verstehen Sie, wie man eine Freundesliste hinzufügt, mit unserem Unity-Leitfaden.
Erfahren Sie, wie unser Unity Showcase Game Chat-Muster verwendet, um Chat-Räume und mehr zu verwalten.
Tauchen Sie ein in den Quellcode des Unity SDK.

Bei Fragen oder Problemen können Sie sich jederzeit an das Developer Relations Team unter devrel@pubnub.com wenden.

So richten Sie Illuminate für Ihr Spiel ein

PubNub Developer Relations — Wed, 15 May 2024 23:49:33 +0000

Was ist Illuminate?

PubNub Illuminate ist eine Lösung zur sofortigen Entscheidungsfindung und Handlungsfähigkeit, die auf der Live-Analyse und dem Tracking der Daten Ihres Spiels basiert. Illuminate gibt Ihnen die Möglichkeit, die für Ihr Spiel wichtigen KPIs abzubilden, Entscheidungen auf der Grundlage des Nutzerverhaltens auszulösen und sofortige Ergebnisse zu sehen - und das alles, ohne Ihr Entwicklungsteam groß einzubeziehen. Mit Illuminate können Sie sofort intelligente, datengestützte Entscheidungen treffen, während die Interaktionen und das Gameplay in Echtzeit stattfinden, um das Wachstum und die Effizienz Ihres Spiels zu optimieren.

In diesem Tutorial erfährst du mehr über Illuminate, warum es für den Erfolg deines Spiels (und deines Studios) wichtig ist und wie du Illuminate einrichtest, um sofortige Entscheidungen zu treffen, die Aktionen auf Basis der Daten deines Spiels auslösen.

Warum Illuminate für Spiele?

Bei den meisten herkömmlichen Analysetools wird in der Regel nur reaktiv auf Echtzeitdaten reagiert. Anpassungen, wie z. B. Preisänderungen auf der Grundlage von Spielerfeedback, werden durch langwierige Patch-Zyklen behindert, die Datenerfassung, Tests und plattformübergreifende Bereitstellung umfassen und somit weitere Ressourcen von der Entwicklung und der Erstellung künftiger Inhalte abziehen. Es besteht ein dringender Bedarf an Echtzeittransparenz in Bezug auf Spielerengagement und Monetarisierung, um schnelle taktische Entscheidungen zu ermöglichen, da verwertbare Erkenntnisse unwirksam werden, wenn sie sich auch nur um ein paar Stunden nach dem Auftreten des Ereignisses verzögern.

Illuminate ist ein anpassungsfähiges Low-Code-Produkt, mit dem Spielemanager und Datenanalysten die Auswirkungen ihrer strategischen Entscheidungen sofort anwenden und bewerten können. Illuminate ermöglicht es Teams, spontane Anpassungen der Spielbalance, effektivere und angemessenere Monetarisierungsstrategien durch Echtzeitexperimente und personalisierte Spielerbelohnungen vorzunehmen, um die Spielerbindung und das Spielerlebnis zu verbessern, während gleichzeitig betrügerische Aktivitäten aufgedeckt werden, ohne die Spielentwickler zu belasten.

Mit Illuminate können Sie Ihre Plattform verwalten und sofortige Maßnahmen in Echtzeit ergreifen:

Führen Sie gezielte Monetarisierungsexperimente in Kanälen durch und sehen Sie sofortige Ergebnisse
Senden Sie sofort personalisierte Empfehlungen auf der Grundlage von Spieleraktionen, während diese stattfinden.
Lösen Sie Aktionen auf der Grundlage von Benutzer- oder Kohortenverhalten aus, und sehen Sie sofortige Ergebnisse.
Verbessern Sie die Betrugserkennung und identifizieren Sie verdächtiges Verhalten in Echtzeit und reagieren Sie darauf.
Anpassen und Experimentieren mit den Preisen von Shop-Artikeln im Spiel. Passen Sie die Preise an, wenn Spieler mehrere Artikel desselben Typs kaufen, und lösen Sie In-Game-Ereignisse aus, die sich auf alle Ladenpreise auswirken.
Belohnen Sie Spieler für den Abschluss von Herausforderungen/Erfolgen mit Rabattcodes für Gegenstände im Spiel. Überprüfen Sie, wo die Spieler am wenigsten Zeit verbringen, und ziehen Sie in Betracht, die Spieler dafür zu belohnen, dass sie Zeit in diesem Bereich verbringen, oder ändern Sie die Art der Belohnungen, die die Spieler erhalten.
Spawnen Sie hilfreiche Gegenstände und passen Sie zentrale Gameplay-Funktionen spontan an, ohne die Entwickler zu nerven.

Mehr darüber, wie Illuminate Spiele unterstützt, erfahren Sie in unserem Video Illuminate for Gaming.

Wie du Illuminate für dein Spiel einrichtest

Bevor du mit der Einrichtung von Illuminate für dein Spiel beginnst, musst du einige wichtige Begriffe verstehen, die bei der Einrichtung verwendet werden. Illuminate besteht aus diesen drei Modulen:

Business-Objekt: Wie du Daten in Illuminate bekommst. Sie können Business Objects definieren, erstellen und aktivieren, die Container für die Erfassung von Daten aus den ausgewählten Anwendungen und Keysets sind. Über eine Reihe von Optionen (Measures, Dimensionen oder Metriken) können Sie entscheiden, welche Daten Sie in Echtzeit verfolgen und wie Sie sie aggregieren möchten.
Entscheidung: Hier ergreifen Sie Maßnahmen auf der Grundlage der von Ihnen erstellten Metriken. Dazu können Sie Regeln mit Bedingungen definieren, die erfüllt werden müssen, und Aktionen, die ausgelöst werden, wenn diese Regeln erfüllt sind.
Dashboard: Hier werden die in Business Objects erstellten Metriken und die in Decisions ausgeführten Aktionen durch Diagramme und Dashboards (Sammlungen von Diagrammen) visualisiert.

Nachdem wir nun die wichtigsten Begriffe definiert haben, besteht die Integration von Illuminate mit Ihrem Spiel aus sechs Schritten:

Verstehen des Nachrichtenschemas
Wählen Sie aus, woher Ihre Daten kommen.
Wähle deine Daten
Visualisiere deine Daten
Setzen Sie Ihre Daten in die Tat um
Visualisieren und Anpassungen vornehmen

Verstehen Sie das Meldungsschema

Es ist von entscheidender Bedeutung, das Datenschema Ihres Spiels zu verstehen. Das bedeutet, dass Sie die Datentypen identifizieren müssen, die Sie verfolgen und analysieren möchten, z. B. Spieleraktionen, Transaktionen im Spiel und Systemereignisse. Indem sie verstehen und dokumentieren, was genau in der Nutzlast enthalten ist, können Entwickler sicherstellen, dass Analysten und andere Teammitglieder die Daten mithilfe von JSONPath effektiv den entsprechenden Quellen zuordnen können. Sie werden verstehen, warum dies wichtig ist, wenn Sie bei der Erstellung von Business Objects Ihre Daten auswählen.

Wählen Sie aus, woher Ihre Daten kommen

Illuminate kann mit jedem Spiel verwendet werden, das sich online verbindet, unabhängig davon, ob es von PubNub betrieben wird oder nicht. Wenn die Infrastruktur Ihres Spiels von PubNub betrieben wird, müssen Sie nur die entsprechende App und das KeySet für Ihr Spiel auswählen, wenn Sie das Business-Objekt im Admin-Portal erstellen (mehr dazu in Kürze).

Wenn Ihr Spiel nicht von PubNub betrieben wird, können Ihre Daten über die Fire API gesendet werden, entweder über die REST API oder über eines unserer SDKs. Der Fire-Endpunkt ermöglicht es dem Client, eine Nachricht an die Event-Handler von Functions zu senden. Diese Nachrichten werden direkt an alle Event-Handler weitergeleitet, die auf dem Kanal registriert sind, auf den Sie Fire senden, und lösen deren Ausführung aus.

Um die PubNub Fire API nutzen zu können, musst du einen PubNub-Account erstellen und dein Keyset mit den Funktionen, die du für dein Spiel benötigst, einrichten. Dieses Keyset enthält die für die Fire-API erforderlichen Veröffentlichungs- und Anmeldeschlüssel. Wie du das machst, erfährst du in unserem Leitfaden.

Wählen Sie Ihre Daten: Business-Objekte

Business Objects sind in Illuminate von grundlegender Bedeutung. Sie sind Container für die Daten, die Sie für die Entscheidungsfindung und Visualisierung in Illuminate verwenden möchten, und dienen im Wesentlichen dazu, Daten in Illuminate zu erhalten.

Ein Business-Objekt besteht aus drei Elementen:

Auswahl der Daten (Measures und Dimensions)
Datenquelle (woher die Daten kommen)
Bedingungen (Metriken)

Obwohl es nichts mit Datenbanken zu tun hat, ist es hilfreich, sich die Struktur eines Business-Objekts in Form von SQL SELECT (Kennzahlen und Dimensionen), FROM (Datenquelle), WHERE (Metriken) vorzustellen. Wenn Sie Ihre Business-Objekte erstellen, sollten Sie die Dokumentation beachten, um alle spezifischen Details oder Umgehungsmöglichkeiten zu erfahren.

Wählen Sie die Daten aus

Es gibt zwei verschiedene Arten von Werten, die Sie für ein Business-Objekt auswählen können: Kennzahlen und Dimensionen.

Measures sind numerische, quantitative Werte. Beispiele für Measures sind Spieldauer, Münzanzahl, Anzahl der Kills, Waffenschaden oder Bestellwert.

Dimensionen sind qualitative Werte, z. B. Spielersprache, ausgewählte Kosmetika, Questtyp, gewählter Waffentyp oder Spielstufe.

Je nach Art der Daten, die Sie verfolgen möchten, müssen Sie die Daten mithilfe von JSONPath auf Ihre Kennzahlen und Dimensionen abbilden. Illuminate muss wissen, wo es mit der Erfassung dieser Daten aus Ihrer Datenquelle (die Sie im vorherigen Schritt eingerichtet haben) beginnen soll. Um die Datenquelle zu definieren, wählen Sie die Schaltfläche "Map" neben jedem Measure und jeder Dimension und geben Sie die entsprechenden JSON-Pfade an.

Dies ist der schwierigste Teil der Einrichtung von Business Objects, da Sie Ihr Nachrichtenschema verstehen müssen. Da Sie Ihr Nachrichtenschema bereits dokumentiert oder verstanden haben, müssen Sie dieses darauf abbilden, wie Iluminate nach den Daten sucht.

Wenn Sie Messages erfassen (speziell Publish Message API), sucht Illuminate nach der folgenden Struktur. Wenn Ihre Infrastruktur nicht von PubNub betrieben wird, müssen Ihre Daten in der gleichen Struktur wie die Publish Message API gemappt werden:

{
 "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
 },
}

Um eine Kennzahl oder Dimension korrekt abzubilden, müssen Sie das Nachrichtenobjekt gefolgt von einem weiteren Feld angeben. Es folgt immer dieser Struktur: $.message.{obligatory-secondary-field}.{optional-further-fields}.

Die Art und Weise, wie Sie die Daten zuordnen, hängt ganz von Ihrer Nachrichtenstruktur ab. Hier sind einige Beispiele für die Zuordnung der Daten für Nachrichten:

Anzahl der Münzen verfolgen (Maßeinheit) => $.message.meta.coins
Ausgerüsteter kosmetischer Gegenstand (Dimension) => $.message.body
Kanalname (Dimension) => $Nachricht.Kanal
Verursachter Schaden (Maß) => $.message.body[6]
Bestimmte Benutzernamen erhalten (Dimension) => $.message.userId
Anzahl der Freunde (Maßeinheit) => $.message.body.user.friends_count

Illuminate kann auch Daten über den App Context von PubNub erfassen, der es Ihnen ermöglicht, Metadaten über Channels, Channel-Mitglieder, Channel-Mitglieder und Benutzer, die über das PubNub-Netzwerk gesendet werden, zu erhalten. Sie können auf diese Informationen zugreifen, indem Sie genau verfolgen, wie Illuminate diese Daten erfasst.

{
 "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
 }
}

Ähnlich wie bei Messages müssen Sie, um ein Measure oder eine Dimension korrekt zuzuordnen, das User-, Channel- oder Membership-Objekt bereitstellen, gefolgt von mindestens einem Schlüssel aus Ihrem JSON. Es folgt immer dieser Struktur: $.user.{obligatory-secondary-field}.{optional-further-fields}. Hier sind einige Beispiele für das Mapping der Daten für App Context:

Shop-Artikel-Details (Dimension) => $.channel.custom.details
Status der Freundesliste (Dimension) => $.membership.status
Spielersprache (Dimension) => $.user.custom.language
Durchschnittspunktzahl des Spielers (Dimension) => $.user.custom.team_deathmatch_score

Hinweis: Um ein Business-Objekt zu erstellen, müssen Sie mindestens eine Dimension oder eine Kennzahl hinzufügen.

Datenquelle

Sobald Sie Ihre Kennzahlen und Dimensionen zugeordnet haben, müssen Sie festlegen, woher Ihre Daten stammen. Dies haben Sie zuvor festgelegt. Stellen Sie sicher, dass Sie die entsprechende App und das Keyset auswählen, die Sie zuvor definiert haben, um sicherzustellen, dass Illuminate die Daten aus der richtigen Quelle erfasst.

Bedingungen (Metriken)

Sobald Sie Ihre Datenquelle ausgewählt haben, können Sie Bedingungen, sogenannte Metriken, hinzufügen. Ähnlich wie die WHERE-Anweisung in SQL sind Metriken für die Datenerfassung in Business Objects nicht erforderlich, aber äußerst nützlich, um nach Kennzahlen und Dimensionen zu filtern und Berechnungen darauf anzuwenden. Denken Sie daran, dass Metriken erforderlich sind, um eine Entscheidung zu erstellen oder auf Dashboards durch Diagramme zu visualisieren (mehr dazu später).

Beim Erstellen von Metriken müssen Sie den Filtern Felder zuweisen und auswählen. Es gibt ein paar Felder, die Sie beachten sollten:

Geben Sie Ihrer Metrik einen sinnvollen Namen, da das Diagramm zur Visualisierung der Daten im Dashboard denselben Namen erhalten wird.
Bei der Auswahl der Funktion können Measures derzeit mit SUMME, AVG, MAX und MIN aggregiert werden. Dimensionen können nur die Funktion ZAEHLEN verwenden. Wenn Sie die Funktion auswählen, können Sie die Kennzahl oder Dimension in einer Dropdown-Liste auswählen.
Für Periode wählen Sie das Aggregationsfenster oder die Zeitperiode für Ihre Funktion.
Vergewissern Sie sich, dass Sie die Dimensionen auswählen, die in Ihren Diagrammen und Entscheidungen verfügbar sein sollen (da Sie ohne diese Auswahl später nicht in der Lage sind, in Diagrammen zu segmentieren und sie auf Regeln in den Entscheidungen anzuwenden).
Filtern Sie nach bestimmten Nachrichten oder App-Kontextdaten auf der Grundlage verschiedener Dimensionen. Beachten Sie, dass Sie zur Visualisierung in Dashboards und zur Erfassung der Daten keine Filter auf die Metrik anwenden müssen.

Sie können mehrere Metriken für ein Geschäftsobjekt erstellen, die unterschiedliche Daten erfassen. Unten sehen Sie ein Beispiel für eine Metrik zur Erfassung des verursachten Schadens für eine Maßnahme und die Art der Waffe, die diesen Schaden verursacht hat:

Visualisieren Sie Ihre Daten: Dashboards und Diagramme

Mit Illuminate können Sie nicht nur die Metriken, die Sie verfolgen möchten, sondern auch die Entscheidungsaktionen und ihre Ergebnisse in Diagrammen auf Dashboards visualisieren.

Auf diese Weise können Sie Trends in Ihrem Produkt in Echtzeit beobachten, reagieren und Ihren Ansatz mit datengestützten Geschäftsentscheidungen verfeinern. Außerdem können Sie auf diese Weise feststellen, ob Illuminate Ihre Daten auf der Grundlage der zuvor eingerichteten Business Objects korrekt erfasst!

Sie können ein Dashboard erstellen, d. h. eine Sammlung von Diagrammen, mit der Sie alle Ihre Metriken an einem Ort sehen und Diagramme zu Ihrem Dashboard hinzufügen können. Ein Diagramm ist eine visuelle Darstellung einer für ein bestimmtes Business-Objekt definierten Kennzahl.

Sie können die Art und Weise, wie die Metrikdaten in einem Diagramm angezeigt werden, jederzeit anpassen, z. B. einen anderen Zeitbereich (z. B. 30 Minuten, 1 Stunde oder ein benutzerdefiniertes Datum) anzeigen und die Metrikdaten in verschiedenen Diagrammtypen darstellen, entweder als Balkendiagramm (Standardansicht) oder als Liniendiagramm.

Sie können mehrere Diagramme (Metriken) zu einem Dashboard hinzufügen sowie verschiedene Dashboards zur Visualisierung verschiedener Bereiche Ihres Spiels (Monetarisierung, Gameplay, Questbelohnungen usw.) erstellen. Sobald Sie Ihre Entscheidungen konfiguriert haben, können Sie die ausgelösten Entscheidungsaktionen und ihre Ergebnisse in Diagrammen auf Dashboards anzeigen.

Lassen Sie Ihre Daten arbeiten: Entscheidungen und Aktionen

Sobald Sie Ihre Metrik erstellt haben, können Sie mit der Auswertung dieser Daten beginnen, Trends überwachen und vor allem Maßnahmen ergreifen.

Illuminate enthält das Modul " Entscheidungen", mit dem Sie die Metriken definieren können, auf die Sie reagieren möchten, indem Sie verschiedene Arten von Aktionen und Regeln erstellen, die festlegen, wann diese Aktionen ausgeführt werden sollen.

Wenn Sie eine Entscheidung erstellen, müssen Sie:

Wählen Sie ein Business-Objekt und eine der damit verknüpften Metriken.
Definieren Sie die Aktionen, die Sie durchführen möchten.
Richten Sie [rules}(https://www.pubnub.com/docs/illuminate/decisions/basics#rules) unter Verwendung der gewählten Bedingungen und konfigurierten Aktionen ein. Diese Regeln werden Aktionen auslösen.

Decisions soll Produktmanagern helfen, mit Engagement- und Monetarisierungsstrategien zu experimentieren, bevor sie diese kodieren und einsetzen. Mit Illuminate können sie Entscheidungen auf der Grundlage tatsächlicher Daten statt auf der Basis von Annahmen treffen und dann anhand dieser Daten durch automatisierte Bedingungen und Aktionen handeln.

Entscheidungen bestehen aus zwei Teilen: Aktionen und Regeln.

Aktionen

Aktionen legen fest, was geschehen soll, wenn Bedingungen (siehe unten) erfüllt sind.

Beim Einrichten von Aktionen können Sie aus fünf Aktionstypen wählen:

Nachricht senden: Veröffentlicht eine Nachricht an einen Benutzer oder Kanal und nutzt die PubNub Publish API. Sie können optional Variablen (${variableThatChanges}) hinzufügen, die Sie beim Einrichten von Entscheidungsregeln dynamisch steuern und ändern können.
Webhook: Sendet einen Aufruf an eine bestimmte URL, indem es eine Verbindung zu einer Drittanbieter-Dienstintegration herstellt. Sie können optional Variablen (${variableThatChanges}) hinzufügen, die Sie beim Einrichten von Entscheidungsregeln steuern und dynamisch ändern können.
Benutzer aktualisieren: Legt vordefinierte oder benutzerdefinierte Benutzer-Metadaten fest, indem die gewünschten Informationen als Schlüssel/Wert-Paare bereitgestellt werden, wobei die PubNub App Context API für Benutzer verwendet wird.
Kanal aktualisieren: Legt beliebige vordefinierte oder benutzerdefinierte Channel-Metadaten fest, indem es die gewünschten Informationen als Schlüssel/Wert-Paare bereitstellt und dabei die PubNub App Context API für Channels verwendet.
Mitgliedschaft aktualisieren: Legt beliebige vordefinierte oder benutzerdefinierte Mitgliedschafts-Metadaten fest, indem es die gewünschten Informationen als Schlüssel/Wert-Paare bereitstellt und dabei die PubNub App Context API für Mitgliedschaften verwendet.

Obwohl Sie nur eine Metrik pro Entscheidung konfigurieren können, können Sie mehrere Entscheidungen erstellen, um Ihre Anwendungsfälle abzudecken. Achten Sie darauf, die Dokumentation zu befolgen, wenn Sie Aktionen für Ihre Entscheidung erstellen.

Sobald Sie die Konfiguration Ihrer Aktionen abgeschlossen haben, müssen Sie die Regeln für die auszulösenden Aktionen einrichten.

Regeln

Regeln bestehen aus Bedingungen, d. h. Kriterien, die erfüllt sein müssen, um eine Aktion auszulösen, und aus Aktionen, die ausgeführt werden, wenn die Bedingungen erfüllt sind. Eine einzelne Regel ist eine Definition (Zeile in einer Entscheidungstabelle), die angibt, welche Aktion bei welcher Bedingung ausgelöst werden soll.

Die Entscheidungstabelle besteht aus vier Teilen:

Trefferrichtlinie: Einstellung, die festlegt, ob nur für die erste übereinstimmende Regel (Single) oder für alle (Multiple) Aktionen ausgelöst werden sollen, wenn ihre Bedingungen erfüllt sind.
Aggregationsfenster: Der einzige Wert, den Sie im Regelkonfigurationsfenster nicht bearbeiten können. Er wird automatisch aus dem bei der Erstellung einer Metrik für Funktion gewählten Wert Periode ausgefüllt. Er gibt an, wie häufig eine Metrik eine bestimmte Funktion (COUNT, AVG, MAX oder andere) für eine Kennzahl oder Dimension ausführt.
Häufigkeit der Auswertung: Lookback-Fenster für die Regel, das festlegt, wie häufig Illuminate die Regel(n) in dieser Entscheidung ausführen soll.
Bedingungen: Eine Reihe von Bedingungen, die Sie mithilfe der Konfigurationstabelle selbst definieren. Hier legen Sie fest, welche Bedingungen (und Schwellenwerte, die sie erfüllen) welche Aktionen auslösen sollen.

Beachten Sie, dass jede Zeile in der Entscheidungstabelle eine eigene Entscheidungsregel ist, die aus Bedingungen und Aktionen besteht. Die Reihenfolge der Regeln bestimmt die Reihenfolge, in der sie ausgeführt werden. Wenn Sie die bestehende Reihenfolge ändern möchten, wählen Sie Regeln in einer Entscheidung bearbeiten und ändern Sie die Reihenfolge mit den Optionen Nach oben oder Nach unten unter dem Menü "Aktionen" neben jeder Regel.

Visualisieren und Anpassen

Sobald Sie Ihre Geschäftsobjekte, Dashboards und Diagramme sowie Ihre Entscheidungen eingerichtet haben, können Sie diese analysieren und mit Änderungen in Echtzeit experimentieren. Sie brauchen nicht mehr auf Balance-Patches zu warten, um zu sehen, ob sich die von Ihnen vorgenommenen Änderungen positiv auf die Spieler oder das Spiel auswirken.

Die meiste Zeit werden Sie hier verbringen, wo Sie experimentelle Entscheidungen treffen, um Anpassungen vorzunehmen, die das Engagement in Ihrem Spiel erhöhen.

Was kommt als Nächstes?

Illuminate legt die Macht der Echtzeit-Experimente in die Hände der Teams, die direkt für das Wachstum und das Endergebnis des Unternehmens verantwortlich sind. Illuminate ist eine wertvolle Plattform für Experimente und intelligente, datengestützte Entscheidungen auf der Grundlage des Spiel- und Nutzerverhaltens, indem es die für Ihr Spiel wichtigen KPIs abbildet und Entscheidungen auf der Grundlage dieser Verhaltensweisen auslöst.

Schauen Sie sich unsere Illuminate-Ressourcen an, um zu erfahren, wie Illuminate Ihr Spiel unterstützen kann und wie Sie Illuminate selbst ausprobieren können. Wenn Sie Fragen haben, können Sie sich wie immer an das Developer Relations Team unter devrel@pubnub.com wenden.