Senden und Empfangen von ephemeren Ereignissen

Product deprecation notice

Effective April 30th, 2026, Vonage In-App Messaging will no longer be available. Access for new users will be closed, and the service will be discontinued for all existing users.

If you have any questions regarding this product’s discontinuation, please contact your account manager or our support team.

In diesem Handbuch wird beschrieben, wie Sie mit dem Vonage Client SDK Ephemeral Events senden und empfangen können. Bevor Sie beginnen, vergewissern Sie sich, dass Sie das SDK zu Ihrer Anwendung hinzugefügt und eine Session (Android, iOS, JS), und an einer Konversation teilnehmen.

Ephemere Ereignisse sind kurzlebige Ereignisse, die an alle App Mitglieder in einer Konversation. Sie werden nicht in der Konversation gespeichert, im Gegensatz zu Benutzerdefinierte Ereignisse. Wenn Sie also eine Ereignisse des Gesprächs werden sie nicht zurückgeschickt.

Ephemere Ereignisse eignen sich am besten für die Implementierung von wiederkehrenden benutzerdefinierten Ereignissen, wie z. B. Tippindikatoren.

Senden von ephemeren Ereignissen

Mit einer Conversation ID können Sie ein ephemeres Ereignis senden. Es wird empfohlen, ein JSON für Ihre benutzerdefinierten Daten zu verwenden und einen Typ-Parameter einzufügen, z. B. 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
    ... 
}

Empfangen von ephemeren Ereignissen

Sie können alle Konversationsereignisse in Ihrer Anwendung empfangen, indem Sie eine Ereignis-Listener/Delegate-Funktion einrichten. Hier können Sie die Art des eingehenden Ereignisses überprüfen.

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