Forem: PubNub [Français]

Comment utiliser le contexte de l'application

PubNub Developer Relations — Tue, 09 Jul 2024 07:04:35 +0000

PubNub App Context simplifie le développement de fonctionnalités complexes en temps réel en fournissant un mécanisme de stockage sans serveur pour les informations sur les utilisateurs, les canaux et les membres. App Context déclenche des événements chaque fois que les données changent, ce qui permet à vos applications de se mettre à jour en temps réel et les données stockées peuvent être utilisées dans Illuminate, Functions et d'autres services PubNub pour prendre des décisions plus intelligentes. Vous pouvez également gérer ces données par le biais d'une interface intuitive, sans code, avec BizOps Workspace.

Qu'est-ce que l'App Context ?

App Con text (anciennement connu sous le nom d'Objects) vous permet de :

Donner un sens aux utilisateurs et aux canaux de votre application, ainsi qu'aux relations entre eux.
Stocker les métadonnées de toutes vos entités sur le serveur, ce qui simplifie la fourniture d'une source globale de vérité pour vos clients. Notez qu'un utilisateur ne doit pas nécessairement représenter un être humain, et qu'il est courant de stocker le statut de l'appareil dans l'objet utilisateur à la place.
Recevoir des événements instantanés en temps réel lorsque les valeurs d'un objet changent.

Bien que n'importe quelle application puisse utiliser App Context, il est particulièrement populaire auprès des développeurs qui créent des solutions de chat.

App Context fournit un ensemble de champs suggérés pour vos utilisateurs et vos canaux, ainsi que des champs suggérés pour les adhésions entre eux. La plupart de ces champs sont facultatifs, vous pouvez donc choisir les champs que vous remplissez, et vous pouvez également fournir vos propres champs personnalisés.

Cas d'utilisation d'App Context

Comme nous l'avons mentionné, App Context est particulièrement populaire auprès des développeurs qui créent des solutions de chat, mais il peut être utilisé dans une grande variété de cas :

Chat : Stockez les informations sur l'utilisateur (nom, photo de profil, statut "en vacances", titre du poste), les informations sur le canal (icône, description, audience), les rôles des utilisateurs et gardez une trace du dernier message lu par canal et par utilisateur.
Sports, médias et divertissements : Vote et sondage en direct, jeu-questionnaire en direct, enchères en temps réel, incrustations CTA (appel à l'action) pour les marchandises ou les promotions.
Jeux : Statistiques des joueurs en temps réel, y compris le niveau du joueur, les parties gagnées, les badges ; suivi et gestion des classements.
Plus : Statut de l'utilisateur absent/actif, score de confiance de l'utilisateur pour la détection des fraudes, suivi de la localisation de l'utilisateur, états des appareils IoT tels que le niveau de la batterie ou la dernière lecture du capteur.

Comment activer l'App Context

Le contexte applicatif peut être activé comme suit :

Connectez-vous au portail d'administration
Cliquez sur l'onglet "Apps" sur le côté gauche du portail.
Cliquez sur une application. Vous serez amené à la page des ensembles de clés pour cette application.
Si vous ne l'avez pas encore fait, créez un nouvel ensemble de clés en cliquant sur le bouton "Créer un nouvel ensemble de clés". Vous accéderez à la page de configuration de cet ensemble de clés.
Activez App Context en cliquant sur le curseur.
Le paramètre " Bucket Region " correspond à la région dans laquelle vos données sont stockées. Veuillez noter que la région ne peut pas être modifiée après avoir enregistré les changements apportés à l'ensemble de clés.
Si les paramètres User Metadata Events et Channel Metadata Events sont activés, les événements relatifs à l'utilisateur et au canal sont déclenchés lorsque des données sont définies ou supprimées dans la base de données, comme nous le verrons plus loin.
Lorsque le paramètre Événements relatifs aux membres est activé, les événements relatifs aux membres sont déclenchés lorsque des membres sont ajoutés, mis à jour ou supprimés, comme nous le verrons plus loin.
Les autres options n'entrent pas dans le cadre de cet article, mais vous pouvez vous référer à la documentation App Context pour plus d'informations.
Cliquez sur Enregistrer les modifications pour enregistrer ces changements.

Contexte applicatif de l'utilisateur

Lorsqu'un nouvel utilisateur est enrôlé dans votre application, peut-être par le biais d'un fournisseur d'identité externe, vous devez avoir un moyen d'identifier cet utilisateur de manière unique pour PubNub ; c'est l'ID utilisateur que le client de votre utilisateur utilisera pour initialiser le SDK PubNub. L'ID utilisateur PubNub peut ne pas être le même que l'ID que vous utilisez ailleurs dans votre solution pour identifier ce même utilisateur, nous recommandons donc de garder une trace de cela dans le champ 'External ID'.

Le nom d'utilisateur, l'email et l'URL du profil ne nécessitent pas d'explication, mais l'avantage de les conserver dans App Context signifie que si un utilisateur modifie l'un de ces champs, les changements peuvent être propagés à l'échelle à tous les clients qui écoutent en utilisant les événements App Context, qui sont pris en charge par tous nos SDKs.

Comment créer une représentation d'utilisateur dans App Context ?

Il y a deux façons de créer un utilisateur dans App Context.

Les utilisateurs peuvent être créés et gérés en utilisant BizOps Workspace, qui se trouve dans le portail d'administration de PubNub. Cela ne nécessite aucun code, et le processus est expliqué avec des exemples dans l'article séparé : Comment gérer les utilisateurs et les canaux avec BizOps Workspace
Des API sont exposées à travers chacun de nos SDK pour créer des utilisateurs. Si vous utilisez notre SDK de chat, ce SDK gère le contexte de l'application pour vous dans les coulisses ; par exemple, la méthode" createUser()" du SDK de chat appellera le setUIDMetadata de JavaScript sous les couvertures pour créer un utilisateur. Des API dédiées sont fournies pour modifier les données de votre contexte d'application si vous utilisez un SDK autre que le SDK de chat. J'ai déjà mentionné l'API JavaScript setUIDMetadata, mais il existe des équivalents pour toutes nos API, y compris Java, Swift, Kotlin, Python, Unity, etc.

Contexte de l'application du canal

PubNub crée automatiquement des canaux chaque fois qu'un utilisateur s'y abonne ou y publie, mais les canaux représentent probablement quelque chose de significatif pour votre application, par exemple, dans une application de chat, vous pouvez avoir un chat de groupe qui utilise un canal pour communiquer ou un événement en direct peut utiliser un canal dédié pour gérer les sondages.

En spécifiant un contexte d'application pour un canal, vous stockez et mettez à jour toutes les métadonnées souhaitées relatives à ce canal, ces mises à jour étant éventuellement propagées à tous les clients intéressés. Vous pouvez donner un nom à un canal, par exemple "Chat entre l'utilisateur A et l'utilisateur B", et il se peut que le canal soit lié à un stockage de documents, qui pourrait être suivi dans un champ "URI" personnalisé.

Comment créer une représentation de canal dans App Context ?

Comme pour les utilisateurs, il y a deux façons de créer un canal dans App Context.

Les canaux peuvent être créés et gérés en utilisant BizOps Workspace. Cela ne nécessite aucun code, et le processus est expliqué avec des exemples dans l'article séparé : Comment gérer les utilisateurs et les canaux avec BizOps Workspace
Des API sont exposées à travers chacun de nos SDK pour créer des canaux. Si vous utilisez notre SDK de chat, celui-ci gère le contexte de l'application pour vous dans les coulisses ; par exemple, la famille de méthodes"Créer un canal" appellera JavaScript's setChannelMetadata() sous les couvertures. Si vous utilisez un SDK autre que le SDK de chat, des API dédiées sont fournies pour modifier vos données de contexte d'application, y compris JavaScript, Java, Swift, Kotlin, Python, Unity, etc.

Contexte applicatif de l'adhésion

Après avoir défini le contexte applicatif pour les utilisateurs et les canaux, nous pouvons maintenant définir la relation entre les deux en précisant si les utilisateurs sont "membres" d'un canal.

Lorsqu'un utilisateur rejoint un canal, il peut recevoir des mises à jour sur tous les autres membres de ce même canal ; il peut être notifié lorsque des utilisateurs rejoignent ou quittent le canal, ainsi que lorsque le contexte applicatif de cet utilisateur est mis à jour (par exemple, lorsqu'il met à jour son nom).

Il s'agit d*'un mécanisme très puissant qui offre une grande valeur ajoutée*, en particulier pour les développeurs d'applications de chat. Si vous n'utilisiez pas App Context, vous devriez suivre vous-même chaque utilisateur, les canaux dont il est membre et notifier tous les autres membres du même canal lorsque l'utilisateur rejoint ou quitte le canal. Ce défi n'est pas linéaire, donc plus vous avez d'utilisateurs dans votre solution, plus il devient difficile pour vous d'essayer de gérer toutes ces informations de manière centralisée.

En utilisant App Context, vos clients de chat reçoivent toutes les informations dont ils ont besoin pour maintenir leur état interne, et vous avez également un contrôle total sur ces données avec le PubNub Access Manager pour empêcher tout accès non autorisé.

Comment créer une adhésion ?

Comme pour les utilisateurs et les canaux, il y a deux façons de créer une adhésion.

Les membres peuvent être créés et gérés en utilisant BizOps Workspace sans écrire de code. Veuillez consulter la section Gérer les membres de notre documentation pour plus de détails.
Des API sont exposées à travers chacun de nos SDK pour créer des canaux. Si vous utilisez notre SDK de chat, il gère le contexte de l'application pour vous dans les coulisses ; par exemple, la famille de méthodes"Créer un canal" appellera JavaScript's setMemberships sous les couvertures. Si vous utilisez un SDK autre que le SDK de chat, des API dédiées sont fournies pour modifier vos données de contexte d'application, y compris JavaScript, Java, Swift, Kotlin, Python, Unity, etc.

Réception d'événements en temps réel lorsque le contexte applicatif change

Lorsque les données du contexte d'application changent, votre application reçoit un événement qui vous informe en temps réel de ce qui a changé. Cela vous permet de créer des applications réactives sans avoir à interroger le serveur pour obtenir des mises à jour.

Réception des changements de contexte d'application à travers le SDK PubNub (à l'exception du SDK Chat)

Tous les SDKs PubNub exposent des "Event Listeners", et c'est à travers ces listeners que vous pouvez écouter les événements d'objets, qui sont déclenchés chaque fois que les données de l'App Context changent.

Notez qu'il y a une légère nuance ici, car, au moment de la rédaction, certains de nos SDKs supportent un nouveau format pour les "event listeners", comme expliqué dans ce blog à propos des mises à jour du moteur d'événements et des event listeners. Quel que soit le format de l'écouteur d'événement, le principe reste le même : votre application doit s'enregistrer pour recevoir les événements du contexte de l'application par l'intermédiaire d'un écouteur fourni par le SDK.

Comme indiqué dans la documentation du SDK JavaScript, l'enregistrement pour les événements du contexte applicatif se présente comme suit :

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

La documentation décrivant comment s'enregistrer pour les événements de contexte d'application dans d'autres langages peut être trouvée dans les endroits suivants : Java, Swift, Kotlin, Python (Notez que Python appelle les événements "métadonnées", alors que les autres SDKs se réfèrent aux événements en tant qu'"objets"), Unity, etc.

Pour un exemple pratique et une démonstration interactive, veuillez vous référer à l'article Comment gérer les utilisateurs et les canaux avec BizOps Workspace.

Recevoir des changements de contexte d'application à travers le PubNub Chat SDK

Le PubNub Chat SDK exposera les événements de contexte d'application par le biais de la famille d'API streamUpdates().

Quelques exemples, tirés de l'application de démonstration du SDK Chat pour le 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])

Pour un exemple de travail basé sur notre exemple plus simple pour le SDK Chat, veuillez vous référer à l'article Comment gérer les utilisateurs et les canaux avec BizOps Workspace.

App Context et PubNub Illuminate

PubNub Illuminate est un produit d'analyse et de prise de décision en temps réel qui peut être personnalisé en fonction du cas d'utilisation unique d'une organisation. Le produit est conçu pour les gestionnaires de produits et les analystes, leur permettant de faire ce qui suit :

Définir des mesures agrégées personnalisées en temps réel.
Configurer et déployer des règles de décision avec des conditions et des actions.
Visualiser immédiatement les mesures suivies, les actions exécutées et leurs résultats.

Vous pouvez faire tout cela en temps réel sans détourner votre équipe d'ingénieurs de ses projets en cours.

Une explication complète de ce qu'est PubNub Illuminte, et comment il peut vous fournir des informations immédiatement exploitables sur vos données, sort du cadre de cet article, mais nous vous invitons à vous référer à notre documentation et à notre aperçu du produit pour plus d'informations.

En résumé : vous définissez les métriques liées à votre application, c'est-à-dire les éléments que vous souhaitez mesurer. Par exemple, dans un scénario de suivi des actifs, il peut s'agir du nombre d'heures écoulées depuis la prise de commande. Lorsqu'une condition est remplie pour cette mesure, par exemple si le nombre d'heures écoulées depuis la commande dépasse une certaine valeur, vous pouvez prendre des mesures.

L'action à entreprendre est flexible, mais trois des actions possibles sont liées au contexte de l'application :

Mettre à jour l'utilisateur avec PubNub Illuminate

Permet de définir des métadonnées utilisateur prédéfinies ou personnalisées. La capture d'écran ci-dessous montre que l'utilisateur avec l'ID 123 a son statut défini à la valeur statique "Nouveau statut", mais il est également possible de définir une valeur dynamique basée sur la condition qui a déclenché l'action.

Mise à jour du canal avec PubNub Illuminate

Permet de définir des métadonnées prédéfinies ou personnalisées pour le canal. La capture d'écran ci-dessous montre que le canal avec l'ID 123 a son nom défini à la valeur statique 'New Name', mais il est également possible de définir une valeur dynamique basée sur la condition qui a déclenché l'action.

Mettre à jour les adhésions avec PubNub Illuminate

Permet de définir des métadonnées d'adhésion prédéfinies ou personnalisées. La capture d'écran ci-dessous montre l'appartenance de l'ID utilisateur 123 au canal 123 dont l'état est défini sur la valeur statique "Nouvel état". Il est également possible de définir une valeur dynamique basée sur la condition qui a déclenché l'action.

Contexte de l'application et fonctions PubNub

PubNub fournit des fonctions pour capturer les événements qui se produisent sur la plateforme PubNub. Les fonctions vous permettent d'écrire du code ou de tirer parti des intégrations existantes pour transformer, réacheminer, augmenter, filtrer et même agréger des données. Veuillez consulter la documentation sur les fonctions pour un aperçu plus complet des fonctions PubNub, mais cet article examinera comment les fonctions PubNub sont liées à l'App Context.

Mise à jour de l'App Context à partir de PubNub Functions

L'environnement dans lequel les fonctions s'exécutent a accès au module PubNub; ce module a un accès complet à l'App Context sur votre clavier, et quelques exemples tirés de la documentation sont donnés ci-dessous. :

Exemple d'obtention des métadonnées du contexte applicatif de l'utilisateur (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');
  });
};

Exemple de définition des métadonnées du contexte applicatif d'un canal

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

Pour un ensemble complet d'exemples de code, veuillez vous référer à la documentation du module PubNub.

Déclenchement d'une fonction PubNub lors d'un changement de contexte applicatif

Il existe de nombreux types d'événements qui peuvent déclencher une fonction, comme indiqué dans la documentation sur les types d'événements. Ils permettent notamment de détecter l'envoi de messages et de signaux, de déclencher des fonctions après des événements de présence et d'exécuter des fonctions à un intervalle spécifié ou à la demande. Au moment de la rédaction de ce document, il n'est pas possible d'exécuter des fonctions après des mises à jour du contexte d'application, mais si votre application en a besoin, veuillez contacter notre équipe d'assistance, qui se fera un plaisir d'étudier vos cas d'utilisation.

Prochaines étapes

Pour voir App Context en action, vous pouvez consulter notre démo Chat qui utilise App Context avec notre SDK Chat pour montrer ce à quoi une application de chat pourrait ressembler avec un stockage sans serveur. La démo Chat vous permet de définir les métadonnées de l'utilisateur et du canal et de voir ces changements se propager aux autres auditeurs et membres en temps réel.

Consultez également notre série connexe en 3 parties sur l'espace de travail BizOps qui dépend de l'App Context et couvre comment : Gérer les utilisateurs et les canaux, surveiller et modérer les conversations, et modérer le chat en toute sécurité.

Enfin, n'hésitez pas à contacter l'équipe DevRel à l'adresse devrel@pubnub.com ou à contacter notre équipe de support pour obtenir de l'aide sur n'importe quel aspect de votre développement PubNub.

Comment PubNub peut-il vous aider ?

Cet article a été publié à l'origine sur PubNub.com

Notre plateforme aide les développeurs à construire, fournir et gérer l'interactivité en temps réel pour les applications web, les applications mobiles et les appareils IoT.

La base de notre plateforme est le réseau de messagerie en temps réel le plus grand et le plus évolutif de l'industrie. Avec plus de 15 points de présence dans le monde, 800 millions d'utilisateurs actifs mensuels et une fiabilité de 99,999 %, vous n'aurez jamais à vous soucier des pannes, des limites de concurrence ou des problèmes de latence causés par les pics de trafic.

Découvrez PubNub

Découvrez le Live Tour pour comprendre les concepts essentiels de chaque application alimentée par PubNub en moins de 5 minutes.

S'installer

Créez un compte PubNub pour un accès immédiat et gratuit aux clés PubNub.

Commencer

La documentation PubNub vous permettra de démarrer, quel que soit votre cas d'utilisation ou votre SDK.

Notes de mise à jour de la documentation - juin 2024

PubNub Developer Relations — Mon, 08 Jul 2024 13:01:31 +0000

Cet article a été publié à l'origine sur https://www.pubnub.com/docs/release-notes/2024/june

Bonjour à tous ! Nous avons quelques nouvelles mises à jour pour vous ce mois-ci.

Nous avons introduit un nouveau drapeau d'intégrité référentielle pour aider à garder vos données cohérentes.
Vous pouvez maintenant définir des limites de groupes de canaux directement à partir du portail d'administration.
Essayez d'importer des données d'Insights vers BizOps pour tester ses fonctionnalités.
De plus, vous remarquerez que l'aspect et la convivialité de la gestion de la présence ont été revus.

Par ailleurs, nous avons apporté un certain nombre d'améliorations mineures mais significatives à la documentation qui, nous l'espérons, répondra à certaines de vos questions ou dissipera les doutes que vous aviez lorsque vous travailliez avec PubNub.

Bonne exploration et merci de faire partie de notre communauté !

Généralités 🛠️

Champs personnalisés dans les payloads FCM

Type: Amélioration

Nous avons corrigé la documentation pour les notifications push mobiles Android en ajoutant les paramètres PubNub personnalisés manquants que vous pouvez ajouter à votre payload de notification push mobile FCM : pn_debug, pn_exceptions, et pn_dry_run.

Ils vous permettront de tester ou de déboguer les notifications et d'exclure certains appareils de la réception des notifications.

Voici un exemple de charge utile FCM avec nos champs personnalisés :

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

Channel group limits

Type: Nouvelle fonctionnalité

Le contrôleur de flux dans le portail d'administration dispose d'une nouvelle option configurable de limite de groupe de canaux pour les clients bénéficiant de plans tarifaires payants, qui vous permet de définir les limites du nombre maximum de canaux que les groupes de canaux d'un ensemble de clés peuvent avoir. Vous pouvez abaisser la limite par défaut de 1 000 canaux ou l'augmenter jusqu'à 2 000 canaux.

Événements de métadonnées de l'utilisateur dans le contexte de l'application

Type: Amélioration

Nous avons amélioré la documentation pour clarifier qu'avec l'option " User Metadata Events " activée, toute modification d'une entité utilisateur(définition et suppression) entraîne l'envoi de notifications d'événements à toutes les associations de membres, donc à la fois à cet utilisateur et à tous les canaux dont il est membre. Se référer à la documentation pour plus de détails.

Dépendance de configuration du contexte d'application

Type: Amélioration

Nous avons mis à jour la documentation sur les options de configuration du contexte applic atif afin d'inclure des informations sur une dépendance critique.

Bien que les options Disallow Get All Channel Metadata et Disallow Get All User Metadata semblent assez explicites, la mise en garde est que ces options ne fonctionnent qu'avec un gestionnaire d'accès activé.

En d'autres termes, sans le gestionnaire d'accès, ces options actives ne désactivent pas réellement l'obtention de métadonnées sur les utilisateurs ou les canaux d'une unité centrale. Parallèlement, lorsque vous activez le gestionnaire d'accès, restreignant ainsi par défaut l'accès à tous les objets d'un jeu de clés, vous pouvez facilement contourner les restrictions GET du gestionnaire d'accès pour les utilisateurs et les canaux en décochant ces deux options de configuration sans créer un schéma de permissions à granularité fine.

L'interface utilisateur du portail d'administration reflétera bientôt cette dépendance.

Nouveau drapeau d'intégrité référentielle dans App Context

Type: Nouvelle fonctionnalité

Nous avons ajouté une nouvelle option " Enforce referential integrity for memberships ", qui est activée par défaut lorsque vous activez App Context sur le jeu de clés de votre application dans le portail d'administration.

Cette option garantit que vous ne pouvez définir une nouvelle adhésion que si l'ID de l'utilisateur et l'ID du canal pour lesquels vous avez créé l'adhésion existent tous les deux. Parallèlement, la suppression d'un utilisateur parent ou d'une entité de métadonnées de canal supprime automatiquement toutes les associations d'affiliation enfant pour l'entité supprimée. De cette façon, vous vous assurez qu'il n'y a pas d'objets d'appartenance dysfonctionnels ou orphelins sur votre ensemble de clés.

SDKs 📦

Amélioration de la documentation Python

Type: Amélioration

Suite aux commentaires que nous avons reçus, nous avons étendu les informations sur l'utilisation et l'exécution des méthodes. Ainsi, chaque section Returns de la documentation du SDK P ython décrit désormais les champs de données renvoyés par chaque méthode. Elle explique également comment l'exécution des requêtes sync (.sync()) et async (.pn_async(callback)) influence les données renvoyées pour chaque méthode.

React SDK a été déprécié

Type: Avis de dépréciation

Comme nous n'avons pas développé activement le React SDK depuis un certain temps, nous avons décidé de déprécier officiellement sa documentation et de la déplacer dans la section Call For Contributions (appel à contribution ) de notre documentation.

Si vous trouvez un bug dans le SDK React ou si vous voulez étendre ses fonctionnalités, n'hésitez pas à créer une pull request dans le repo et attendez notre feedback !

Fonctions

Exporter les logs de fonctions à travers Events & Actions

Type: Nouvelle fonctionnalité

Chaque fonction PubNub enregistre les logs dans le canal interne blocks-output-*, comme blocks-output-NSPiAuYKsWSxJl4yBn30, qui peut stocker jusqu'à 250 lignes de logs avant que de nouveaux logs ne les écrasent. Si vous ne voulez pas perdre la trace des anciens journaux, vous pouvez désormais utiliser Events & Actions pour exporter ces journaux vers un service externe.

Perspectives 📊

Durée de l'utilisateur et métriques de l'appareil dans les documents de l'API REST

Type: Amélioration

Lemois dernier, nous avons introduit les métriques d'appareils dans le tableau de bord Comportement de l'utilisateur dans PubNub Insights sur le portail d'administration. Ce mois-ci, nous avons mis à jour la documentation de l'API REST pour inclure à la fois la durée de l'utilisateur et les métriques de l'appareil, de sorte que vous pouvez appeler l'API PubNub Insights directement pour obtenir les métriques qui vous intéressent.

Espace de travail BizOps 🏢

Les 20 premiers utilisateurs/canaux

Type: Nouvelle fonctionnalité

Si vous n'utilisez pas App Context pour stocker et gérer les utilisateurs et les canaux, vous pouvez toujours tester les fonctionnalités connexes de BizOps Workspace en important des données de test.

Si vous avez accès à PubNub Insights, vous pouvez y accéder en allant aux modules Gestion des utilisateurs et Gestion des canaux dans BizOps Workspace dans le portail d'administration et en cliquant sur le bouton Importer à partir d'Insights.

En conséquence, vous importerez depuis le jeu de clés de votre application un maximum de 20 utilisateurs qui ont publié le plus grand nombre de messages au cours de la dernière journée (si aucun message n'a été envoyé hier, les utilisateurs seront importés sur la base des données de la veille).

Comme pour les utilisateurs, vous pouvez importer de l'ensemble de clés de votre application jusqu'à 20 canaux ayant publié le plus grand nombre de messages au cours de la dernière journée.

Utilisez ces données de test pour explorer ce que BizOps Workspace a à offrir.

L'interface utilisateur de la gestion de la présence revue et corrigée

Type: Amélioration

Nous avons récemment redessiné l'ensemble du module de gestion de la présence dans BizOps Workspace afin de simplifier l'assistant de création de règles, de changer les couleurs des badges pour des couleurs plus inclusives et d'ajouter un modèle de configuration " catch all " qui reflète la configuration par défaut " activer la présence sur tous les canaux " de la configuration de la présence sur l'ensemble de clés.

Nous espérons que vous apprécierez sa nouvelle apparence et sa nouvelle convivialité !

Notes de mise à jour de la documentation - mai 2024

PubNub Developer Relations — Mon, 08 Jul 2024 11:27:43 +0000

Cet article a été publié à l'origine sur https://www.pubnub.com/docs/release-notes/2024/may

Bienvenue dans les notes de version de ce mois-ci ! PubNub vous apporte un ensemble de mises à jour conçues pour rationaliser votre travail et ajouter une touche de commodité.

Que contient ce paquet ?

Nous avons unifié la documentation sur le filtrage des données App Context, revu l'architecture de l'écouteur d'événements pour Python et Asyncio, et ajouté de nouveaux outils visant à vous aider à démarrer avec la modération sécurisée des chats.

Sur le front du portail d'administration, nous avons amélioré notre jeu avec des métriques détaillées sur les appareils, amélioré la gestion des événements avec des options de mise en lot et d'enveloppement, et déployé de nouveaux graphiques à barres empilées et des fonctionnalités variables dans Illuminate.

De plus, nos documents et notre site Web disposent désormais d'un nouveau moteur de recherche doté d'une intelligence artificielle pour vous aider à trouver exactement ce dont vous avez besoin.

Plongez dans l'aventure et explorez les nouveautés !

Généralités 🛠️

Info unifiée sur le filtrage des données App Context

Type: Amélioration

Description: Sur la base des retours, nous avons revu et unifié les informations des différents SDKs sur le filtrage des données des utilisateurs, des canaux et des membres en utilisant l'API App Context de PubNub. En conséquence, nous avons créé un document sur le filtrage du contexte applic atif (étayé par de nombreux exemples) qui sert de point d'entrée pour toutes les requêtes de filtrage de données.

Apprenez :

Quelles données sur les utilisateurs, les canaux et les membres vous pouvez filtrer.
Quels opérateurs de filtrage utiliser.
Comment vous pouvez filtrer les données à l'aide d'exemples pratiques.

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

SDKs 📦

Mise à jour de l'architecture des écouteurs d'événements pour Python et Asyncio

Type: Nouvelle fonctionnalité

Description: La nouvelle architecture d'écoute d'événements pour les SDK Python et Asyncio introduit des moyens plus restreints de gérer les abonnements et d'écouter les événements par rapport à l'objet monolithique PubNub précédent.

Alors que l'objet PubNub sert toujours de portée globale et reste compatible avec le passé, la nouvelle architecture propose des objets "entités" tels que des canaux, des groupes de canaux, des métadonnées d'utilisateurs et des métadonnées de canaux qui renvoient des objets "Subscription" (abonnement).

Ces abonnements permettent d'appliquer des méthodes de souscription/désabonnement et des méthodes d'ajout/suppression d'auditeurs spécifiques à des entités uniques, offrant un moyen plus souple et indépendant de gérer les événements en temps réel et réduisant la nécessité d'une gestion globale de l'état.

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

Chat 💬

Exemple de modération sécurisée dans Chat SDK

Type: Nouvelle fonctionnalité

Description: Notre équipe de chat a créé un service API Access Manager simple pour vous aider à comprendre le scénario de bout en bout pour sécuriser les applications Chat SDK avec Access Manager. Ce service simule un point de terminaison simple et inclut un exemple d'ensemble de permissions que vous pouvez utiliser pour configurer l'autorisation côté serveur pour vos applications Chat SDK avec Access Manager activé.

Suivez l'ensemble du scénario de test en utilisant notre React Native Chat App (pour l'interaction avec les utilisateurs), Channel Monitor (pour la modération des utilisateurs, comme le muting et le bannissement), et Access Manager API (pour générer des jetons d'autorisation).

Pour les étapes détaillées, consultez le blog Comment modérer en toute sécurité le chat et les utilisateurs avec BizOps Workspace.

Perspectives 📊

Tableau de bord des mesures des appareils

Type: Amélioration

Description: Nous avons étendu le tableau de bord Comportement de l'utilisateur dans Insights pour inclure des métriques de type d'appareil. Cela vous permet de plonger en profondeur dans le comportement de vos utilisateurs par type d'appareil. Désormais, vous pouvez observer où les utilisateurs de votre application publient ou s'abonnent le plus souvent (iOS, Android et Windows) et vérifier le nombre d'utilisateurs uniques par type d'appareil.

Cet aperçu peut vous aider à créer des fonctionnalités personnalisées par appareil et, ainsi, à améliorer l'expérience client.

Événements et actions ⚡

L'action Webhook prend désormais en charge la mise en lot

Type: Amélioration

Description: La fonctionnalité de mise en lot dans Events & Action vous permet de gérer un grand volume d'événements en les envoyant en une seule demande plutôt que d'envoyer chaque événement individuellement. Cette fonctionnalité est également disponible pour le type d'action Webhook depuis le mois de mai.

(Non)enveloppant

Type: Amélioration

Description: Vous pouvez maintenant envelopper le payload de chaque action dans une enveloppe, c'est-à-dire choisir si le schéma du payload doit contenir des métadonnées JSON détaillées sur les événements et les actions. Cela peut être utile dans les cas où vous voulez utiliser des métadonnées en dehors du payload, comme des informations sur le canal où le payload a été envoyé ou l'auditeur qui l'a déclenché.

Illuminer 💡

Diagrammes à barres empilées

Type: Nouvelle fonctionnalité

Description: En plus des graphiques à barres et des graphiques linéaires, les tableaux de bord Illuminate proposent désormais un nouveau type de graphique à barres empilées qui améliore la lisibilité des données lorsqu'il y a de nombreuses dimensions et valeurs sur un seul graphique.

Variables

Type: Amélioration

Description: Lorsque vous créez des actions dans Decisions (en indiquant ce que vous voulez faire avec les métriques collectées), vous pouvez ajouter des variables dans les tables de configuration des actions pour contrôler et modifier dynamiquement ce à quoi elles se réfèrent. Vous pouvez utiliser les variables de manière plus souple, soit en vous référant aux conditions prédéfinies (tapez ${) et choisissez dans la liste), soit en créant de nouvelles variables(${variable}) au fur et à mesure. Les variables sont désormais disponibles pour la plupart des champs d'action, et non plus seulement dans la charge utile ou le corps de l'action.

Champs de mappage de données améliorés

Type: Amélioration

Description: Lorsque vous créez un objet d'affaires et définissez des mesures (les données que vous voulez suivre) ou des dimensions (pour segmenter ce que vous suivez), vous devez mapper les noms de champs aux champs réels dans votre charge utile pour permettre à Illuminate de savoir où ces données doivent être recherchées. Jusqu'à présent, vous deviez entrer manuellement le mappage exact du champ spécifique de la charge utile. Depuis le mois de mai, Illuminate propose des menus déroulants plus conviviaux pour localiser l'emplacement exact des données Publish et App Context.

Autres 🌟

Nouvel assistant de recherche et d'IA

Type: Nouvelle fonctionnalité

Description: Enfin, nous avons troqué la recherche Algolia dans nos documents pour la nouvelle expérience combinée de recherche et d'assistant IA afin de rendre l'aventure d'apprentissage de PubNub plus précise et interactive.

Il est temps d'améliorer votre jeu de codage et de vous faire des amis avec notre nouvel assistant IA et notre nouvelle fonction de recherche. Nous l'affinerons en fonction de vos commentaires, donc si quelque chose manque, nous nous assurerons de le mettre à jour. Bon codage ! 🚀

Vue d'ensemble des technologies de flux de données

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

La capacité à traiter de gros volumes de données (big data) en temps réel est devenue cruciale pour de nombreuses organisations, et c'est là que les technologies de flux de données entrent en jeu. Ces technologies permettent de traiter de grandes quantités de données en temps réel ou presque dès qu'elles sont générées, ce qui permet aux entreprises d'obtenir des informations immédiates et de prendre des décisions fondées sur des données sensibles au facteur temps.

Au cœur de ces technologies se trouve le concept de flux de données, également connu sous le nom de flux d'événements. Les flux de données sont des séquences produites par diverses sources, telles que les flux de médias sociaux, les appareils de l'internet des objets (IoT), les fichiers journaux, les ensembles de données scientifiques, etc. Ces flux de données sont ensuite ingérés et traités par des technologies de streaming de données.

Un autre aspect important est l'évolutivité des flux de données. Au fur et à mesure que le volume de données augmente, les technologies peuvent évoluer pour gérer la charge accrue, garantissant ainsi que les entreprises peuvent récolter des analyses en temps réel. Cela signifie que les entreprises peuvent analyser leurs données au fur et à mesure qu'elles sont générées, ce qui leur permet de prendre des décisions rapides, particulièrement utiles dans les scénarios où le facteur temps est important, comme la détection des fraudes ou l'optimisation de l'expérience des clients.

Les technologies de flux de données prennent en charge différents formats, des données structurées comme les bases de données SQL aux données non structurées comme les événements en direct ou les flux de médias sociaux ; cela garantit que les entreprises peuvent traiter et analyser tous les types de données, indépendamment de leur source ou de leur format. Il est important de noter que si ces technologies offrent de nombreux avantages, elles s'accompagnent également de défis ; par exemple, leur mise en œuvre et leur gestion requièrent des compétences sophistiquées en matière d'ingénierie des données, ce qui nécessite une faible latence et un débit élevé, en particulier lors du traitement de gros volumes de données.

Concepts de base des technologies de flux de données

Les technologies de flux de données reposent sur plusieurs concepts fondamentaux. Il est essentiel de comprendre ces concepts pour tirer pleinement parti de la puissance du traitement des données en temps réel :

Flux de données

Les flux de données sont des flux de données continus provenant de diverses sources, telles que les appareils IoT, les fichiers journaux, les marchés boursiers, etc. Ces sources de données produisent des données à une vitesse élevée, souvent en temps réel ou presque, et les données produites sont généralement sensibles au temps, ce qui signifie que leur pertinence diminue avec le temps.

Traitement des flux

Le traitement des flux est le traitement en temps réel des flux de données. Contrairement au traitement par lots, qui traite les données à intervalles réguliers, le traitement par flux traite les données dès leur arrivée. Cela permet d'obtenir une faible latence, ce qui est essentiel pour les applications sensibles au temps, telles que le suivi de la position de l'utilisateur ou les prix des marchandises et la prise de décision en fonction de ces valeurs.

Traitement par lots et traitement en flux

Le traitement par lots et le traitement en flux représentent deux approches différentes du traitement des données. Le traitement par lots traite de grands volumes de données en une seule fois, à intervalles programmés, et convient aux tâches d'analyse de données non sensibles au temps. En revanche, le traitement en flux traite les données dès qu'elles sont générées, ce qui permet d'obtenir des informations en temps réel.

Cette approche se situe entre le traitement par lots et le traitement par flux, lorsque des données très récentes sont nécessaires, mais pas nécessairement en temps réel.

Architecture des flux de données

L'architecture typique des technologies de flux de données comprend des sources de données, des systèmes d'ingestion de données, des systèmes de traitement de flux et des systèmes de stockage de données.

Les sources de données génèrent des flux de données.
Les systèmes d'ingestion de données, comme Apache Kafka ou Amazon Kinesis, capturent ces flux de données pour les traiter.
Un processeur de flux, tel qu'Apache Flink ou Apache Spark Streaming, traite les données ingérées en temps réel.
Les données traitées sont ensuite stockées dans des lacs de données ou des entrepôts de données pour une analyse plus approfondie ou des tableaux de bord de visualisation.
Les données peuvent être transmises en continu à la périphérie de votre réseau directement à l'aide de systèmes tels que PubNub Kafka Bridge.

Les données circulent dans l'architecture de la source à la destination dans des pipelines de données. Par essence, les pipelines de données représentent le parcours des données depuis leur point d'origine jusqu'à leur stockage ou leur visualisation, en passant par l'ingestion et le traitement.

Cohérence des données

La cohérence des données est une préoccupation importante dans le cadre de la diffusion en continu de données. Les technologies de diffusion en continu des données utilisent diverses techniques telles que l'ordonnancement des événements, le traitement à l'identique et la tolérance aux pannes pour garantir la cohérence. Ces techniques garantissent que les données sont traitées dans le bon ordre, qu'aucune donnée n'est perdue ou traitée plusieurs fois, et que le système peut se remettre d'une défaillance sans perte de données.

Par exemple, PubNub offre plusieurs moyens de garantir la livraison des messages, tels que les accusés de réception, l'ordre des messages et la mise en file d'attente.

Outils pour les technologies de flux de données

Il existe plusieurs outils commerciaux et open-source pour la mise en œuvre des technologies de flux de données. Il s'agit notamment d'Apache Kafka, d'Apache Flink, d'AWS Kinesis et de Microsoft Azure Stream Analytics. Chaque outil a ses propres points forts et ses propres cas d'utilisation, et le choix de l'outil dépend des exigences spécifiques de l'application de streaming de données.

Prochaines étapes avec PubNub Data Streaming

Après avoir compris les concepts de base et l'architecture des technologies de streaming de données, l'étape suivante consiste à mettre en œuvre ces technologies dans vos propres systèmes. PubNub fournit une plateforme de streaming de données en temps réel robuste et évolutive qui peut être facilement intégrée dans votre architecture existante.

Voici les étapes à suivre pour commencer à utiliser PubNub Data Streaming :

Explorer les démos: PubNub fournit une démo de streaming de données en temps réel pour vous aider à comprendre le fonctionnement de notre plateforme. Cette démo s'applique à un large éventail de cas d'utilisation, depuis les applications de chat jusqu'au contrôle des appareils IoT.
Comprendre les bases: PubNub fournit un glossaire complet qui décrit les termes et concepts clés, y compris une entrée sur le streaming de données.
Comprendre*PubNub Illuminate*: Avec PubNub Illuminate, vous pouvez adapter les stratégies de monétisation à la volée, lier le comportement de l'utilisateur à des incitations, suivre chaque action avec des métriques agrégées et des appareils personnalisés en temps réel, et voir instantanément les résultats - tout cela sans alourdir votre équipe de développement.
Inscription: Créez un compte PubNub. Vous pouvez le faire sur leur page d'inscription. Le niveau gratuit de votre compte PubNub a des limites généreuses et ne nécessite pas de carte de crédit jusqu'à ce que vous soyez prêt à mettre à niveau.
Commencez à construire: Une fois que vous avez maîtrisé les bases, créez vos propres applications de flux de données. PubNub propose une multitude de tutoriels qui vous guident dans la création de différents types d'applications, y compris un tutoriel sur la création d'une application de streaming de données en temps réel.
Explorer les API: PubNub fournit une large gamme d'API et de SDK que vous pouvez utiliser pour créer vos applications. Vous pouvez trouver plus d'informations sur notre page de documentation SDK.
Comprendre la tarification: Avant de terminer la construction, il est utile de savoir combien cela va coûter. Vous pouvez trouver plus d'informations sur les prix de PubNub sur leur page de prix.

Approfondir les cas d'utilisation des technologies de streaming de données

Analyse des données en temps réel

L'analyse de données en temps réel est l'un des principaux cas d'utilisation des technologies de flux de données. En traitant et en analysant les flux de données en temps réel, les entreprises peuvent obtenir des informations immédiates sur leurs opérations et prendre des décisions rapides et éclairées. Cela peut être particulièrement utile dans des secteurs tels que la finance, où l'analyse des données en temps réel peut être utilisée pour la détection des fraudes, l'analyse des tendances du marché, etc.

PubNub Illuminate est un exemple de plateforme d'analyse en temps réel. Cependant, PubNub Illuminate est plus qu'une simple plateforme de gestion de données, elle vous permet également de définir des conditions basées sur vos métriques de données, qui, lorsqu'elles sont déclenchées, effectueront des actions dynamiques basées sur ces données.

Internet des objets (IoT)

Une autre application importante des technologies de flux de données est l'Internet des objets (IoT), où les appareils génèrent des flux de données qui peuvent être traités en temps réel pour fournir des informations précieuses. Par exemple, la surveillance des performances des équipements industriels permet aux entreprises de détecter et de traiter les problèmes avant qu'ils ne conduisent à une défaillance de l'équipement.

Analyse des médias sociaux

Les plateformes de médias sociaux génèrent des volumes massifs de données chaque seconde, et les technologies de streaming de données peuvent traiter ces données en temps réel, ce qui permet aux entreprises de surveiller les tendances, de suivre le sentiment des clients et de répondre immédiatement à leurs commentaires.

Commerce électronique

Dans le secteur du commerce électronique, les technologies de diffusion de données peuvent suivre le comportement des clients en temps réel, ce qui permet aux entreprises de fournir des recommandations personnalisées, d'améliorer l'expérience des clients et d'augmenter les ventes.

Tendances futures des technologies de flux de données

Intégration avec l'apprentissage automatique et l'IA

L'une des principales tendances des technologies de diffusion de données en continu est l'intégration de l'apprentissage automatique et de l'IA générative. Les modèles d'apprentissage automatique peuvent recevoir les données en temps réel nécessaires pour faire des prédictions précises et opportunes. Cela peut être particulièrement utile pour la maintenance prédictive, où les modèles d'apprentissage automatique peuvent prédire les défaillances des pièces sur la base de données en temps réel - par exemple, les cycles de décharge de la batterie d'un appareil mobile peuvent être utilisés pour estimer la durée de vie prévue de la batterie.

Utilisation accrue des frameworks open-source

Les frameworks open-source tels que Apache Kafka, Apache Flink et Spark Streaming sont devenus des outils populaires pour la mise en œuvre des technologies de flux de données. Ces frameworks offrent de solides capacités de traitement de gros volumes de données en temps réel, et leur nature open-source les rend hautement personnalisables et adaptables à différents cas d'utilisation. Nous nous attendons à une utilisation accrue de ces frameworks et d'autres frameworks à code source ouvert à l'avenir.

Une plus grande importance accordée à la sécurité des données et à la protection de la vie privée

Comme les entreprises s'appuient de plus en plus sur les technologies de flux de données pour traiter les données sensibles, l'accent sera mis davantage sur la sécurité et la confidentialité des données. Il s'agira de mettre en œuvre des mesures de sécurité robustes pour protéger les flux de données contre les accès non autorisés et de veiller au respect des réglementations en matière de confidentialité des données.

Des techniques d'ingénierie des données plus avancées

Nous nous attendons à voir apparaître des techniques d'ingénierie des données plus avancées à mesure que les ingénieurs se familiariseront avec les technologies, y compris des algorithmes plus sophistiqués pour traiter les flux, optimiser les pipelines de données et assurer la cohérence des données.

Conclusion

L'avenir des technologies de flux de données est prometteur. En fournissant aux entreprises de meilleures informations opérationnelles en temps réel, elles peuvent prendre des mesures immédiates sans avoir à s'appuyer sur des données historiques, ce qui accroît la satisfaction des clients, l'efficacité et la rentabilité. Quel que soit votre secteur d'activité, qu'il s'agisse de gestion de la clientèle, d'e-commerce, d'IoT ou d'analyse des médias sociaux, les technologies de streaming de données ont le potentiel de transformer le mode de fonctionnement des entreprises.

PubNub peut vous aider à transformer votre entreprise grâce au streaming de données. N'hésitez pas à contacter l'équipe DevRel à l'adresse devrel@pubnub.com ou à contacter notre équipe de support pour obtenir de l'aide sur n'importe quel aspect de votre développement PubNub.

Comment PubNub peut-il vous aider ?

Cet article a été publié à l'origine sur PubNub.com

Notre plateforme aide les développeurs à construire, fournir et gérer l'interactivité en temps réel pour les applications web, les applications mobiles et les appareils IoT.

Découvrez PubNub

Découvrez le Live Tour pour comprendre les concepts essentiels de chaque application alimentée par PubNub en moins de 5 minutes.

S'installer

Créez un compte PubNub pour un accès immédiat et gratuit aux clés PubNub.

Commencer

La documentation PubNub vous permettra de démarrer, quel que soit votre cas d'utilisation ou votre SDK.

Modération de chat avec OpenAI

PubNub Developer Relations — Wed, 03 Jul 2024 15:42:12 +0000

Toute application contenant un chat in-app a besoin d'un moyen de réguler et de modérer les messages que les utilisateurs peuvent échanger. Comme il n'est pas possible de modérer tous les contenus inappropriés avec des modérateurs humains, le système de modération doit être automatique. Comme les utilisateurs essaieront fréquemment de contourner la modération, l'apprentissage automatique, l'IA générative et les grands modèles de langage (LLM) [et les modèles GPT tels que GPT-3 et GPT-4] sont des moyens populaires de modérer le contenu.

La modération est un sujet complexe, et PubNub offre diverses solutions pour répondre à tous les cas d'utilisation de nos développeurs.

Lesfonctions PubNub peuvent intercepter et modifier les messages avant qu'ils n'atteignent leur destination. Vous pouvez appliquer une logique personnalisée au sein d'une fonction, y compris en appelant une API REST externe, ce qui vous permet d'utiliser n'importe quel service externe pour la modération des messages. Cette approche est utilisée dans cet article pour intégrer OpenAI.
Les fonctions PubNub offrent des intégrations personnalisées qui supportent la modération de contenu et l'analyse de sentiment, y compris Lasso Moderation, Tisane, un filtre de blasphème basé sur RegEx, Lexalytics, et Community Sift.
L'espace de travail BizOps de PubNub peut surveiller et modérer les conversations, y compris la possibilité d'éditer et de supprimer des messages.

Le point final de modération d'Open AI

Cet article se penche sur l'API de modération d'OpenAI, une API REST qui utilise l'intelligence artificielle (IA) pour déterminer si le texte fourni contient des termes potentiellement préjudiciables. L'objectif de l'API est de permettre aux développeurs de filtrer ou de supprimer le contenu préjudiciable et, au moment de la rédaction de cet article, elle est fournie gratuitement, mais ne prend en charge que l'anglais.

Le modèle qui sous-tend l'API de modération classera le texte fourni comme suit (extrait de la documentation de l'API) :

Haine : contenu qui exprime, incite ou encourage la haine basée sur la race, le sexe, l'ethnicité, la religion, la nationalité, l'orientation sexuelle, le handicap ou la caste. Les contenus haineux visant des groupes non protégés (par exemple, les joueurs d'échecs) relèvent du harcèlement.
Haine / Menace : Contenu haineux qui comprend également des actes de violence ou des préjudices graves à l'encontre du groupe ciblé en raison de sa race, de son sexe, de son appartenance ethnique, de sa religion, de sa nationalité, de son orientation sexuelle, de son statut de handicapé ou de sa caste.
Harcèlement : Contenu qui exprime, incite ou promeut un langage de harcèlement à l'égard d'une cible.
Harcèlement / Menace : Contenu de harcèlement qui inclut également des actes de violence ou de graves préjudices à l'encontre d'une cible.
Automutilation : contenu qui promeut, encourage ou dépeint des actes d'automutilation, tels que le suicide, les coupures et les troubles de l'alimentation.
Automutilation / Intention : Contenu dans lequel le locuteur exprime qu'il se livre ou a l'intention de se livrer à des actes d'automutilation, tels que le suicide, la mutilation et les troubles de l'alimentation.
Automutilation / Instructions : Contenu qui encourage la réalisation d'actes d'automutilation, tels que le suicide, la mutilation et les troubles alimentaires, ou qui donne des instructions ou des conseils sur la manière de commettre de tels actes.
Sexuel : Contenu destiné à susciter une excitation sexuelle, comme la description d'une activité sexuelle, ou qui fait la promotion de services sexuels (à l'exclusion de l'éducation sexuelle et du bien-être).
Sexuel / mineurs : Contenu à caractère sexuel mettant en scène une personne âgée de moins de 18 ans.
Violence : Contenu décrivant la mort, la violence ou les blessures physiques.
Violence / graphique : Contenu décrivant la mort, la violence ou les blessures physiques de manière graphique.

Les résultats sont fournis dans une structure JSON comme suit (encore une fois, tirée de la documentation de l'API) :

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

Appel de l'API de modération Open AI à partir de PubNub

L'intégration de l'API de modération dans n'importe quelle application PubNub est facile en utilisant les fonctions PubNub en suivant ce tutoriel étape par étape :

Les fonctions vous permettent de capturer des événements en temps réel qui se produisent sur la plateforme PubNub, tels que des messages envoyés et reçus ; vous pouvez ensuite écrire du code serverless personnalisé dans ces fonctions pour modifier, réacheminer, augmenter ou filtrer les messages selon les besoins.

Vous devrez utiliser le type d'événement "Before Publish or Fire" ; ce type de fonction sera invoqué avant que le message ne soit livré et doit finir de s'exécuter avant que le message ne soit libéré pour être livré à ses destinataires. La documentation PubNub fournit plus de contexte et de détails, mais en résumé : "Before Publish or Fire" est un appel synchrone qui peut modifier un message ou sa charge utile.

Créer la fonction PubNub

Connectez-vous au portail d'administration de PubNub et sélectionnez l'application et le jeu de clés de l'application que vous souhaitez modérer.
Sélectionnez 'Functions', qui se trouve sous l'onglet 'Build'.
Sélectionnez '+ CREATE NEW MODULE' et donnez un nom et une description au module.
Sélectionnez "+ CREATE NEW FUNCTION" et donnez un nom à la fonction.
Pour le type d'événement, sélectionnez "Before Publish or Fire".
Pour le nom du canal, entrez * (cette démo utilisera *, mais votre application peut choisir de ne spécifier ici que les canaux que vous souhaitez modérer).

Après avoir créé la fonction PubNub, vous devez fournir votre clé API Open AI comme secret.

Sélectionnez "MES SECRETS" et créez une nouvelle clé avec le nom "OPENAI_API_KEY".
Générez une clé API Open AI et assurez-vous qu'elle a accès à l'API modérée.
Fournissez la clé API générée au secret de la fonction PubNub que vous venez de créer.

Le corps de la fonction PubNub se présente comme suit :

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

La fonction elle-même est assez simple :

Pour chaque message reçu :

Le transmettre à la fonction de modération d'Open AI
Ajouter l'objet de modération retourné comme une nouvelle clé sur l'objet Message (JSON)

Sauvegardez votre fonction et assurez-vous que votre module est démarré.

Temps de latence

La fonction PubNub que vous venez de créer sera exécutée de manière synchrone à chaque fois qu'un message est envoyé, et ce message ne sera pas délivré tant que la fonction n'aura pas fini de s'exécuter. Comme la fonction contient un appel à une API externe, la latence de délivrance dépendra de la vitesse de retour de l'appel API à Open AI, qui est hors du contrôle de PubNub et qui pourrait être assez élevée.

Il existe plusieurs façons d'atténuer toute dégradation de l'expérience utilisateur. La plupart des déploiements fournissent à l'expéditeur un retour immédiat indiquant que le message a été envoyé et s'appuient ensuite sur les accusés de réception pour indiquer que le message a été délivré (ou signalé).

Mise à jour de l'application client

Examinons ce qui serait nécessaire pour gérer la charge utile de modération dans votre application en utilisant la démo Chat, qui est une application React qui utilise le PubNub Chat SDK pour montrer la plupart des fonctionnalités d'une application de chat typique.

Configurez un attribut pour savoir si un message potentiellement dangereux doit être affiché ou non :

 const [showHarmfulMessage, setShowHarmfulMessage] = useState(false)

Et ajouter une certaine logique pour ne pas afficher un message potentiellement nuisible par défaut, dans ce cas dans 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>
}

Notez que ces changements ne sont pas présents dans la version hébergée de la démo de chat, mais le ReadMe contient des instructions complètes pour la construire et l'exécuter vous-même à partir de votre propre jeu de clés.

Récapitulation

Et voilà, un moyen rapide et facile (et gratuit) d'ajouter à la fois la modération et l'analyse des sentiments à votre application en utilisant Open AI.

Pour en savoir plus sur l'intégration d'Open AI avec PubNub, consultez ces autres ressources :

Intégration de l'API OpenAI GPT avec les fonctions
Construire un Chatbot avec PubNub et ChatGPT (Ajouter un Chatbot à notre vitrine PubNub)
Améliorer une Geo App avec PubNub & Chat GPT / OpenAI

N'hésitez pas à contacter l'équipe DevRel à devrel@pubnub.com ou à contacter notre équipe de support pour obtenir de l'aide sur n'importe quel aspect de votre développement PubNub.

Comment PubNub peut-il vous aider ?

Cet article a été publié à l'origine sur PubNub.com

Notre plateforme aide les développeurs à construire, fournir et gérer l'interactivité en temps réel pour les applications web, les applications mobiles et les appareils IoT.

Découvrez PubNub

Découvrez le Live Tour pour comprendre les concepts essentiels de chaque application alimentée par PubNub en moins de 5 minutes.

S'installer

Créez un compte PubNub pour un accès immédiat et gratuit aux clés PubNub.

Commencer

La documentation PubNub vous permettra de démarrer, quel que soit votre cas d'utilisation ou votre SDK.

Comment utiliser Illuminate pour équilibrer vos jeux ?

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

La dernière version du produit PubNub, Illuminate, est un outil de prise de décision évolutif que nous avons conçu pour aider les développeurs de jeux, les chefs de produits et les chefs de projets à construire, itérer et expérimenter au sein de la plateforme PubNub.

Conçu avec une excellente interface utilisateur, vous pouvez utiliser Illuminate pour prendre des décisions afin d'améliorer l'expérience des joueurs et d'accélérer la monétisation en temps réel.

Qu'est-ce que l'équilibrage des jeux et comment pouvez-vous l'utiliser en temps réel ?

L'équilibrage des jeux est une branche de la conception des jeux qui améliore le gameplay et l'expérience utilisateur en équilibrant la difficulté et l'équité. L'équilibrage du jeu consiste à ajuster les récompenses, les défis et/ou les éléments d'un jeu afin de créer l'expérience de jeu souhaitée.

L'équilibre du jeu est généralement compris comme l'introduction de l'équité pour les joueurs. Cela inclut

Ajuster la difficulté,
la modification des conditions de gain et de perte
Les états du jeu
l'équilibrage de l'économie.

Vous trouverez plus d'informations sur l'équilibrage des jeux sur Wikipédia.

L'utilisation de l'équilibrage du jeu en temps réel peut aider à maintenir l'engagement des joueurs, à faire en sorte que les nouveaux joueurs se sentent les bienvenus et, éventuellement, à monétiser le jeu.

Comment Illuminate peut-il vous aider à maintenir l'engagement de vos joueurs ?

Comme nous l'avons mentionné, Illuminate est un outil de prise de décision en temps réel. Pour aider nos joueurs à rester engagés, nous allons nous concentrer sur les nouveaux joueurs, ceux qui découvrent le jeu et qui ont potentiellement besoin d'aide pour s'habituer à la façon dont le jeu est joué.

Dans cet exemple, j'ai construit une copie à l'ancienne d'astéroïdes écrite en JavaScript et hébergée entièrement sur des fonctions PubNub. Pour en savoir plus sur les fonctions PubNub, consultez le site https://www.pubnub.com/docs/serverless/functions/overview.

Tout d'abord, plantons le décor.

Imaginez qu'un nouveau joueur rejoigne votre jeu et commence à jouer, il perd et commence à se lasser du manque de progression.

Via une publication, nous pouvons envoyer un message du jeu vers PubNub qui notifie Illuminate de la progression et du score du joueur, Illuminate prend quelques décisions basées sur des métriques prédéfinies et envoie ensuite un message à ce joueur lui offrant l'option d'acheter trois vies ou de regarder une promotion payée en échange de l'obtention de deux vies.

Passons en revue les écrans.

Le jeu commence normalement, mais comme vous pouvez le voir, je ne suis vraiment pas un grand joueur et je suis mort avec seulement 70 points.

Pour m'aider à continuer à jouer, Illuminate a reçu ce score et a calculé qu'il fallait m'offrir la possibilité d'acheter des vies ou de regarder une publicité pour obtenir des vies.

En choisissant de dépenser de l'argent, j'ai pu acheter des vies et me remettre rapidement dans le jeu.

Les coulisses d'Illuminate.

Vous trouverez Illuminate dans le portail de votre compte PubNub - https://admin.pubnub.com/, sous la rubrique "Optimize".

Notre première étape consiste à examiner nos Business Objects. Les objets d'affaires sont le moyen d'obtenir des données dans Illuminate, ils nous aident à définir quel type de données nous devons capturer et à partir d'où.

Vous pouvez définir quelles données vous voulez suivre en ajoutant des mesures et comment vous voulez segmenter ces données en ajoutant des dimensions.

Si vous avez besoin d'aide pour vous installer ou pour comprendre la configuration d'Illuminate, vous pouvez trouver la documentation ici: https://www.pubnub.com/docs/illuminate/basics

Pour équilibrer un jeu, il faut savoir ce que l'on veut suivre et ce que l'on veut offrir aux nouveaux joueurs pour qu'ils restent engagés.

Telle est la compétence d'Illuminate ; sans aucun codage, nous pouvons ajouter, supprimer ou modifier des variables pour affiner et même adapter ce que nous offrons aux différents joueurs.

Dans cet exemple simple, j'ai choisi de mesurer le score du jeu, mais vous pourriez facilement ajouter d'autres mesures ;

Le joueur est-il un invité ou a-t-il un compte sur votre plateforme de jeu ?
Durée totale du jeu
Type d'appareil - web, mobile, TV.
Ont-ils déjà acheté quelque chose chez vous lors d'événements ou de jeux antérieurs ?

Pour en revenir à mes objectifs commerciaux, permettez-moi de vous montrer les mesures avec lesquelles je travaille.

Voici ce que j'en pense :

Mesures : Valeurs numériques que l'on peut mesurer ou additionner.

Dimensions : Valeurs qualitatives qui peuvent être utilisées pour segmenter les mesures.

Métriques : L'agrégation de vos mesures segmentées par les dimensions que vous avez sélectionnées.

Décisions : Un ensemble de conditions et d'actions. Lorsque les conditions sont remplies, l'action correspondante est déclenchée.

Tableaux de bord : Une collection de graphiques en temps réel qui visualisent vos mesures et vos décisions.

Dans mon exemple, l'une des mesures que j'utilise est que le client demande de l'aide à Illuminate lorsque le score est inférieur à 500 points.

J'ai ensuite mis en correspondance cette mesure avec une décision : "Si un joueur a un score inférieur à 500 points, offrez-lui la possibilité d'acheter des vies ou de regarder une publicité."

Une fois que le joueur a choisi de regarder une publicité ou d'acheter des vies, cette décision est renvoyée sous la forme d'une mesure qui est ensuite affichée sur mon tableau de bord.

Voici une vue simplifiée de mon tableau de bord d'équilibrage des jeux. Vous pouvez voir que nous suivons les joueurs qui ont obtenu moins de 500 points et ceux qui ont choisi de payer leurs vies au lieu de regarder une publicité.

Là encore, il est possible d'accroître la complexité de la situation ;

Les joueurs seraient-ils plus nombreux à payer pour des vies supplémentaires si celles-ci étaient bon marché ?
Regarderaient-ils une publicité de 30 secondes ou de 3 minutes ?

Vs. l'approche traditionnelle ?

Les jeux de stratégie ? Jeux en ligne ? Équilibrer l'expérience et les mécanismes de jeu pour tous les joueurs peut être un processus long. Avant le lancement, vous testerez les différents éléments du jeu, élaborerez le didacticiel d'introduction et, sur la base du comportement des joueurs, veillerez à ce que la conception des niveaux soit progressive afin de maximiser le temps de jeu et d'éviter que le jeu ne soit trop facile. Après le lancement, vous pouvez surveiller les forums de joueurs, vérifier les données analytiques concernant les chiffres de rétention et les actions des joueurs, puis publier des correctifs pour résoudre les éventuels problèmes d'équilibre... en espérant que cela n'affaiblisse pas votre jeu dans le même temps !

Ce cycle d'analyse et de publication peut être très long, et c'est là qu'Illuminate peut vous aider. Vous pouvez prendre des décisions en temps réel, quel que soit votre type de jeu : Vous pouvez avoir un jeu multijoueur comme un FPS ou un RPG, un jeu de combat solo sur Steam ou une arène de combat comme League of Legends. Tant que le jeu vidéo est en ligne, où l'équilibre des joueurs peut être affecté en agissant dans l'instant, Illuminate peut améliorer l'expérience du joueur - j'ai demandé au PM, et ils disent que les jeux de table et les jeux de cartes ne sont pas encore sur la feuille de route :(

Récapitulation

Utiliser Illuminate de PubNub pour équilibrer votre jeu est un moyen rapide et sans code d'introduire des réactions et des outils de prise de décision instantanée dans votre application, ce qui rendra l'expérience de votre joueur excellente.

Pour en savoir plus sur la création de votre premier jeu avec des actions en temps réel, consultez notre page Illuminate pour les jeux et notre documentation. Notre équipe de support peut également vous aider avec des lignes directrices et des recommandations. Nous espérons vous voir à la prochaine conférence GDC, où nous serions ravis d'entendre ce que vous avez construit avec PubNub !

Comment PubNub peut-il vous aider ?

Cet article a été publié à l'origine sur PubNub.com

Notre plateforme aide les développeurs à construire, livrer et gérer l'interactivité en temps réel pour les applications web, les applications mobiles et les appareils IoT.

Découvrez PubNub

Découvrez le Live Tour pour comprendre les concepts essentiels de chaque application alimentée par PubNub en moins de 5 minutes.

S'installer

Créez un compte PubNub pour un accès immédiat et gratuit aux clés PubNub.

Commencer

La documentation PubNub vous permettra de démarrer, quel que soit votre cas d'utilisation ou votre SDK.

Suivi de la géolocalisation en JavaScript avec l'API Google Maps

PubNub Developer Relations — Fri, 31 May 2024 14:45:48 +0000

Voici l'article de blog mis à jour, avec tous les mots-clés intégrés de manière transparente.

Il s'agit de la conclusion de la série de quatre articles sur la création d'applications web en temps réel avec des fonctions de géolocalisation en utilisant l'API JavaScript de Google Maps et PubNub. Notre tutoriel vous guidera à travers l'expérience utilisateur de la génération de trajectoires de vol à l'aide de JavaScript et de PubNub.

Pour un exemple de mise en œuvre, consultez notre démo Showcase sur le site web de PubNub. Naviguez vers la démo Géolocalisation pour voir comment nous incorporons PubNub avec le suivi en temps réel. Pour le code derrière la démo, naviguez vers notre Github pour voir comment tout cela fonctionne.

Que sont les trajectoires de vol ?

Les trajectoires de vol, telles qu'elles sont mises en œuvre dans ce tutoriel, font référence aux polylignes qui permettent de dessiner dynamiquement des trajectoires à travers des points spécifiés par l'utilisateur sur une carte qui réside soit sur votre appareil mobile, soit sur votre navigateur web. Ils font partie intégrante de l'API de géolocalisation HTML5 et de l'API de Google Maps pour le suivi des mouvements.

Vue d'ensemble du tutoriel

Assurez-vous d'avoir rempli les conditions préalables des parties 1, 2 et 3, où nous avons mis en place notre environnement JavaScript et abordé les marqueurs de carte et le suivi de la localisation.

Une fois que vous l'avez fait, passez à la partie suivante.

Présentation du code

Commençons par définir les variables let\ map\, mark\, et lineCoords\ pour contenir nos objets map, marker, et polyline coords. En faisant cela, nous pouvons les ajuster au fur et à mesure que les événements PubNub arrivent. Ensuite, nous définissons le callback initialize\ qui est utilisable par l'API JavaScript de Google Maps lorsqu'elle est prête à être chargée. Assurez-vous de remplacer YOUR\_GOOGLE\_MAPS\_API\_KEY\ par votre véritable clé API.

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

Maintenant, avec le gestionnaire d'événement "redraw", nous allons mettre à jour les nouvelles informations de localisation à la volée en invoquant la méthode getCurrentPosition()\ de la géolocalisation.

Lat/Long

Ensuite, nous définissons un gestionnaire d'événement redraw que nous appellerons à chaque fois que nous recevrons un nouvel événement de changement de position à la volée. Dans la première partie de la fonction, nous fixons la latitude et la longitude aux nouvelles valeurs du message. Ensuite, nous invoquons les méthodes appropriées sur les objets carte, marqueur et polyligne pour mettre à jour la position, l'ajouter à la fin de la ligne et recentrer la carte.

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

Initialiser PubNub

Après avoir défini nos callbacks, nous allons initialiser la fonctionnalité de streaming de données en temps réel PubNub qui fonctionne sur les téléphones mobiles, les tablettes, les navigateurs et les ordinateurs portables à travers des piles technologiques comme iOS, Android, JavaScript, .NET, Java, Ruby, Python, PHP, et plus encore.

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

La fonctionnalité de PubNub permettant de publier et de s'abonner à des sujets dans des canaux en temps réel offre des capacités de flux de données efficaces.

Publier Lat/Long

Pour ce tutoriel simple, nous avons mis en place un minuteur d'intervalle JavaScript de base pour publier de nouvelles positions basées sur l'heure actuelle. Toutes les 500 millisecondes, nous invoquons la fonction de rappel anonyme qui publie un nouvel objet latitude/longitude (avec des coordonnées en mouvement vers le nord-est) sur le canal PubNub spécifié. Dans votre application, vous obtiendrez probablement la position d'un appareil en direct ou d'une position rapportée par l'utilisateur.

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

Enfin, nous initialisons l'API Google Maps à la toute fin pour nous assurer que les éléments DOM et les prérequis JavaScript sont satisfaits.

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

Récapitulation

Cette série de tutoriels nous a montré comment l'API Google Maps et PubNub fonctionnent exceptionnellement bien ensemble pour le suivi de la localisation en temps réel sur les applications web et mobiles. C'est similaire à la façon dont les services de covoiturage comme Uber et Lyft affichent le mouvement de leurs véhicules en temps réel.

Découvrez PubNub

Regardez le Live Tour pour comprendre les concepts essentiels derrière chaque application alimentée par PubNub en moins de 5 minutes. Découvrez l'expérience de nos utilisateurs directement à partir de notre page GitHub et des témoignages disponibles sur notre site web.

S'installer

Créez un compte PubNub pour un accès immédiat et gratuit aux clés PubNub.

Commencer

La documentation PubNub vous permettra d'être opérationnel, quel que soit votre cas d'utilisation. Nous avons des sections dédiées à l'API JavaScript Google Maps et comment les utiliser avec le suivi en temps réel dans notre SDK.

Explorer les cas d'utilisation des services cognitifs

PubNub Developer Relations — Fri, 31 May 2024 14:11:21 +0000

Passons en revue quelques exemples d'applications et d'entreprises transformées par les services cognitifs et quelques cas d'utilisation futurs pour voir à quel point ils changent le paysage technologique.

Grâce aux services cognitifs de géants du cloud comme AWS, IBM et Microsoft Azure, les équipes de développeurs de toutes tailles ont désormais accès à des services cognitifs d'une puissance stupéfiante. Fournis par le biais d'API, ces services permettent d'injecter facilement une intelligence de nouvelle génération dans les applications.

Chat et interaction sociale

En 2015, les utilisateurs actifs mensuels des applications de chat ont dépassé ceux des réseaux sociaux, et le fossé continue de se creuser. En effet, la messagerie est devenue un élément essentiel des réseaux sociaux eux-mêmes. Avec cette croissance rapide, les applications de messagerie ont évolué, passant de simples outils pour envoyer et recevoir de courts messages textuels à des expériences innovantes et complètes, dotées de fonctions surprenantes et agréables. Les API cognitives sont le moteur de cette innovation.

Chatbots et informatique cognitive

Les chatbots sont l'une des premières formes d'algorithmes d'IA. Même s'il est peu probable qu'ils réussissent bientôt le test de Turing, ils représentent l'évolution naturelle des applications à commande vocale. Alors qu'auparavant vous deviez appeler une ligne d'assistance et appuyer sur la touche 1 pour obtenir les comptes fournisseurs, vous pouvez désormais parler avec des phrases complètes à un système capable de discerner votre intention.

Que vous le sachiez ou non, l'adoption des chatbots a explosé car les entreprises cherchent à réduire les temps d'attente, à améliorer l'expérience client et à minimiser le coût des opérateurs téléphoniques humains. Pour l'instant, ils sont principalement utilisés pour gérer des tâches simples : comprendre les demandes de base et y répondre en fonction de règles prédéfinies, en répondant à des questions telles que "Où en est ma commande ?" ou "Chatbot, allume les lumières d'ambiance".

Cependant, des API telles que Watson Assistant ou Amazon Lex facilitent la création de services capables d'appliquer une logique aux modèles observés dans ces demandes en langage naturel. Ces services peuvent, par exemple, observer un afflux soudain d'appels provenant d'un aéroport souffrant de retards de décollage et modifier la séquence d'options pour donner la priorité à la reprogrammation des vols. Ils peuvent aussi constater que les appels en provenance d'un pays ou d'une région particulière ont tendance à être passés dans une langue différente et modifier les options par défaut en conséquence. Ils peuvent même identifier des schémas grammaticaux qui indiquent aux clients qu'ils doivent immédiatement transmettre leur appel à un superviseur.

Les interfaces conversationnelles intelligentes utilisant la reconnaissance vocale, la synthèse vocale, la reconnaissance faciale et les modèles d'apprentissage automatique peuvent offrir des expériences très attrayantes et des conversations réalistes à des fins diverses. Mieux encore, elles tireront des enseignements de ces expériences.

Les chatbots changeront notre façon de faire des opérations bancaires, des achats et d'apprendre : ils feront des recommandations, comprendront des concepts abstraits et apprendront à connaître les individus en se basant sur leurs expériences antérieures. À terme, ils deviendront si performants que vous ne saurez même plus si vous parlez à un humain.

Exemple de code : Chatbot sur la domotique

En utilisant Watson et PubNub ChatEngine, vous pouvez facilement créer un chatbot doté d'une intelligence artificielle qui contrôle votre maison intelligente.

Ce tutoriel vous montre comment construire un chatbot qui accepte des commandes textuelles, les analyse et prend des mesures en fonction de ces commandes. Par exemple, un utilisateur tape "allumer les lumières dans le salon" et le chatbot déclenche l'allumage des lumières.

{

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

Traitement du langage naturel

La science des données et le traitement du langage naturel (NLP), terme générique désignant les solutions d'IA capables de traiter avec succès de grandes quantités de données en langage naturel, constituent un autre domaine extrêmement important. Le NLP ne se contente pas d'évaluer les mots et la grammaire d'un point de vue sémantique, il peut aussi déceler les sentiments et les émotions, en découvrant ce que les utilisateurs pensent d'un sujet ou d'une question grâce à une analyse message par message.

La PNL est un avantage considérable pour les marques, les personnalités publiques et les organisations qui ont besoin de comprendre et de répondre aux opinions des utilisateurs à une époque où les réputations peuvent être faites ou défaites en l'espace de quelques minutes. Imaginons qu'une marque lance une nouvelle publicité pour un produit. En utilisant les services cognitifs appropriés, elle peut puiser dans un flux de médias sociaux sur un hashtag spécifique ou le nom du produit et demander à son API NLP d'analyser tous les messages pertinents et de fournir un retour d'information sur la façon dont le public réagit au produit.

Voici un exemple d'application conçue pour analyser et évaluer l'opinion des gens sur les politiciens américains sur Twitter. Elle surveille des mots-clés et des phrases spécifiques et peut ensuite représenter l'émotion des utilisateurs dans des régions géographiques définies.

Par exemple, si un utilisateur soumet le texte "Je suis heureux"...

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

Watson analyse le texte et renvoie l'information suivante :

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

Les marques consacrent déjà des sommes importantes à l'analyse des sentiments du marché. À mesure que ces systèmes deviendront plus intelligents, plus robustes et plus automatisés, ils seront en mesure de mieux comprendre le public à moindre coût.

Commerce électronique

Bien que les achats en ligne aient complètement changé la façon dont nous achetons des produits, il manque un élément essentiel aux magasins de type "brique et mortier" : des employés serviables. À l'échelle à laquelle les boutiques en ligne opèrent, il n'est pas économiquement viable d'avoir des personnes qui s'occupent du chat en direct.

C'est pourquoi de nombreux magasins en ligne se tournent vers des assistants d'achat intelligents pour optimiser l'expérience, aider les clients à répondre à leurs questions, leur faire des recommandations et même les aider à passer à la caisse.

Nordstrom a dominé les saisons des fêtes précédentes avec son chatbot Messenger, qui allait au-delà de simples questions et réponses prédéfinies et utilisait des services cognitifs pour comprendre réellement ce que le client recherchait et l'aider si nécessaire. Il proposait des recommandations de cadeaux et pouvait même aider à remplir la commande.

Les chatbots nous évitent également le redoutable appel téléphonique au service clientèle, où l'on doit attendre une heure pour qu'un représentant s'occupe d'un simple problème. Amazon a déployé des chatbots capables de résoudre les problèmes mineurs que rencontrent la plupart des clients lorsqu'ils ont besoin d'aide pour passer leur commande.

Maintenant que nous avons examiné quelques exemples d'intelligence dans le monde réel d'aujourd'hui, projetons-nous dans l'avenir et voyons comment les services cognitifs changeront notre monde à l'avenir.

Villes intelligentes

Les villes du futur s'appuieront sur divers services intelligents intégrés pour les rendre plus sûres, plus efficaces et plus respectueuses de l'environnement. La reconnaissance d'images, la vision par ordinateur et les API de vision joueront un rôle essentiel dans cette transformation, en traitant et en agissant sur les images dans l'espace urbain.

L'agriculture

La population mondiale continue de croître et nourrir ces milliards de personnes sera un défi considérable dans les années à venir. Les services cognitifs joueront un rôle essentiel dans la gestion des champs et des usines, nous permettant de prendre des décisions intelligentes et de contrôler les ressources avec une précision jamais atteinte auparavant.

Les fermes intelligentes et l'IdO intégreront autant de points de données précieux que possible pour prendre des décisions agricoles intelligentes, même celles qui semblent contre-intuitives. Par exemple, en agrégeant les données météorologiques en temps réel, les données des capteurs à distance et les performances historiques, les services cognitifs peuvent perfectionner le plan d'irrigation individuel et le mettre à jour en fonction des circonstances uniques de chaque jour.

Sécurité des données

Alors que nous sommes de plus en plus connectés et que nos vies numériques prennent le pas sur nos vies physiques, la confidentialité et la sécurité des données se transforment de quelque chose dont nous sommes vaguement conscients en une menace personnelle déconcertante et omniprésente.

Les réglementations et les règles - HIPAA, GDPR, SOC II - sont un moyen de s'assurer que les entreprises et les organisations ont mis en place les garde-fous appropriés. La mise en œuvre détaillée de ces réglementations complexes peut s'avérer lourde à gérer, et c'est là que l'apprentissage automatique entre en jeu.

Les services cognitifs peuvent être entraînés à comprendre et à donner un sens aux règles et aux réglementations, puis à suggérer des moyens de se mettre en conformité. Les services cognitifs permettent de fournir des informations précieuses sur la sécurité des données, depuis les règles et lois pertinentes jusqu'à la modération des contenus.

Soins de santé

L'innovation progresse généralement plus lentement dans le secteur de la santé que dans d'autres secteurs pour plusieurs raisons, notamment les marges étroites, la lourdeur de la réglementation et le cloisonnement de la recherche et du développement. Les services cognitifs offrent la possibilité de lever les obstacles à l'innovation et d'améliorer le système de prestation, depuis les organisations jusqu'aux patients.

Dans le secteur des soins de santé, la prise de décision se fait généralement de manière cloisonnée, patient par patient. Les services cognitifs, en revanche, analysent et agissent sur la base d'une vision globale des facteurs qui influencent la santé : le statut socio-économique, l'environnement, l'accès aux soins de santé, etc. Les services cognitifs peuvent recommander au médecin des soins de meilleure qualité et plus ciblés, y compris des programmes de santé et de bien-être.

Les services cognitifs peuvent favoriser l'intégration et la connexion des systèmes existants au sein des organismes de soins de santé et mettre au jour des informations essentielles. Soudainement capables d'agréger des données et de relier les besoins des parties prenantes, les organisations peuvent fournir de meilleurs soins tout en fonctionnant de manière plus efficace.

L'intelligence maintenant

Cet article n'a décrit qu'une infime partie de la manière dont les services cognitifs vont changer notre façon de concevoir l'entreprise et le rôle que les applications peuvent jouer. Dans le passé, les logiciels suivaient des instructions. Avec les services cognitifs, les solutions peuvent s'adapter, évoluer et accomplir des choses qui auraient pu sembler impossibles il y a seulement quelques années. Nous ne pouvons pas voir toutes les implications, mais d'après ce que nous savons, il ne fait aucun doute que l'impact sur les entreprises sera profond, positif et présent avant même que vous ne vous en rendiez compte.

Comment PubNub peut-il vous aider ?

Cet article a été publié à l'origine sur PubNub.com

Notre plateforme aide les développeurs à construire, fournir et gérer l'interactivité en temps réel pour les applications web, les applications mobiles et les appareils IoT.

Découvrez PubNub

Découvrez le Live Tour pour comprendre les concepts essentiels de chaque application alimentée par PubNub en moins de 5 minutes.

S'installer

Créez un compte PubNub pour un accès immédiat et gratuit aux clés PubNub.

Commencer

La documentation PubNub vous permettra de démarrer, quel que soit votre cas d'utilisation ou votre SDK.

Suivi en temps réel des commits sur le tableau de bord GitHub

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

Dans le domaine du développement logiciel, les graphiques C3.js en temps réel offrent un moyen efficace de surveiller l'activité au sein de votre organisation. Pour les équipes d'ingénierie, l'une des métriques à suivre est celle des commits GitHub. En explorant ce sujet, ce billet de blogue fournit un tutoriel pour vous guider à travers le processus d'utilisation de l'API de GitHub pour récupérer et afficher les données des commits GitHub dans un graphique interactif en temps réel. Nous utiliserons la puissance de HTML, Javascript, CSS, et utiliserons PubNub pour créer le tableau de bord GitHub et streamer les données de commit, tandis que C3.js aidera à la visualisation.

Pour en savoir plus sur les graphiques C3.js en temps réel, nous avons un excellent tutoriel. Maintenant, plongeons dans le vif du sujet !

Comment créer un tableau de bord GitHub en temps réel

Créer un tableau de bord GitHub en temps réel implique de se connecter à diverses sources de données telles que le dépôt GitHub et de s'occuper de certaines dépendances nécessaires. Soyez conscient des mesures de cybersécurité nécessaires, comme le codage sécurisé et le cryptage des données. Il est impératif de suivre les protocoles de sécurité standard de l'industrie.

Voici un guide étape par étape :

Ajouter un Webhook GitHub

Pour configurer le webhook, suivez les étapes suivantes :

Créez un dépôt GitHub ou utilisez un dépôt git existant.
Cliquez sur "Paramètres" sur le côté droit de la page.
Cliquez sur "Webhooks" sur le côté gauche de la page.
Cliquez sur "Add Webhook" en haut à droite.
GitHub vous demandera votre mot de passe, entrez-le.
Sous 'Payload URL', entrez : http://pubnub-git-hook.herokuapp.com/github/ORG-NAME/TEAM-NAME. Remplacez ORG-NAME par le nom de votre organisation et TEAM-NAME par l'équipe qui contrôle le repo.

Charger le tableau de bord visuel

Visitez cette page. Vous verrez une liste de tous les commits envoyés à travers le tableau de bord PubNub - super ! Lorsque vous envoyez un de vos commits sur GitHub, vous devriez voir un message apparaître sur votre tableau de bord des commits GitHub en quelques dizaines de millisecondes, et les graphiques se mettront à jour en temps réel.

Comment nous avons construit le tableau de bord des livraisons Github

Le tableau de bord est un mélange de GitHub, du réseau de flux de données PubNub et des visualisations graphiques D3 alimentées par C3.js. Lorsqu'un commit est poussé sur GitHub, les métadonnées du commit sont postées sur une petite instance Heroku qui les publie sur le réseau PubNub. Nous hébergeons une page de tableau de bord sur les pages GitHub.

Une fois que notre instance Heroku reçoit les données de validation de GitHub, elle publie un résumé de ces données sur PubNub en utilisant les clés publiques de publication/abonnement sur le canal pubnub-git. Vous pouvez surveiller le canal pubnub-git via notre console de développement ici.

Voici un exemple de message :

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

La deuxième partie de la magie se produit lorsque le tableau de bord reçoit ces informations par le biais de son callback subscribe. Si vous regardez la source du tableau de bord, vous verrez ce code :

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

});

Cet appel subscribe garantit que la fonction JavaScript displayLiveMessage() est appelée chaque fois qu'un message est reçu sur le canal pubnub-git. displayLiveMessage() ajoute la notification push de commit en haut du journal et met à jour les graphiques de visualisation C3.

Mais attendez, comment le tableau de bord est-il alimenté lorsqu'il est chargé pour la première fois ?

Tirer profit de l'API de stockage et de lecture de PubNub pour votre tableau de bord

PubNub conserve un enregistrement de chaque message envoyé, et fournit aux développeurs un moyen d'accéder à ces messages sauvegardés avec l'API Storage & Playback (History). Plus profondément dans le tableau de bord web, vous verrez le code suivant :

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

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

Il s'agit d'une requête visant à récupérer les 1 000 derniers messages envoyés sur le canal pubnub-git. Ainsi, même si le tableau de bord web était hors ligne lorsque ces messages ont été envoyés, il est capable de les récupérer et d'utiliser ces données pour alimenter le tableau de bord comme s'il était en ligne en permanence.

Cette fonctionnalité est particulièrement utile lorsqu'il s'agit d'appareils dont la connectivité est intermittente ou peu fiable, comme les applications mobiles sur les réseaux cellulaires ou les voitures connectées. Grâce au réseau PubNub, notre tableau de bord de visualisation ne nécessite pas de backend pour stocker l'état de l'application.

Création de votre propre tableau de bord GitHub

Pour commencer à construire votre tableau de bord Github, prenez le dépôt Git Commit UI sur github.com et suivez le README pour les instructions d'installation. Les demandes d'extraction sont les bienvenues dans le cadre de la collaboration avec la communauté open source.

Tendances et développements futurs en matière de tableaux de bord en temps réel

Il est essentiel de garder un œil sur les dernières tendances et évolutions en matière de tableaux de bord en temps réel et de technologies connexes. Cela inclut les websockets pour la transmission de données en temps réel, l'utilisation de notifications pour un aperçu immédiat, et l'utilisation de tableaux de bord en temps réel dans divers flux de travail.

L'expérience PubNub

PubNub a aidé de nombreux clients à réussir leurs applications en temps réel. Par exemple, le système de notifications en temps réel de LinkedIn...

S'installer

Créez un compte PubNub pour obtenir un accès immédiat et gratuit aux clés PubNub. Les dernières fonctionnalités disponibles dans votre compte PubNub incluent ...

Démarrer

Notre documentation complète sur PubNub vous permettra d'être opérationnel en un rien de temps, quel que soit votre cas d'utilisation ou votre SDK.

PubNub offre une plateforme conviviale pour améliorer votre expérience utilisateur. Nos services sont conçus en gardant à l'esprit les développeurs pour un processus d'intégration transparent.

N'oubliez pas que nous sommes là pour rendre votre parcours de développement en temps réel plus fluide et plus efficace. Configurez l'URL de votre charge utile et commençons !

La documentation officielle et les sources faisant autorité peuvent être référencées tout au long de l'article de blog pour confirmer la validité de l'information.

Comment PubNub peut-il vous aider ?

Cet article a été publié à l'origine sur PubNub.com

Notre plateforme aide les développeurs à construire, livrer et gérer l'interactivité en temps réel pour les applications web, les applications mobiles et les appareils IoT.

Découvrez PubNub

Découvrez le Live Tour pour comprendre les concepts essentiels de chaque application alimentée par PubNub en moins de 5 minutes.

S'installer

Créez un compte PubNub pour un accès immédiat et gratuit aux clés PubNub.

Commencer

La documentation PubNub vous permettra de démarrer, quel que soit votre cas d'utilisation ou votre SDK.

Comment modérer en toute sécurité le chat et les utilisateurs avec BizOps Workspace

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

Cet article fait partie d'une série d'articles qui traitent des capacités de gestion des données de PubNub, connues collectivement sous le nom de BizOps Workspace:

Comment gérer les utilisateurs et les canaux avec BizOps Workspace
Comment surveiller et modérer les conversations avec BizOps Workspace
Comment modérer en toute sécurité les conversations et les utilisateurs avec l'espace de travail BizOps

BizOps Workspace est un ensemble d'outils qui vous aide à gérer votre application. Cet article développe l'article précédent "Comment surveiller et modérer les conversations avec BizOps Workspace" pour montrer une application de chat sécurisée de bout en bout avec des capacités de modération manuelle, c'est-à-dire la capacité de surveiller les conversations en temps réel et de mettre en sourdine ou de bannir les utilisateurs.

Bien que cet article puisse être lu seul, je recommande fortement de lire l'article précédent "Comment surveiller et modérer les conversations avec BizOps Workspace" pour mieux comprendre le contexte des concepts discutés ici.

Qu'est-ce que le moniteur de canaux ?

Le moniteur de canaux permet aux modérateurs de chats de regarder des aperçus en direct des conversations qui se déroulent en temps réel sur plusieurs canaux. Si le modérateur repère quelque chose d'inquiétant, comme un utilisateur qui se comporte mal ou des messages offensants, il peut agir immédiatement pour résoudre le problème.

Le modérateur dispose d'une grande souplesse quant aux mesures à prendre :

Observer un utilisateur sans limiter ses droits d'accès
Modifier ou supprimer le message incriminé
Limiter la capacité de l'utilisateur à publier des messages(mettre en sourdine)
Limiter la capacité de l'utilisateur à lire ou à publier des messages(interdiction).

Toutes les fonctionnalités de la fonction "Surveiller" sont manuelles : examen manuel des messages, mise en sourdine manuelle des utilisateurs, etc. Cet article ne traite pas de la modération automatique.

Pour utiliser le Channel Monitor, vous devez avoir plusieurs fonctionnalités activées sur votre clé PubNub, en particulier le contexte de l'application et la persistance des messages au minimum. Pour plus de détails, veuillez consulter la section 'Keyset requirements for the Channel Monitor' dans l'article précédent.

Qu'est-ce que le PubNub Access Manager ?

Les*développeurs doivent se prémunir contre les utilisateurs qui tentent de contourner leur système de modération*, ce qui est possible grâce au gestionnaire d'accès PubNub.

Le gestionnaire d'accès vous permet de définir un ensemble de règles qui décrivent les permissions de l'utilisateur (ou des utilisateurs) spécifié(s) et les actions qu'il(s) peut(vent) effectuer sur les ressources spécifiées. Par exemple :

L'utilisateur dont l'ID est 123 a le droit de lire et d'écrire sur le canal 456.
Tous les utilisateurs dont l'ID correspond à l'expression régulière user-* peuvent lire sur n'importe quel canal dont l'ID correspond à l'expression régulière global-*.
L'utilisateur ayant l'ID 123 a le droit de mettre à jour les métadonnées du canal (c'est-à-dire le contexte de l'application).

Pour une liste complète des permissions, veuillez vous référer à la documentation à l'adresse https://www.pubnub.com/docs/general/security/access-control#permissions.

PubNub Access Manager est basé sur des jetons, et la façon la plus simple de le décrire est de parcourir le flux d'autorisation tel qu'il est montré dans la documentation et de fournir un contexte supplémentaire sur la façon dont ce flux est lié à la modération :

Tentative de connexion. Votre client s'authentifie auprès de votre serveur pour connecter vos utilisateurs à votre application. Après cette étape, votre serveur est certain de parler à un utilisateur enregistré de l'application et de savoir qui il est. Le client demande un jeton d'authentification PubNub Access Manager dans le cadre de son initialisation.
Demande d'autorisation. Le serveur traite la demande de jeton du client en invoquant l'API SDK 'grantToken()'. Quelques points à noter à propos de cette API : Elle ne peut être appelée qu'avec la clé secrète PubNub et, par conséquent, ne peut être invoquée qu'à partir d'un serveur ; elle est disponible pour tous nos SDK côté serveur ; et cette API acceptera des objets JSON pour définir les ressources et les permissions qui définissent l'accès de l'utilisateur (ou des utilisateurs).
Jeton retourné. PubNub accorde les permissions demandées à l'utilisateur ou aux utilisateurs demandés et renvoie un jeton d'authentification au serveur.
Jeton*transmis*. Votre serveur renvoie ensuite le jeton d'authentification au client demandeur initial.
Jeton défini. Le client peut spécifier ce jeton d'authentification lors de son initialisation ou à n'importe quel moment du cycle de vie de l'application grâce à la méthode setToken(). Il est essentiel de pouvoir mettre à jour le jeton à tout moment car les jetons expirent, mais un client devra également demander un nouveau jeton si le Channel Monitor met à jour ses autorisations (c'est-à-dire s'il est mis en sourdine ou banni).
Demande d'API autorisée. Tout appel ultérieur à PubNub sera désormais considéré comme autorisé. PubNub autorisera ou refusera toute demande d'API en fonction des permissions accordées à l'étape 2 et de la validité du jeton du client.

A quoi ressemble une solution de modération sécurisée ?

Vers la fin de l'article précédent, j'ai montré une démonstration de ce à quoi ressemblerait l'inhibition ou le bannissement du côté du client. Le SDK Chat contient des événements de modération qui indiquent à un client s'il a été mis en sourdine ou banni ; cependant, à part la mise à jour de l'interface utilisateur, cela n 'empêche pas le client de continuer à envoyer des messages même s'il a été mis en sourdine ou banni. Pour sécuriser la mise en sourdine ou le bannissement du client, vous devez révoquer les autorisations existantes du gestionnaire d'accès et lui en accorder de nouvelles pour refléter son nouveau statut de mise en sourdine ou de bannissement.

Prenons le scénario suivant : un utilisateur est mis en sourdine du canal "Musiques" :

Un utilisateur peut accéder à deux canaux, "films" et "comédies musicales", mais l'administrateur souhaite lui interdire l'accès au seul canal "comédies musicales".
Le modérateur coupe le son de l'utilisateur à l'aide du moniteur de canaux. En clair, il invoque l'API "setRestrictions()
L'application serveur reçoit la notification "mute" par le biais d'un événement de modération et révoque le jeton d'accès existant de l'utilisateur.
L'application cliente reçoit la notification "mute" associée au canal "musicals" par le biais d'un événement de modération.
L'application met à jour son interface utilisateur pour empêcher l'envoi d'autres messages. L'utilisateur peut contourner ce changement d'interface en modifiant le code JavaScript de la page, mais toute tentative d'envoi de messages échouera puisque son jeton d'authentification a été révoqué.
L'application demande un nouveau jeton d'authentification au serveur, comme décrit dans la section Gestionnaire d'accès ci-dessus. Le nouveau jeton d'authentification reflète les nouvelles autorisations de l'utilisateur, qui n'a plus que l'accès "lecture" au canal "comédies musicales".

L'article précédent décrivait les "Composants d'une solution de modération" et dressait la liste des API disponibles pour le client et le serveur à l'aide du graphique ci-dessous. Les API dont il est question dans les étapes ci-dessus sont également indiquées dans ce graphique.

L'exemple d'application Chat SDK

La même équipe d'ingénieurs chargée de développer le Channel Monitor et le Chat SDK a également créé un exemple d'application écrit en React Native qui utilise le Chat SDK.

L'exemple montre les capacités du SDK et les meilleures pratiques pour développer une application de chat réaliste et complète à l'aide de PubNub. Il est open source et fait partie du même dépôt GitHub qui contient le Chat SDK sous /samples/react-native-group-chat.

Cette application a récemment été mise à jour pour demander des jetons à un serveur Access Manager et pour demander un nouveau jeton lorsque les permissions de l'utilisateur changent, c'est-à-dire lorsqu'il est banni ou mis en sourdine d'un canal. Cette amélioration a été apportée depuis la rédaction de l'article précédent, alors assurez-vous d'obtenir la dernière source sur GitHub. Au moment de la rédaction de cet article, l'ID du commit git le plus récent est ae9dfa0.

Sécuriser la mise en sourdine et le bannissement des utilisateurs : Démonstration à l'aide de l'exemple d'application

Cette section décrit comment mettre en œuvre notre démo de bout en bout, en montrant la modération sécurisée du point de vue du client et du serveur.

Créer un jeu de clés PubNub

Je recommande de créer un nouveau jeu de clés PubNub pour exécuter cette démo comme suit :

Connectez-vous au portail d'administration et créez une nouvelle application ou un nouveau jeu de clés dans une application existante. Si nécessaire, vous pouvez trouver des instructions étape par étape sur notre page Comment créer des jeux de clés sur le portail d'administration.
Sur la page des jeux de clés, activez les options de configuration suivantes. Vous pouvez accepter les valeurs par défaut, sauf indication contraire :

App Context. Il stocke des métadonnées sur vos canaux et vos utilisateurs et est décrit plus en détail dans l'article précédent sur la"Gestion des utilisateurs et des canaux". Activez également les événements de métadonnées d'utilisateur, les événements de métadonnées de canal et les événements d'adhésion.
Persistance des messages. Ceci stocke l'historique de vos messages avec PubNub afin que l'administrateur puisse revoir et éditer les conversations.
Gestionnaire d'accès. Empêche l'accès non autorisé aux données et est nécessaire pour créer une solution de modération sécurisée.
Présence. Utilisé pour savoir si un utilisateur est en ligne ou hors ligne.

Enregistrez vos modifications.

Vous aurez besoin de la clé de publication, de la clé d'abonnement et de la clé secrète dans les étapes suivantes.

Créer l'exemple d'application

Comme décrit précédemment, l'application Chat SDK Sample est une application client multiplateforme écrite en React Native à l'aide du framework Expo.

Clonez et construisez l'application exemple en suivant les instructions données dans le readme de l'application. En particulier, assurez-vous que les prérequis sont installés, y compris yarn et Node.js. Le ReadMe parle d'utiliser XCode et iOS, mais vous pouvez également exécuter l'application sur un émulateur Android. Au moment où j'écris ces lignes, l'ID du commit git le plus récent est ae9dfa0.

Lorsque vous fournissez les clés Pub/Sub, utilisez les clés que vous avez générées à l'étape précédente. Si vous n'incluez pas les clés dans le fichier .env, l'application utilisera par défaut des clés de démonstration; vous pouvez désactiver cette logique à l'adresse https://github.com/pubnub/js-chat/blob/ae9dfa0/samples/react-native-group-chat/App.tsx#L60 pour éviter toute confusion.

Exécutez l'application. Le ReadMe vous indiquera de lancer yarn ios, mais vous pouvez également lancer yarn android ou yarn run start, ce dernier vous donnant un menu interactif.

Lorsque vous vous connectez, vous devriez voir l'avertissement suivant dans votre console :

C'est parce que le client n'a pas réussi à se connecter au serveur Access Manager, alors construisons-le.

Construire le serveur d'exemple de gestionnaire d'accès

L'exemple de serveur de gestion d'accès peut être trouvé à https://github.com/pubnub/js-chat/tree/master/samples/access-manager-api, c'est la même monorepo que l'application client discutée précédemment.

Ouvrez le fichier src/chatsdk.service.ts dans l'éditeur de votre choix et remplissez les champs publishKey, subscribeKey et secretKey. Les clés de publication et de souscription doivent correspondre à celles que vous avez utilisées pour construire l'application cliente, et la clé secrète est disponible depuis la page du jeu de clés de l'application sur le portail d'administration.

Depuis le répertoire REPO/samples/access-manager-api, exécutez yarn run start pour démarrer le serveur Access Manager, et vous devriez voir quelque chose comme ci-dessous :

Pour voir ce que fait le serveur Access Manager, regardez app.service.ts. Vous y verrez les structures de permission générées pour l'utilisateur demandeur et l'appel à chat.sdk.grantToken() pour appliquer ces permissions, renvoyant l'authKey générée au client appelant.

Il s'agit des permissions requises par l'application de démonstration, mais votre application aura probablement besoin de permissions différentes. Vous pouvez utiliser ce jeu de règles comme modèle de départ, mais lorsque vous créez le serveur Access Manager pour votre application, consultez https://www.pubnub.com/docs/chat/chat-sdk/build/features/users/permissions pour comprendre exactement quelles autorisations sont nécessaires pour quelles fonctionnalités du Chat SDK.

Relancez l'application client de démonstration et vous devriez maintenant pouvoir vous connecter sans erreur. Vous saurez que tout s'est bien passé lorsque vous obtiendrez un toast "Authkey refreshed".

Entamez une conversation entre deux clients.

Couper le son et bannir les utilisateurs à l'aide du moniteur de canaux

Important : si vous n'avez pas encore initié une conversation entre deux clients, faites-le maintenant. Les canaux sont créés dynamiquement par l'application de démonstration et ne s'affichent donc dans le moniteur de canaux qu'après le début de la conversation.

Notez que les mises à jour de l'interface utilisateur présentées ci-dessous, telles que la bannière "clé d'authentification rafraîchie" ou la fenêtre modale "utilisateur interdit", font partie de l'application de démonstration - votre application affichera ces informations à l'utilisateur par le biais de sa propre interface utilisateur.

Lancez le Channel Monitor en vous connectant au portail d'administration et en sélectionnant le jeu de clés que vous avez utilisé pour l'échantillon d'Access Manager et l'application client.
Allez à la section BizOps Workspace dans le panneau de navigation de gauche, et sélectionnez Channel Monitor. Si vous ne voyez pas la section BizOps Workspace, vous devez certainement mettre à niveau votre plan PubNub, mais n'hésitez pas à contacter notre support si vous avez des problèmes.
Vous serez invité à sélectionner vos canaux pour commencer la modération. Le nom du canal sera 1:1 user with USER_ID, où USER_ID est le nom d'utilisateur de la personne qui a initié la conversation.
Les messages du canal seront affichés en temps réel, y compris les messages précédents, si la persistance est activée sur votre clavier.

Mettez l'utilisateur en sourdine en appuyant sur le bouton du microphone situé à côté d'un message envoyé par cet utilisateur. Un message s'affiche sur l'appareil de l'utilisateur en sourdine pour l'informer que la clé d'authentification a été actualisée. Si vous tentez d'envoyer un message en tant qu'utilisateur en sourdine, vous verrez apparaître une boîte de dialogue indiquant que cette opération est interdite, bien que l'utilisateur en sourdine n'en soit pas affecté.

Rétablissez le son de l'utilisateur en appuyant à nouveau sur le bouton du microphone. Un message s'affiche sur l'appareil de l'utilisateur non mutique, vous informant que la clé d'authentification a été actualisée et que l'envoi de messages est désormais possible.

Bannissez l'utilisateur en appuyant sur le bouton de bannissement situé à côté du message envoyé par cet utilisateur et indiquez le motif du bannissement. Le motif est un texte libre, vous pouvez donc fournir toute information pertinente. La clé d'authentification sera rafraîchie et l'utilisateur sera renvoyé à l'écran de sélection du chat dans son application.

Si l'utilisateur tente d'accéder au canal banni, il recevra un message d'erreur :

Débanquez l'utilisateur en sélectionnant "Remove ban" sur le Channel Monitor. La clé d'authentification sera actualisée. L'utilisateur sera débanni et pourra à nouveau accéder à la discussion.

Résumé

Le développement d'une application de chat n'est que la première étape. Les défis les plus difficiles se présentent après le déploiement de cette application pour soutenir votre base d'utilisateurs croissante. BizOps Workspace est un ensemble d'outils conçus pour gérer tous les aspects de votre application de chat, simplifiant ainsi les défis postérieurs au lancement.

Bien que cet article se soit concentré sur la mise en sourdine et le bannissement d'utilisateurs en toute sécurité, nous continuons à développer les fonctionnalités de BizOps Workspace. Cet article s'est également concentré exclusivement sur le SDK Chat, mais le Channel Monitor peut également être configuré pour fonctionner avec n'importe lequel de nos SDK.

Si vous avez besoin d'aide ou de soutien, n'hésitez pas à contacter notre équipe de soutien spécialisée ou à envoyer un courriel à notre équipe de relations avec les développeurs à l'adresse devrel@pubnub.com.

Comment PubNub peut-il vous aider ?

Cet article a été publié à l'origine sur PubNub.com

Notre plateforme aide les développeurs à construire, fournir et gérer l'interactivité en temps réel pour les applications web, les applications mobiles et les appareils IoT.

Découvrez PubNub

Découvrez le Live Tour pour comprendre les concepts essentiels de chaque application alimentée par PubNub en moins de 5 minutes.

S'installer

Créez un compte PubNub pour un accès immédiat et gratuit aux clés PubNub.

Commencer

La documentation PubNub vous permettra de démarrer, quel que soit votre cas d'utilisation ou votre SDK.

Comment ajouter un chat en temps réel à votre jeu Unity

PubNub Developer Relations — Thu, 16 May 2024 21:29:53 +0000

Le chat en temps réel ou le chat dans le jeu augmente l'engagement des joueurs et favorise la fidélisation des utilisateurs. Le chat en temps réel permet aux joueurs de communiquer entre eux, ce qui favorise le sentiment d'appartenance à une communauté et offre une plateforme d'interaction sociale qui rend l'expérience de jeu plus agréable.

Intégrer le chat en temps réel est plus facile à dire qu'à faire. Si l'on part de zéro, il faut beaucoup de ressources pour construire, maintenir et faire évoluer le système lorsque le nombre de joueurs augmente. Heureusement, PubNub a rendu plus facile que jamais l'injection de fonctionnalités en temps réel dans les jeux Unity grâce à notre plateforme API en temps réel et à faible latence. Que vous développiez pour Windows, Mac, iOS, Android, des systèmes de réalité virtuelle tels qu'Oculus et Meta Quest, ou que vous soyez multiplateforme, notre SDK Unity vous couvre.

Continuez à lire pour apprendre comment ajouter un chat en temps réel à votre jeu vidéo Unity avec PubNub, en commençant par comprendre comment configurer différents modèles de canaux, apprendre comment envoyer/recevoir des messages, puis améliorer/sécuriser votre chat dans le jeu avec d'autres fonctionnalités telles que la modération, les emojis, les réactions et les GIFs.

Démarrer avec PubNub

Avant de commencer à comprendre comment mettre en place votre chat dans le jeu, vous devez comprendre la plateforme PubNub et comment configurer votre application pour profiter des fonctionnalités de la plateforme.

Vue d'ensemble

PubNub est basé sur le modèle Pub/Sub (Publier/S'abonner). Un utilisateur publie un message, qui est essentiellement une charge utile contenant toutes les informations pertinentes, sur le réseau PubNub. Les utilisateurs qui souhaitent recevoir ou écouter le message s'abonneront au réseau PubNub et analyseront le message. Le message peut contenir tout ce que vous voulez, tant qu'il ne dépasse pas 32 Ko (et de préférence en JSON).

Pour s'assurer que le message parvient aux bons destinataires, des canaux sont utilisés comme mécanisme de transmission des données d'un appareil à l'autre. Les canaux sont nécessaires chaque fois qu'un appareil souhaite publier et s'abonner au réseau PubNub. Alors qu'un utilisateur ne peut publier qu'un seul message à la fois, un utilisateur peut s'abonner à plusieurs canaux différents à la fois, en écoutant un assortiment de messages.

Alors que vous devez spécifier le nom exact du canal lorsque vous publiez un message, vous pouvez vous abonner à plusieurs canaux à la fois via le multiplexage, qui consiste à s'abonner à un ou plusieurs canaux en fournissant les noms des canaux sous la forme d'un tableau de chaînes de caractères.

Pourquoi ces informations sont-elles nécessaires ? L'ensemble de votre système de messagerie dans le jeu sera basé sur le concept des canaux : la façon dont vous formatez et sécurisez le nom du modèle de canal détermine le type de chat que vous souhaitez.

Installer et configurer le SDK PubNub Unity

Pour commencer, vous devrez configurer le SDK Unity de PubNub pour connecter votre application au réseau PubNub. Veuillez vous référer à la documentation du SDK Un ity pour plus de détails, mais à titre indicatif, vous devrez :

Ajouter le package Unity via le Package Manager.
Créer un compte PubNub gratuit et obtenir vos clés PubNub. Il est essentiel d'activer les fonctionnalités de votre jeu de clés dont votre application a besoin - pour la fonctionnalité essentielle Pub/Sub, vous aurez simplement besoin d'activer Stream Controller. Nous nous assurerons de couvrir tous les autres paramètres que vous pourriez avoir besoin de configurer pour les fonctionnalités avancées.
Fournissez à Unity les clés de publication et d'abonnement que vous avez obtenues à l'étape précédente pour configurer le GameObject PubNub. Vous devez également fournir un UserId, car chaque objet PubNub a besoin d'un identifiant unique pour établir une connexion avec PubNub. Une fois cela fait, initialisez l'objet PubNub :

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

Ajoutez des récepteurs d'événements pour que votre jeu réagisse aux événements et aux messages. Il existe différents écouteurs d'événements permettant d'implémenter une logique personnalisée pour répondre à chaque type de message ou d'événement, mais pour la fonctionnalité principale d'échange de messages de chat, vous aurez simplement besoin de l'écouteur d'événements Message (vous apprendrez comment ajouter des fonctionnalités supplémentaires à votre chat en temps réel pour le rendre plus attrayant plus loin dans ce guide) :

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

Avant de commencer à publier pour envoyer des messages à d'autres appareils et à vous abonner pour recevoir des messages des éditeurs, vous devez définir le nom de votre canal. N'oubliez pas : la façon dont vous mettez en forme votre modèle de canal détermine le type de chat que vous souhaitez mettre en œuvre.

Définition des différents modèles de chat

Vous devrez réfléchir aux types de chat que vous devrez mettre en place pour votre jeu. Cette section traite du modèle de canal à suivre, et non de l'ensemble de la configuration permettant d'obtenir les informations requises de la part de votre jeu ou de vos utilisateurs. Si vous souhaitez voir les différents modèles de chat dans un projet Unity qui utilise PubNub, consultez notre Unity Showcase Game.

Chat global

Le chat global permet à tous les joueurs d'un jeu de communiquer entre eux. Vous pouvez mettre en place un chat général en publiant et en vous abonnant à des messages sur un canal commun auquel tous les joueurs sont abonnés. Vous pouvez configurer la structure du canal pour les joueurs globaux :

string allChat = “global”;

Chaque client s'abonne alors au canal et veille à ce que tout le monde reçoive les mêmes messages en temps réel, créant ainsi une expérience de discussion partagée à laquelle tout le monde peut participer.

Chat privé/chuchotage

Le chat privé ou chuchotage permet aux joueurs d'avoir des conversations en tête-à-tête, où seuls les deux joueurs concernés peuvent discuter entre eux et personne d'autre. Dans un modèle de canal de chat privé ou chuchotage, chaque utilisateur s'abonne à une structure de canal destinée aux conversations privées :

string privateChatBase= “chat.private.*”;

Cette structure utilise le concept de Wildcard Subscribe. Cette fonctionnalité peut être utilisée pour s'abonner à une liste hiérarchique de canaux, ce qui permet de s'abonner à de nombreux canaux avec une seule déclaration de nom.

Par exemple, lorsqu'un utilisateur est sur le point d'envoyer un message privé à un autre utilisateur, vous devez concaténer l'ID utilisateur PubNub actuel (ou UUID/uuid), qui représente l'identifiant unique permettant d'identifier l'utilisateur dans le réseau PubNub, et l'ID utilisateur du destinataire du message. Bien que vous puissiez toujours obtenir l'ID utilisateur de l'utilisateur actuel (via pubnub.GetCurrentUserId()), vous devez obtenir l'ID utilisateur du destinataire prévu. Une fois que vous avez l'ID utilisateur du destinataire, vous pouvez concaténer le canal comme suit :

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

Puisque vous spécifiez un motif de canal joker comme chat.private.*, votre application s'abonnera à tous les noms de canaux qui correspondent à ce motif. Ainsi, vous n'avez pas besoin de connaître le nom du canal au moment de l'exécution. Enfin, l'utilisation des identifiants d'utilisateur garantit que le nom du canal est unique et que la conversation reste entre les deux utilisateurs.

Chat entre amis

La création d'une discussion entre amis permet aux joueurs de communiquer en privé avec des joueurs spécifiques avec lesquels ils souhaitent établir une connexion plus étroite, qu'il s'agisse de joueurs nouvellement rencontrés ou d'amis en dehors du jeu.

Dans une discussion entre amis, vous devez créer un modèle de canal unique pour chaque appareil ou joueur, de la même manière que vous construisez un modèle de canal de discussion privée en y ajoutant votre identifiant d'utilisateur :

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

Vous devez ensuite répéter cette opération pour chaque utilisateur avec lequel vous souhaitez être ami : vous devez remplacer leur ID utilisateur dans la chaîne chanFriendChat par celui de pubnub.GetCurrentUserId(). Bien que vous ayez maintenant le modèle de canal en place, vous ne pouvez pas simplement vous abonner en utilisant un motif joker tel que chat.friends.* ; au lieu de cela, vous aurez besoin d'un mécanisme pour déterminer quels joueurs sont amis.

Une solution à ce problème est le groupe de canaux de PubNub, qui vous permet de gérer un grand nombre de canaux à la fois. Les groupes de canaux sont essentiellement un pointeur vers une liste de canaux ; dans ce cas, le groupe de canaux est unique au joueur et contient une référence à tous les amis du joueur :

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

Remarque : les noms des groupes de chaînes suivent les mêmes conventions que les noms de chaînes, mais ils ne peuvent pas contenir de points dans leur nom, d'où la différence de structure.

Comme pour l'abonnement aux chaînes avec l'objet pubnub (expliqué dans la section suivante), vous pouvez également vous abonner aux groupes de chaînes en même temps. Cela signifie que puisque le joueur est abonné à son groupe de canaux d'amis, chaque fois qu'un nouvel ami est ajouté, le chanFriendChat de cet ami est ajouté au groupe de canaux d'amis du joueur et recevra des messages dans l'écouteur d'événements Message chaque fois que l'un de ces canaux publiera un message. Bien que vous ne puissiez pas publier dans un groupe de canaux, vous pouvez simplement publier un message dans n'importe quel canal affilié au groupe de canaux et chaque abonné (ami) recevra ce message.

En utilisant l'API Channel Groups pour le SDK PubNub Unity, vous pouvez ajouter, lister et supprimer des amis/canaux des Channel Groups pour lesquels vous avez l'autorisation de le faire. La fonction Groupes de canaux est également utilisée pour déterminer quand les amis sont également en ligne/hors ligne, ce qui est connu sous le nom de Présence. Ce point sera abordé en détail dans notre guide Comment ajouter une liste d'amis dans Unity.

Chat de guilde/d'alliance/de plan

Dans les jeux comportant des guildes, des alliances ou des clans, un environnement de discussion dédié peut grandement favoriser la coordination et la camaraderie au sein de l'équipe. Ce type de chat de groupe permet la communication entre plusieurs utilisateurs, ce qui favorise la collaboration et le travail d'équipe entre un plus grand nombre de joueurs que vos seuls amis. Un chat Guilde/Alliance/Clan permet aux membres d'un même groupe de planifier des stratégies, de partager des succès, ou simplement de se rapprocher pour former une communauté plus personnelle au sein du jeu.

La mise en place de ce type de chat avec PubNub se fait de la même manière que pour le Friend/Buddy Chat. Vous devez créer des groupes de canaux pour chaque type, vous abonner à ces groupes de canaux et ajouter des amis à ces groupes de canaux lorsque vous y êtes autorisé. Tout message publié sur un canal associé à ces groupes de canaux déclenchera l'écoute de l'événement et vous pourrez afficher le chat de manière appropriée.

Les groupes de canaux sont un excellent moyen de gérer de grands groupes, car le groupe de canaux de chaque joueur peut gérer 2 000 canaux (dans ce cas, des joueurs), ce qui est plus que suffisant pour les plus grandes guildes des jeux en ligne massifs. Mieux encore, chaque client individuel connecté au réseau PubNub peut avoir 10 groupes de canaux, ce qui signifie que vous pouvez vous abonner à 20 000 canaux si nécessaire.

Chat Party/Lobby

Les chats de groupe ou de lobby s'adressent à de petits groupes temporaires formés pour une session de jeu ou une mission particulière. Bien que ces styles de discussion aient des objectifs différents, leur mise en œuvre est similaire au modèle de création d'un canal de discussion privé/chuchoté.

Tout d'abord, créez une chaîne de base pour chacun des types de chat de groupe. Lorsque vous vous abonnez à votre tableau de canaux (voir l'étape suivante), vous utilisez le caractère générique subscribe pour écouter toutes les requêtes :

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

Lorsque le lobby ou la partie est formé, un joueur est désigné comme le leader ou le propriétaire du groupe, qu'il ait initié le groupe ou qu'il ait été déterminé en fonction de sa connexion Internet et de sa région. Ces types de joueurs sont appelés chefs de partie ou hôtes. Vous concaténerez alors l'ID utilisateur du joueur hôte avec une chaîne de base, créant ainsi un modèle de canal unique. Tout nouveau joueur invité à rejoindre la partie ou le lobby s'abonnera dynamiquement à ces canaux, ce qui lui permettra de rejoindre le groupe. Le canal peut ensuite être supprimé une fois la fête ou le lobby terminé ou dissous.

Mise en place de l'ensemble

Une fois que vous avez déterminé les types de discussion que vous souhaitez intégrer à votre jeu en fonction du modèle de canal, il est temps d'envoyer et de recevoir des messages en temps réel en publiant et en vous abonnant à ces canaux.

Publier des messages

Le processus commence par l'élaboration de la charge utile du message. Il peut s'agir d'un simple chat textuel ou de structures de données plus complexes, en fonction des besoins de votre jeu Unity. Une fois que la charge utile est prête, il est temps de publier le message.

L'API de publication est utilisée pour envoyer un message à tous les abonnés du canal de discussion spécifié. Bien que vous ne puissiez publier que sur un seul canal à la fois, la publication est effectuée de manière asynchrone, de sorte qu'elle ne bloque pas l'exécution du reste de votre code (bien que vous puissiez toujours publier de manière synchrone si vous le souhaitez).

Par exemple, si vous souhaitez envoyer un message de chat à la partie, vous devez effectuer l'appel suivant pour non seulement publier, mais aussi déterminer si l'appel PubNub a été effectué avec succès (et gérer l'échec de l'appel) :

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

S'abonner aux messages

Lorsque des messages sont publiés, nous devons nous abonner aux canaux appropriés pour recevoir tous les messages et événements entrants. Vous pouvez vous abonner à plusieurs canaux de discussion et groupes de canaux en un seul appel :

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

Le lecteur est maintenant connecté au réseau PubNub et les auditeurs d'événements attendent qu'un événement se produise (dans ce cas, l'arrivée d'un nouveau message) et exécutent ensuite le code associé à cet événement.

Lorsqu'un message arrive, l'écouteur déclenche un rappel, exécutant le code que vous avez écrit pour gérer les messages entrants. Il peut s'agir simplement d'afficher le message dans un salon de discussion, ou de quelque chose de plus complexe, comme le déclenchement d'événements dans le jeu en fonction des messages de discussion.

Fonctionnalités avancées pour rendre le chat dans le jeu attrayant

Vous avez réussi à intégrer le chat dans votre jeu Unity pour permettre aux joueurs d'envoyer et de recevoir des messages en temps réel ! Bien que cela crée déjà un espace pour que les joueurs s'engagent les uns avec les autres, la fonctionnalité mise en œuvre n'est que la partie émergée de l'iceberg - il y a beaucoup de fonctionnalités que vous devriez envisager d'implémenter pour rendre les chats en jeu plus engageants pour vos joueurs.

Charger l'historique des messages : Persistance des messages

Dans un jeu, les joueurs peuvent avoir besoin de revenir sur des conversations antérieures ou de rattraper des chats manqués. C'est là qu'intervient la persistance des messages, qui permet de sauvegarder et de récupérer l'historique des messages de chat. La mise en œuvre de l'API de persistance des messages dans votre jeu Unity vous permet de stocker et de récupérer les messages de chat, les actions de message et les fichiers en cas de besoin :

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

Nous offrons également la possibilité de contrôler la durée de stockage des messages, ce qui vous permet de gérer le stockage en fonction des besoins et des ressources spécifiques de votre jeu. Pour pouvoir utiliser la persistance des messages, vous devez activer la fonctionnalité dans le portail d'administration de vos clés. Vous pouvez en savoir plus sur cette fonctionnalité ainsi que sur la façon de l'activer en suivant notre guide pratique sur la persistance des messages.

Notifier les joueurs des messages manqués : Notifications push sur mobile

Avec les jeux mobiles, les joueurs sont souvent en train d'entrer et de sortir de l'application et peuvent manquer des messages cruciaux de leur équipe ou des mises à jour du jeu. C'est là que les notifications push mobiles entrent en jeu. Elles permettent d'informer les joueurs des messages de chat manqués, des mises à jour du jeu ou d'autres notifications importantes, même lorsqu'ils ne sont pas en train de jouer.

Avec l'API de notifications push mobiles, nous fournissons une API unifiée pour envoyer des notifications push aux appareils iOS et Android. Cela simplifie le processus et vous permet d'envoyer un seul appel API pour notifier tous les appareils, quelle que soit la plateforme. Vous pouvez également personnaliser vos notifications push, par exemple en envoyant des notifications personnalisées à des joueurs individuels ou en diffusant un message à tous les joueurs. Cette flexibilité vous permet de communiquer efficacement avec vos joueurs, en les gardant engagés et informés.

Pour pouvoir utiliser les notifications push mobiles avec PubNub, vous devez activer les notifications push mobiles en suivant notre guide pratique dans le portail d'administration. Nous avons également des guides plus spécifiques et détaillés pour les Notifications Push Mobiles FCM et APNs.

Plus que des mots : Emojis

Les émojis servent de langage universel des émotions dans la communication numérique. Ils permettent aux joueurs d'exprimer leurs sentiments et leurs réactions d'une manière amusante et colorée, rendant le chat plus interactif et engageant.

Avec PubNub, vous pouvez facilement implémenter le support des emojis dans votre jeu Unity en demandant aux joueurs de publier des signaux plutôt que des messages. Les signaux sont destinés à l'envoi de petits morceaux de données, car ils sont beaucoup plus rapides et moins coûteux que les messages. Comme les emojis sont généralement très petits en termes de taille de données, c'est un moyen parfait d'envoyer rapidement les données.

Vous pouvez utiliser l 'API Signals de PubNub pour publier des emojis dans un chat spécifique. Par exemple, si un joueur souhaite envoyer un emoji de signe de la main au chat global, le code suivant sera exécuté lorsqu'il appuiera sur Envoyer :

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

Les joueurs destinataires recevront le signal s'ils sont abonnés au canal spécifié. Dans ce cas, comme il s'agit du canal global, tout le monde recevra l'emoji. Pour pouvoir écouter les signaux, abonnez-vous à l'événement listener :

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

Vous devez vous assurer que la valeur de l'emoji représente un emoji réel défini dans Unity. Ces emojis peuvent être stockés et récupérés dans le réseau PubNub via App Context (anciennement connu sous le nom d'Objects) afin que tous les emojis auxquels le lecteur a accès puissent être récupérés à partir d'un stockage sans serveur. Pour en savoir plus sur l'implémentation d'App Context dans votre jeu Unity, consultez notre guide pratique.

Répondre aux messages : Réactions aux messages

Lesréactions aux messages, telles que les likes, les cœurs, les pouces en l'air, les autocollants ou les réactions personnalisées spécifiques au jeu, offrent aux joueurs un moyen rapide et facile de répondre aux messages de chat. Elles ajoutent non seulement de l'interactivité au chat, mais favorisent également le sens de la communauté en permettant aux joueurs de reconnaître les messages des autres et de s'y intéresser.

Vous pouvez utiliser l'API Message Actions de PubNub pour créer des fonctions telles que des réactions et des accusés de réception, ou pour associer des métadonnées personnalisées aux messages. Tout comme les applications de chat telles que Discord ont des réactions et des emojis différents selon les serveurs, il en va de même pour vos différents types de chat. Vous pouvez récupérer les réactions aux messages disponibles pour le canal de discussion spécifié à l'aide de l'appel suivant lors du chargement de la discussion :

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

Lorsqu'un joueur est sur le point de répondre à un message par une réaction, vous pouvez le faire en ajoutant une réaction à un message publié :

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 utilise des jetons de temps pour savoir précisément quand un message a été publié dans le réseau. Lorsque vous recevez des messages, le temps écoulé est également inclus dans la charge utile. Vous pouvez alors fournir la valeur appropriée du jeton de temps dans l'argument MessageTimetoken() afin de pouvoir réagir au message.

Pour pouvoir écouter la réaction et avertir le lecteur qui a envoyé le message original, vous devez ajouter un auditeur et gérer la réaction dans la méthode OnPNMessageAction :

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

Comme pour les emojis, vous pouvez utiliser App Context pour récupérer et stocker la façon dont ces réactions sont représentées visuellement dans votre jeu. Pour pouvoir utiliser les réactions aux messages, vous devez vous assurer que la persistance des messages est activée pour vos clés dans le portail d'administration.

GIFs et autres multimédias

Le partage de fichiers multimédias est une autre fonctionnalité importante qui améliore l'expérience du chat. Qu'il s'agisse de partager des GIF, des captures d'écran de moments drôles ou même des ressources de jeu, le partage de fichiers apporte un autre niveau d'interaction à votre jeu.

La mise en œuvre de ces types de fichiers multimédias utilise l'API de partage de fichiers PubNub. Grâce à cette fonctionnalité, les joueurs peuvent charger, télécharger et supprimer les fichiers auxquels ils ont accès. Pour pouvoir envoyer un fichier, vous devez effectuer l'appel suivant :

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

Pour que les abonnés écoutent le fichier, vous devez ajouter l'écouteur d'événement et gérer l'affichage du fichier dans la méthode OnPNFile :

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

Vous pouvez également obtenir, répertorier des informations et supprimer n'importe quel fichier associé à différents canaux de discussion. Vous devrez vous assurer d'activer la fonction de partage de fichiers dans le portail d'administration, ainsi que la persistance des messages. Pour en savoir plus, consultez notre guide pratique sur l'activation des fichiers.

Sécurisez vos canaux de discussion : Gestionnaire d'accès

Dans tout environnement de jeu, il est primordial d'assurer la sécurité des canaux de discussion. Qu'il s'agisse de protéger les joueurs des messages indésirables ou de protéger les discussions stratégiques sensibles, le système de chat de votre jeu Unity doit être conçu avec la sécurité à l'esprit.

C'est là que le gestionnaire d'accès de PubNub entre en jeu. Il fournit un cadre robuste et flexible pour sécuriser vos canaux de discussion. Avec Access Manager, vous pouvez contrôler qui peut publier ou s'abonner à chacun de vos canaux, ajoutant ainsi une couche supplémentaire de sécurité au système de chat de votre jeu Unity.

Le gestionnaire d'accès vous permet d'accorder des autorisations au niveau de l'utilisateur, du canal ou même au niveau des clés individuelles. Vous pouvez spécifier si un utilisateur peut lire, écrire ou gérer un canal, et ces permissions peuvent être mises à jour dynamiquement en fonction des besoins de votre jeu. Par exemple, dans une discussion privée entre deux joueurs, vous pouvez accorder à ces deux seuls joueurs les permissions de lecture et d'écriture pour leur canal privé. De même, dans une discussion de guilde, vous pouvez accorder des droits de lecture et d'écriture à tous les membres de la guilde, tout en n'accordant des droits de gestion qu'au chef de la guilde.

Access Manager prend également en charge l'authentification par jeton, ce qui vous permet d'authentifier les utilisateurs en toute sécurité et de leur accorder les autorisations appropriées. Ainsi, seuls les joueurs autorisés peuvent accéder aux canaux de discussion de votre jeu, ce qui protège la communauté de votre jeu contre les menaces potentielles.

Vous devez vous assurer que vous avez activé le gestionnaire d'accès dans le portail d'administration pour pouvoir utiliser cette fonctionnalité. Vous pouvez en savoir plus sur la façon de procéder en suivant cette page d'assistance sur l'activation de cette fonctionnalité complémentaire.

Prochaines étapes

Dans ce guide pratique, vous avez appris à ajouter un système de chat en temps réel robuste à votre jeu Unity. Nous avons tout abordé, de l'initialisation d'un objet PubNub dans votre environnement à la mise en place d'un modèle de chat représentant les différents types de chat, en passant par l'envoi et la réception de messages. Vous avez même appris à mettre en œuvre des fonctionnalités avancées comme les emojis, les réactions aux messages et le partage de fichiers, ainsi que les aspects importants de tout bon système de chat avec la persistance des messages, les notifications push mobiles et la sécurité des canaux.

Que vous soyez un développeur indépendant travaillant sur votre premier jeu ou un développeur chevronné cherchant à améliorer votre jeu multijoueur, la fonctionnalité en temps réel de PubNub peut servir d'infrastructure pour soutenir votre chat en jeu, afin que vous puissiez vous concentrer sur ce qui compte le plus.

Pour en savoir plus, consultez les ressources suivantes :

Lisez notre documentation Unity pour apprendre tout ce que vous devez savoir sur l'ajout d'un chat en temps réel à votre jeu.
Comprenez comment ajouter une liste d'amis grâce à notre guide Unity.
Découvrez comment notre jeu de démonstration Unity utilise des modèles de chat pour gérer les salons de discussion et bien plus encore.
Plongez dans le code source du SDK Unity.

N'hésitez pas à contacter l'équipe chargée des relations avec les développeurs à l'adresse devrel@pubnub.com si vous avez des questions ou des préoccupations.

Comment configurer Illuminate pour votre jeu

PubNub Developer Relations — Wed, 15 May 2024 23:54:34 +0000

Qu'est-ce que Illuminate ?

PubNub Illuminate est une solution de prise de décision et d'action instantanée basée sur un suivi analytique en direct des données de votre jeu. Illuminate vous donne le pouvoir de cartographier les KPI qui sont importants pour votre jeu, de déclencher des décisions basées sur les comportements des utilisateurs, et de voir les résultats instantanés - tout cela sans impliquer lourdement votre équipe d'ingénieurs. Avec Illuminate, vous pouvez immédiatement prendre des décisions intelligentes basées sur des données alors que les interactions et le jeu se déroulent en temps réel, afin de stimuler la croissance et d'optimiser l'efficacité de votre jeu.

Dans ce tutoriel, vous en apprendrez plus sur Illuminate, pourquoi il est important pour le succès de votre jeu (et de votre studio), et comment configurer Illuminate pour créer des décisions dans l'instant qui déclenchent des actions basées sur les données de votre jeu.

Pourquoi Illuminate pour les jeux ?

Avec la plupart des outils d'analyse traditionnels, la prise de mesures sur les données en temps réel est généralement réactive. Les ajustements, tels que les changements de prix basés sur les commentaires des joueurs, sont entravés par de longs cycles de correctifs qui impliquent la collecte de données, les tests et le déploiement sur les différentes plateformes, ce qui détourne encore plus les ressources du développement et de la création de contenu futur. Il y a un besoin critique de visibilité en temps réel de l'engagement des joueurs et de la monétisation pour permettre des décisions tactiques rapides, car les informations exploitables deviennent inefficaces si elles sont retardées ne serait-ce que de quelques heures après l'occurrence de l'événement.

Illuminate est un produit personnalisable à code bas qui permet aux gestionnaires de jeux et aux analystes de données d'appliquer et d'évaluer l'impact de leurs décisions stratégiques instantanément. Illuminate permet aux équipes de procéder à des ajustements à la volée de l'équilibre du jeu, à des stratégies de monétisation plus efficaces et plus appropriées grâce à l'expérimentation en temps réel, et à des récompenses personnalisées pour les joueurs afin d'améliorer la rétention et l'expérience des joueurs, tout en détectant les activités frauduleuses sans alourdir le travail des développeurs de jeux.

Avec Illuminate, vous pouvez gérer votre plateforme et prendre des mesures en temps réel :

Lancer des expériences de monétisation ciblées dans les canaux et voir les résultats immédiats.
Envoyez immédiatement des recommandations personnalisées basées sur les actions des joueurs au moment où elles se produisent.
Déclenchez des actions basées sur les comportements des utilisateurs ou des cohortes, et constatez les résultats instantanément.
Améliorez la détection des fraudes, identifiez les comportements suspects et agissez en conséquence en temps réel.
Ajustez et expérimentez les prix des articles de la boutique du jeu. Ajustez les prix si les joueurs achètent plusieurs exemplaires d'un même article et déclenchez des événements dans le jeu pour affecter tous les prix du magasin.
Récompenser les joueurs qui ont relevé des défis ou obtenu des résultats en leur offrant des codes de réduction sur les articles du jeu. Déterminer où les joueurs passent le moins de temps et envisager de les récompenser pour qu'ils passent du temps dans cette zone ou modifier le type de récompenses qu'ils obtiennent.
Faire apparaître des objets utiles et ajuster les fonctionnalités de base du jeu à la volée, sans avoir besoin d'interroger les ingénieurs.

Vous pouvez en savoir plus sur la façon dont Illuminate alimente les jeux grâce à notre vidéo Illuminate pour les jeux.

Comment configurer Illuminate pour votre jeu

Avant de plonger dans la configuration d'Illuminate pour votre jeu, vous devez comprendre certains termes clés utilisés tout au long de la configuration. Illuminate se compose de ces trois modules :

Business Object: La façon dont vous obtenez des données dans Illuminate. Vous pouvez définir, créer et activer des objets d'affaires, qui sont des conteneurs pour capturer des données à partir des applications et des jeux de clés sélectionnés. Grâce à une série d'options (mesures, dimensions ou métriques), vous pouvez décider des données particulières que vous souhaitez suivre en temps réel et de la manière dont vous souhaitez les agréger.
Décision: Il s'agit de l'endroit où vous agissez sur les mesures que vous avez créées. Pour ce faire, vous pouvez définir des règles avec des conditions à remplir et des actions déclenchées lorsque ces règles sont remplies.
Tableau de bord: Il s'agit de l'endroit où vous visualisez les mesures que vous avez créées dans Business Objects et les actions exécutées dans Decisions au moyen de graphiques et de tableaux de bord (collections de graphiques).

Maintenant que nous avons défini la terminologie clé, l'intégration d'Illuminate à votre jeu se fait en six étapes :

Comprendre le schéma du message
Choisir l'origine de vos données.
Choisir vos données
Visualiser vos données
Mettez vos données au travail
Visualiser et faire des ajustements

Comprendre le schéma du message

Il est essentiel de comprendre le schéma de données de votre jeu. Cela signifie qu'il faut identifier les types de données que vous souhaitez suivre et analyser, comme les actions des joueurs, les transactions dans le jeu et les événements du système. En comprenant et en documentant le contenu exact de la charge utile, les développeurs peuvent s'assurer que les analystes et les autres membres de l'équipe peuvent mapper les données vers les sources appropriées de manière efficace à l'aide de JSONPath. Vous comprendrez pourquoi cela est important lorsque vous choisissez vos données lors de la création d'objets de gestion.

Sélectionnez l'origine de vos données

Illuminate peut être utilisé avec n'importe quel jeu qui se connecte en ligne, que PubNub l'alimente ou non. Si PubNub alimente l'infrastructure de votre jeu, il suffit de sélectionner l'App et le KeySet appropriés utilisés pour votre jeu lors de la création de l'objet métier (plus d'informations à ce sujet prochainement) dans le portail d'administration.

Si votre jeu n'est pas propulsé par PubNub, vos données peuvent être envoyées en utilisant l'API Fire, soit à travers l'API REST, soit à travers l'un de nos SDK. Le point de terminaison Fire permet au client d'envoyer un message aux gestionnaires d'événements Functions. Ces messages iront directement à tous les gestionnaires d'événements enregistrés sur le canal auquel vous envoyez un message et déclencheront leur exécution.

Pour utiliser l'API Fire de PubNub, vous devez créer un compte PubNub et configurer votre jeu de clés avec les fonctionnalités dont vous aurez besoin pour votre jeu. Ce jeu de clés contient les clés de publication et d'abonnement nécessaires à l'API Fire. Vous pouvez apprendre à le faire en suivant notre guide pratique.

Choisissez vos données : Objets d'affaires

Les Business Objects sont fondamentaux dans Illuminate. Ce sont des conteneurs pour les données que vous voulez utiliser pour la prise de décision et la visualisation dans Illuminate et c'est essentiellement la façon dont vous obtenez des données dans Illuminate.

Trois éléments composent un objet d'affaires :

Sélectionner les données (Mesures et Dimensions)
Source de données (d'où proviennent les données)
Conditions (métriques)

Bien qu'il ne s'agisse pas de bases de données, il est utile de penser à la structure d'un objet de gestion en termes de SELECT (mesures et dimensions), FROM (source de données), WHERE (métriques) de SQL. Lorsque vous créez vos objets de gestion, veillez à suivre la documentation pour connaître les détails spécifiques ou les solutions de contournement à prendre en compte.

Sélectionner les données

Il existe deux types de valeurs différentes que vous pouvez sélectionner pour un objet de gestion : Les mesures et les dimensions.

Lesmesures sont des valeurs numériques et quantitatives. Les exemples de mesures comprennent la durée du jeu, le nombre de pièces, le nombre de tués, les dommages causés par les armes ou la valeur de la commande.

Lesdimensions sont des valeurs qualitatives, telles que la langue du joueur, les cosmétiques sélectionnés, le type de quête, le type d'arme choisi ou le niveau de jeu.

Selon le type de données que vous souhaitez suivre, vous devrez mapper les données à vos mesures et dimensions à l'aide de JSONPath. Illuminate doit savoir où chercher pour commencer à capturer ces données à partir de votre source de données (que vous avez configurée à l'étape précédente). Pour définir la source de données, sélectionnez le bouton Map à côté de chaque mesure et dimension et fournissez les chemins JSON correspondants.

C'est la partie la plus délicate de la configuration de Business Objects, car vous devez comprendre votre schéma de messages. Puisque vous avez documenté ou compris votre schéma de messages précédemment, vous devez le faire correspondre à la manière dont Iluminate recherche les données.

Si vous capturez des messages (spécifiquement Publish Message API), Illuminate recherche la structure suivante. Si votre infrastructure n'est pas alimentée par PubNub, vos données devront être mappées dans la même structure que l'API Publish Message :

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

Pour mapper correctement une mesure ou une dimension, vous devez fournir l'objet du message suivi d'un autre champ. La structure sera toujours la suivante : $.message.{obligatoire-secondary-field}.{optional-further-fields}.

La_manière dont vous mappez les données dépend entièrement de la structure de votre message_. Voici quelques exemples de mappage des données pour les messages :

Nombre de pièces de monnaie (mesure) => $.message.meta.coins
Article cosmétique équipé (dimension) => $.message.body
Nom du canal (dimension) => $.message.channel
Dommages causés (mesure) => $.message.body[6]
Obtenir certains noms d'utilisateurs (dimension) => $.message.userId
Nombre d'amis (mesure) => $.message.body.user.friends_count

Illuminate peut également capturer des données en utilisant le contexte applicatif de PubNub, qui vous permet de persister les métadonnées sur les canaux, les membres des canaux, les membres des canaux et les utilisateurs envoyés à travers le réseau PubNub. Vous pouvez accéder à ces informations en suivant exactement comment Illuminate capture ces données.

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

Comme pour les messages, pour mapper correctement une mesure ou une dimension, vous devez fournir l'objet utilisateur, canal ou membre suivi d'au moins une clé de votre JSON. La structure sera toujours la suivante : $.user.{obligatoire-secondary-field}.{optional-further-fields}. Voici quelques exemples de mappage des données pour App Context :

Détails de l'article de la boutique (dimension) => $.channel.custom.details
Statut de la liste d'amis (dimension) => $.membership.status
Langue du joueur (dimension) => $.user.custom.language
Score moyen du joueur (dimension) => $.user.custom.team_deathmatch_score

Remarque: pour créer un Business Object, vous devez ajouter au moins une dimension ou une mesure.

Source de données

Une fois que vous avez défini vos mesures et vos dimensions, vous devez déterminer l'origine de vos données. C'est ce que vous avez déterminé précédemment. Assurez-vous de sélectionner l'application et l'ensemble de clés appropriés que vous avez définis plus tôt pour vous assurer qu'Illuminate capture les données de la bonne source.

Conditions (métriques)

Une fois que vous avez sélectionné votre source de données, vous pouvez ajouter des conditions appelées métriques. Analogues à l'instruction WHERE de SQL, les métriques ne sont pas nécessaires pour que Business Objects capture des données, mais elles sont extrêmement utiles pour filtrer et appliquer des calculs à vos mesures et dimensions. Gardez à l'esprit que les métriques sont nécessaires pour créer une décision ou pour visualiser les tableaux de bord sous forme de graphiques (nous y reviendrons plus tard).

Lorsque vous créez des indicateurs, vous devez attribuer et sélectionner des champs aux filtres. Il y a quelques champs dont il faut tenir compte :

Nommez votre mesure de manière logique, car le graphique qui visualisera les données dans le tableau de bord portera le même nom.
Lors de la sélection de la fonction, les mesures peuvent actuellement être agrégées à l'aide de SUM, AVG, MAX et MIN. Les dimensions ne peuvent utiliser que la fonction COUNT. Le choix de la fonction vous permet de sélectionner la mesure ou la dimension dans une liste déroulante.
Pour la période, sélectionnez la fenêtre d'agrégation ou la période de temps pour votre fonction.
Veillez à sélectionner les dimensions que vous souhaitez voir apparaître dans vos graphiques et décisions (car vous ne pourrez pas segmenter dans les graphiques et les appliquer aux règles dans les décisions si vous ne les sélectionnez pas ultérieurement).
Filtrer des messages spécifiques ou des données de contexte d'application en fonction de différentes dimensions. Gardez à l'esprit que pour visualiser les tableaux de bord et rassembler les données, vous n'avez pas besoin d'appliquer des filtres à l'indicateur.

Vous pouvez créer plusieurs indicateurs pour un même objet de gestion afin de capturer des données différentes. Vous trouverez ci-dessous un exemple de mesure permettant d'enregistrer les dommages causés par une mesure et le type d'arme qui a causé ces dommages :

Visualisez vos données : Tableaux de bord et graphiques

Illuminate vous permet de visualiser non seulement les métriques que vous voulez suivre, mais aussi les actions de décision et leurs résultats à travers des graphiques sur les tableaux de bord.

De cette façon, vous pouvez observer les tendances de votre produit en temps réel, réagir et raffiner votre approche avec des décisions d'affaires basées sur les données. C'est aussi une excellente façon de déterminer si Illuminate capture correctement vos données en fonction des objets d'affaires que vous avez configurés plus tôt !

Vous pouvez créer un tableau de bord, qui est une collection de graphiques qui vous permet de voir toutes vos mesures en un seul endroit et d'ajouter des graphiques à votre tableau de bord. Un graphique est une représentation visuelle d'une mesure définie pour un objet de gestion donné.

Vous pouvez à tout moment personnaliser l'affichage des données métriques dans un graphique, par exemple en affichant un intervalle de temps différent (30 minutes, 1 heure ou une date personnalisée) et en affichant les données métriques dans différents types de graphiques, soit sous forme de diagramme à barres (affichage par défaut), soit sous forme de graphique linéaire.

Vous pouvez ajouter plusieurs graphiques (mesures) à un tableau de bord, et avoir différents tableaux de bord pour visualiser différents aspects de votre jeu (monétisation, gameplay, récompenses de quêtes, etc.). Une fois que vous aurez configuré vos décisions, vous pourrez visualiser les actions de décision déclenchées et leurs résultats sous forme de graphiques dans les tableaux de bord.

Mettez vos données à profit : Décisions et actions

Une fois votre métrique créée, vous pouvez commencer à évaluer ces données, surveiller les tendances et, plus important encore, agir en conséquence.

Illuminate contient le module Décisions qui vous permet de définir les métriques sur lesquelles vous voulez agir en créant des actions de différents types et des règles définissant quand ces actions doivent être exécutées.

Lors de la création d'une décision, vous devez

Choisissez un objet de gestion et l'une des mesures qui lui sont liées.
Définir les actions à entreprendre.
Configurer [rules}(https://www.pubnub.com/docs/illuminate/decisions/basics#rules) à l'aide des conditions choisies et des actions configurées. Ces règles déclencheront des actions.

Les décisions visent à aider les gestionnaires de produits à expérimenter des stratégies d'engagement et de monétisation avant de les codifier et de les déployer. Avec Illuminate, ils peuvent prendre des décisions basées sur des données réelles plutôt que sur des hypothèses, puis agir sur ces données par le biais de conditions et d'actions automatisées.

Les décisions se composent de deux parties : Les actions et les règles.

Actions

Les actions définissent ce qui se passera lorsque les conditions (discutées ci-dessous) seront remplies.

Vous avez le choix entre cinq types d'actions lors de la configuration des actions :

Envoyer un message : Publie un message à un utilisateur ou à un canal et utilise l'API de publication PubNub. Vous pouvez éventuellement ajouter des variables (${variableThatChanges}) que vous pouvez contrôler et modifier dynamiquement lors de la mise en place de règles de décision.
Webhook : Envoie un appel à une URL spécifique en se connectant à l'intégration d'un service tiers. Vous pouvez éventuellement ajouter des variables (${variableThatChanges}) que vous pouvez contrôler et modifier dynamiquement lors de la définition des règles de décision.
Update User : Définit toute métadonnée utilisateur prédéfinie ou personnalisée en fournissant les informations souhaitées sous forme de paires clé/valeur, en utilisant l'API PubNub App Context pour les utilisateurs.
Mettre à jour le canal : Définit toute métadonnée de canal prédéfinie ou personnalisée en fournissant les informations souhaitées sous forme de paires clé/valeur, en utilisant l'API PubNub App Context pour les canaux.
Mise à jour des membres : Définit toute métadonnée d'adhésion prédéfinie ou personnalisée en fournissant les informations souhaitées sous forme de paires clé/valeur, en utilisant l'API PubNub App Context pour les adhésions.

Bien que vous ne puissiez configurer qu'une seule mesure par décision, vous pouvez créer plusieurs décisions pour couvrir vos cas d'utilisation. Veillez à suivre la documentation lorsque vous créez des actions pour votre décision.

Une fois que vous avez fini de configurer vos actions, vous devez définir les règles de déclenchement des actions.

Règles

Lesrègles se composent de conditions, c'est-à-dire de critères qui doivent être remplis pour déclencher une action, à évaluer et d'actions à exécuter lorsque les conditions sont remplies. Une règle est une définition (ligne dans une table de décision) indiquant quelle action doit être déclenchée pour quelle condition.

La table de décision se compose de quatre parties :

Politique de frappe : Paramètre qui définit si vous souhaitez déclencher une ou plusieurs actions uniquement pour la première règle correspondante (Simple) ou pour toutes les règles (Multiple) si leurs conditions sont remplies.
Fenêtre d'agrégation : La seule valeur que vous ne pouvez pas modifier dans la fenêtre de configuration des règles. Elle se remplit automatiquement à partir de la valeur de la période choisie pour la fonction lors de la création d'une mesure. Elle indique la fréquence à laquelle une mesure exécute une fonction donnée (COUNT, AVG, MAX ou autre) pour une mesure ou une dimension.
Fréquence d'évaluation : Fenêtre de rétroaction pour la règle qui définit la fréquence à laquelle Illuminate doit exécuter la (les) règle(s) dans cette décision.
Conditions : Ensemble d'exigences que vous définissez vous-même à l'aide de la table de configuration. C'est ici que vous définissez quelles conditions (et les seuils qu'elles atteignent) doivent déclencher quelles actions.

N'oubliez pas que chaque ligne de la table de décision est une règle de décision distincte, composée de conditions et d'actions. L'ordre des règles détermine l'ordre dans lequel elles sont exécutées. Si vous souhaitez modifier l'ordre existant, sélectionnez Modifier les règles d'une décision et modifiez l'ordre à l'aide des options Déplacer vers le haut ou Déplacer vers le bas du menu "Actions" situé à côté de chaque règle.

Visualiser et effectuer des ajustements

Une fois que vous avez configuré vos objets de gestion, tableaux de bord et graphiques, ainsi que vos décisions, vous pouvez analyser et expérimenter des changements en temps réel. Vous n'avez plus besoin d'attendre les correctifs d'équilibrage pour voir si les changements que vous avez apportés ont un impact positif sur les joueurs ou le jeu.

C'est ici que vous passerez le plus clair de votre temps, à prendre des décisions d'expérimentation afin d'effectuer des ajustements pour stimuler l'engagement dans votre jeu.

Prochaines étapes

Illuminate met le pouvoir de l'expérimentation en temps réel entre les mains des équipes directement responsables de la croissance et des résultats de l'entreprise. Il s'agit d'une plateforme précieuse pour expérimenter et prendre des décisions intelligentes basées sur des données relatives au gameplay et aux comportements des utilisateurs, en cartographiant les KPI qui sont importants pour votre jeu et en déclenchant des décisions basées sur ces comportements.

Consultez nos ressources Illuminate pour voir comment Illuminate peut aider votre jeu et apprendre à tester Illuminate vous-même. Comme toujours, si vous avez des questions, n'hésitez pas à contacter l'équipe des relations avec les développeurs à l'adresse devrel@pubnub.com.