Gestion des membres avec le Client SDK

Ce guide explique comment gérer les membres avec le Vonage Client SDK. Avant de commencer, assurez-vous d'avoir ajouté le SDK à votre application et d'avoir créé une session (Android, iOS, JS).

Lorsqu'un Utilisateur se joint à une conversation, il devient un Membre. Une adhésion est une correspondance entre un utilisateur, un canal et un canal de communication. Conversation. Par exemple, un utilisateur appelé "Alice" deviendra membre d'une conversation appelée "Chat", via le canal "App".

Participer à une conversation

Un identifiant de conversation vous permet de rejoindre une conversation. L'adhésion crée un membre dans la conversation avec l'identifiant JOINED état. Ensuite, vous pouvez envoyer et recevoir des messages. Lorsque vous rejoignez une conversation via le Client SDK, le canal est défini sur "App"

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

Inviter à une conversation

Avec un ID de conversation et le nom d'utilisateur d'un autre utilisateur, vous pouvez l'inviter à une conversation. Sur Android et iOS, une notification push sera envoyée aux appareils enregistrés de l'utilisateur invité.

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);
    });

Quitter une conversation

Vous pouvez quitter une conversation à l'aide d'un identifiant de conversation. Le fait de quitter une conversation met à jour les Le membre de l'État à LEFT.

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

Obtenir des membres de la conversation

Étant donné l'identifiant d'une conversation dont vous êtes membre, vous pouvez obtenir tous les membres de cette conversation. Vous pouvez éventuellement fournir des paramètres pour configurer la réponse, sinon les valeurs par défaut seront utilisées. Cette méthode renvoie une réponse paginée. Si vous n'êtes pas familier avec la pagination, consultez la section guide de pagination.

Vous pouvez régler :

• Commande
• Taille de la page
• Un curseur

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);
    });

Obtenir un membre de la conversation

Compte tenu de l'ID de la conversation et de l'ID du membre, vous pouvez obtenir un objet membre complet. Si vous souhaitez obtenir votre objet Membre, vous pouvez définir la propriété memberId au paramètre "me".

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

Obtenir une conversation Événements pour les membres

Vous pouvez recevoir tous les événements des membres de la 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 membre entrant.

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;
    };
});