Comment envoyer et recevoir des événements éphémères ?

Ce guide explique comment envoyer et recevoir des événements éphémères avec le Client Vonage SDK. Avant de commencer, assurez-vous d'avoir ajouté le SDK à votre application, créé une session (Android, iOS, JS), et a rejoint une conversation.

Les événements éphémères sont des événements de courte durée qui sont transmis à tous les utilisateurs de l'Internet. App dans une conversation. Ils ne sont pas stockés dans la conversation, contrairement à ce qui se passe dans le cas des membres d'une conversation. Événements sur mesure. Par conséquent, lorsque vous obtenez un Événements de la conversation ils ne seront pas renvoyés.

Les événements éphémères conviennent mieux à la mise en œuvre d'événements personnalisés récurrents, tels que les indicateurs de frappe.

Envoi d'événements éphémères

Vous pouvez envoyer un événement éphémère à partir d'un identifiant de conversation. Il est recommandé d'utiliser un JSON pour vos données personnalisées et d'inclure un paramètre de type, par exemple type: 'ephemeral:typingStart'.

const typingStartEvent = {
    member: memberId,
    type: "typing:start"
};

client.sendEphemeralEvent(conversationId, typingStartEvent)
    .then(timestamp => {
        console.log("Successfully sent ephemeral event at ", timestamp);
    }).catch(error => {
        console.error("Error sending ephemeral event: ", error);
    });

client.sendEphemeralEvent("CONV_ID", "MY_CUSTOM_BODY") { error, timestamp ->
    error?.takeIf { it is VGError }?.let {/* Handle Vonage Error */ } ?:
    error?.let {/* Handle generic Error */ }
    timestamp?.let { /* event sent at timestamp */ }
}

client.sendEphemeralEvent("CONV_ID", customBody: "MY_CUSTOM_BODY") { error, timestamp in
    ... 
}

Réception d'événements éphémères

Vous pouvez recevoir tous les événements de conversation dans votre application en mettant en place une fonction d'écoute/délégation d'événements. Ici, vous pouvez vérifier le type d'événement entrant.

client.on("conversationEvent", event => {
    switch (event.kind) {
        case "ephemeral":
            handleEphemeralEvent(event);
            break;
    };
});

client.setOnConversationEventListener {
    when(it) {
        is EphemeralConversationEvent -> {}
    }
}

func chatClient(_ client: VGChatClient, didReceiveConversationEvent event: VGConversationEvent) {
    switch event.kind {
    case .ephemeral:
        // Handle Ephemeral Event
        let ephemeralEvent = event as! VGEphemeralConversationEvent
    ...
    }
}