Canaux publics
Un canal Realtime est public sauf si son nom commence par private- ou presence-. Un client n'a besoin que de la clé publique de l'application pour s'abonner : considérez donc le canal comme lisible par quiconque possède cette clé.
const orders = bird.subscribe("orders");
orders.bind("order-updated", (data) => {
console.log(data);
});let orders = bird.subscribe("orders")
orders.bind("order-updated") { data in
print(data ?? "")
}val orders = bird.subscribe("orders")
orders.bind("order-updated") { data ->
println(data)
}Les canaux publics ne nécessitent aucun enregistrement ni point de terminaison d'autorisation. Un canal existe tant qu'au moins une connexion y est abonnée et disparaît lorsque la dernière connexion le quitte.
Quand utiliser un canal public
Utilisez les canaux publics pour des données que chaque visiteur peut lire, comme des résultats de build, des scores en direct, des informations de vol, des compteurs de spectateurs ou des incidents de page de statut.
Utilisez un canal privé pour des données associées à un utilisateur, un compte ou un tenant. Les abonnements aux canaux publics ne nécessitent aucune autorisation : un client peut donc essayer n'importe quel nom de canal qu'il peut deviner ou construire.
Limitations des canaux publics
- Identité des membres : les canaux publics ne suivent pas les membres et n'exposent pas de liste de membres. Les événements bird:member_added et bird:member_removed appartiennent aux canaux de présence.
- Événements client : les canaux publics rejettent les événements dont le nom commence par client-. Utilisez un canal privé ou de présence autorisé pour les événements émis par le client.
Compteurs de connexions
Le comptage des connexions fonctionne sur tous les types de canaux. Activez Connection counting et Connection count events pour recevoir bird:connection_count avec le nombre de connexions abonnées.
Nommage
Les noms de canaux sont sensibles à la casse et peuvent contenir jusqu'à 164 lettres, chiffres et les caractères suivants : _ - = @ , . ;. Par exemple, Orders et orders identifient des canaux différents.
Évitez les données sensibles ou identifiant un client dans les noms de canaux publics. orders ne révèle aucune information client. orders-user-4821 expose l'existence de l'utilisateur 4821 à quiconque peut accéder à l'application.
Étapes suivantes
- Canaux privés : les abonnements sont réservés aux clients approuvés par votre backend.
- Publication d'événements : explique comment publier depuis votre serveur et diffuser vers plusieurs canaux.
- Présentation de Realtime : définit les canaux, les membres et les connexions.
Ressources associées
Poursuivez avec la documentation, les guides et les exemples sur ce sujet. Les ressources sont en anglais.
Explorer la fonctionnalitéRealtimeSuivre le parcours d'apprentissageBuild your first integrationGuide d'implémentationSend your first realtime event
Essayez la pratique et obtenez un guide d'implémentation