エフェメラル・イベントの送受信方法

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.

このガイドでは、Vonage Client SDKでEphemeral Eventsを送受信する方法を説明します。始める前に、アプリにSDKを追加し、セッション(アンドロイド, iOS, JSそして 会話に参加.

エフェメラル・イベントは、すべてのイベントに配信される短命のイベントです。 App カンバセーション内のメンバー。とは異なり、会話には保存されません。 カスタムイベント.従って、あなたが 会話のイベント 返却されることはない。

エフェメラル・イベントは、タイピング・インジケーターのような繰り返し発生するカスタム・イベントの実装に最適です。

エフェメラル・イベントの送信

会話IDを指定すると、Ephemeral Eventを送信できます。カスタムデータにはJSONを使用し、typeパラメータを含めることを推奨します。 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);
    });

エフェメラル・イベントの受信

Event Listener/Delegate Functionをセットアップすることで、アプリケーションのすべてのConversation Eventを受け取ることができます。ここで、受信するイベントの種類を確認することができます。

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