Localisation

L'API Meetings prend en charge la localisation de l'interface utilisateur d'une réunion, ce qui permet de modifier la langue utilisée. Ce changement peut être contrôlé de deux manières :

Prédéfini dans l'appel API - cela permet de prédéfinir la langue pour tous les participants à la réunion via une option dans l'appel API.
Sélection dans l'interface utilisateur - ajoute une option de sélection de la langue à l'interface utilisateur, permettant à chaque participant à la réunion de sélectionner sa langue préférée.

Appliquer une langue à tous les participants

Cette option permet de prédéfinir la langue dans l'appel API ; la langue sélectionnée sera appliquée à tous les participants à la réunion. Pour ce faire, il suffit d'ajouter "ui_settings": {"language":"XX"} à l'appel de l'API où vous créez votre réunion, où XX est le code linguistique de la langue sélectionnée (voir Langues disponibles ci-dessous pour une liste des langues actuellement prises en charge).

Par exemple, cet appel API créera une salle dont la langue sera l'espagnol pour tous les participants :

curl -X POST 'https://api-eu.vonage.com/v1/meetings/rooms' \ -H 'Authorization: Bearer '$JWT \ -H 'Content-Type: application/json' \ -d '{ "display_name":"New Meeting Room", "ui_settings": { "language": "ES" } }'

const credentials = new Auth({
    privateKey: VONAGE_APPLICATION_PRIVATE_KEY_PATH,
    applicationId: VONAGE_APPLICATION_ID,
});
const options = {};

const meetingsClient = new Meetings(credentials, options);
await meetingsClient.createRoom({
    type: MeetingType.INSTANT,
    displayName: "New Meeting Room",
    uiSettings: {
        language: RoomLanguage.ES,
    },
});

var client = VonageClient.builder()
    .applicationId(VONAGE_APPLICATION_ID)
    .privateKeyPath(VONAGE_PRIVATE_KEY_PATH)
    .build();
var room = MeetingRoom.builder("New Meeting Room")
    .uiSettings(UISettings.builder()
        .language(RoomLanguage.ES)
        .build()
    )
    .build();
client.getMeetingsClient().createRoom(room);

var credentials = Credentials.FromAppIdAndPrivateKeyPath(applicationId, privateKeyPath);
var client = new VonageClient(credentials);
var request = CreateRoomRequest.Build()
    .WithDisplayName("New Meeting Room")
    .WithUserInterfaceSettings(new UiSettings(UiSettings.UserInterfaceLanguage.Es))
    .Create();
var response = await client.MeetingsClient.CreateRoomAsync(request);

client = vonage.Client(
    application_id=VONAGE_APPLICATION_ID,
    private_key=VONAGE_APPLICATION_PRIVATE_KEY_PATH,
)

response = client.meetings.create_room({
    'display_name': 'New Meeting Room',
    'ui_settings': {'language': 'es'},
})

Si aucune langue n'est sélectionnée dans l'appel API, l'anglais est sélectionné par défaut.

Langues disponibles

Langue	Code langue
L'arabe	AR
Portugais brésilien	PT-BR
Catalan	CA
Chinois (Taiwan)	ZH-TW
Chinois (continent)	ZH-CN
Anglais	EN
Français	FR
Allemand	DE
Hébreu	HE
Italien	IT
Espagnol	ES

Sélection individuelle dans l'interface utilisateur

Cette option permet d'afficher un paramètre de langue dans l'interface utilisateur, permettant à chaque participant de choisir la langue qu'il souhaite. Pour ce faire, il suffit d'ajouter "is_locale_switcher_available": true à votre appel d'API dans le available_features objet :

curl -X POST 'https://api-eu.vonage.com/v1/meetings/rooms' \ -H 'Authorization: Bearer '$JWT \ -H 'Content-Type: application/json' \ -d '{ "display_name": "New Meeting Room", "available_features": { "is_locale_switcher_available": true } }'

const credentials = new Auth({
    privateKey: VONAGE_APPLICATION_PRIVATE_KEY_PATH,
    applicationId: VONAGE_APPLICATION_ID,
});
const options = {};

const meetingsClient = new Meetings(credentials, options);
await meetingsClient.createRoom({
    type: MeetingType.INSTANT,
    displayName: "New Meeting Room",
    availableFeatures: {
        isLocaleSwitcherAvailable: true,
    },
});

var client = VonageClient.builder()
    .applicationId(VONAGE_APPLICATION_ID)
    .privateKeyPath(VONAGE_PRIVATE_KEY_PATH)
    .build();
var room = MeetingRoom.builder("New Meeting Room")
    .availableFeatures(AvailableFeatures.builder()
        .isLocaleSwitcherAvailable(true)
        .build()
    )
    .build();
client.getMeetingsClient().createRoom(room);

var credentials = Credentials.FromAppIdAndPrivateKeyPath(applicationId, privateKeyPath);
var client = new VonageClient(credentials);
var request = CreateRoomRequest.Build()
    .WithDisplayName("New Meeting Room")
    .WithFeatures(new Room.Features {IsLocaleSwitcherAvailable = true})
    .Create();
var response = await client.MeetingsClient.CreateRoomAsync(request);

client = vonage.Client(
    application_id=VONAGE_APPLICATION_ID,
    private_key=VONAGE_APPLICATION_PRIVATE_KEY_PATH,
)

response = client.meetings.create_room({
    'display_name': 'New Meeting Room',
    'available_features': {
        'is_locale_switcher_available': True,
    },
})

Si cette option est activée, les participants pourront voir une icône de globe dans la barre d'outils en haut à droite de la réunion :

En cliquant sur le globe, l'utilisateur dispose d'une liste d'options lui permettant de changer la langue de l'interface utilisateur :