Mitgliederverwaltung mit dem Client SDK

Diese Anleitung beschreibt, wie Sie Mitglieder mit dem Vonage Client SDK verwalten. Bevor Sie beginnen, stellen Sie sicher, dass Sie das SDK zu Ihrer Anwendung hinzugefügt und eine Sitzung (Android, iOS, JS).

Wenn ein Benutzer einer Konversation beitritt, wird er ein Mitglied. Eine Mitgliedschaft ist eine Zuordnung zwischen einem Benutzer, einem Kanal und einem Konversation. Ein Beispiel: Ein Nutzer namens "Alice" wird über den "App"-Kanal Mitglied in einer Unterhaltung namens "Chat".

An einer Konversation teilnehmen

Mit einer Gesprächs-ID können Sie einer Unterhaltung beitreten. Durch den Beitritt wird ein Mitglied in der Konversation mit der JOINED Status. Danach können Sie Nachrichten senden und empfangen. Wenn Sie einer Konversation über das Client SDK beitreten, wird der Kanal auf "App" gesetzt.

client.joinConversation(conversationId)
.then(memberId => {
    console.log("Successfully joined Conversation with Member Id: ", memberId);
}).catch(error => {
    console.error("Error joining Conversation: ", error);
});

Einladung zu einem Gespräch

Mit einer Konversations-ID und dem Benutzernamen eines anderen Nutzers können Sie diesen zu einer Konversation einladen. Auf Android und iOS wird eine Push-Benachrichtigung an die registrierten Geräte des eingeladenen Nutzers gesendet.

client.inviteToConversation(conversationId, username)
    .then(memberId => {
        console.log("Successfully invited User to Conversation with Member Id: ", memberId);
    }).catch(error => {
        console.error("Error joining Conversation: ", error);
    });

Verlassen einer Konversation

Mit einer Konversations-ID können Sie eine Konversation verlassen. Das Verlassen einer Konversation aktualisiert die bestehenden Das Mitglied Zustand zu LEFT.

client.leaveConversation(conversationId)
    .then(() => {
        console.log("Successfully left Conversation.");
    }).catch(error => {
        console.error("Error leaving Conversation: ", error);
    });

Gesprächsmitglieder gewinnen

Anhand der Gesprächs-ID eines Gesprächs, in dem Sie Mitglied sind, können Sie alle Mitglieder dieses Gesprächs abrufen. Sie können optional einige Parameter übergeben, um die Antwort zu konfigurieren, andernfalls werden die Standardwerte verwendet. Diese Methode gibt eine paginierte Antwort zurück. Wenn Sie mit der Paginierung nicht vertraut sind, sehen Sie sich die Paginierungsanleitung.

Sie können einstellen:

• Bestellung
• Größe der Seite
• Ein Cursor

const params = {
    order: "asc", // "desc"
    pageSize: 100,
    cursor: null
};
    
client.getConversationMembers(conversationId, params)
    .then(({members, nextCursor, previousCursor}) => {
        console.log("Array of Members: ", members);
        console.log("cursor for next set of results, if any. could be null: ", nextCursor);
        console.log("cursor for previous set of results, if any. could be null: ", previousCursor);
    }).catch(error => {
        console.error("Error getting Members: ", error);
    });

Ein Gesprächsmitglied bekommen

Mit einer Gesprächs-ID und einer Mitglieds-ID können Sie ein vollständiges Mitglied-Objekt erhalten. Wenn Sie Ihr Mitgliedsobjekt erhalten möchten, können Sie die memberId Parameter zu "me".

client.getConversationMember(conversationId, memberId)
    .then(member => {
        console.log("Successfully got Member: ", member);
    }).catch(error => {
        console.error("Error getting Member: ", error);
    });

Getting A Conversation Mitgliederveranstaltungen

Sie können alle Conversation Member Events in Ihrer Anwendung empfangen, indem Sie eine Event Listener/Delegate Function einrichten. Hier können Sie die Art des eingehenden Mitgliedsereignisses überprüfen.

client.on("conversationEvent", event => {
    switch (event.kind) {
        case "member:invited":
            handleMemberInvited(event);
            break;
        case "member:joined":
            handleMemberJoined(event);
            break;
        case "member:left":
            handleMemberLeft(event);
            break;
    };
});