Localización

La Meetings API admite la localización de la interfaz de usuario de una reunión, lo que permite cambiar el idioma utilizado. Esto se puede controlar de dos maneras:

Predefinido en la llamada a la API - esto permite predefinir el idioma para todos los participantes en la reunión mediante una opción en la llamada a la API.
Selección desde la interfaz de usuario - esto añade una opción de selección de idioma a la interfaz de usuario que permite a cada participante en la reunión seleccionar su idioma preferido.

Aplicar una lengua a todos los participantes

Esta opción permite preestablecer el idioma en la llamada a la API; el idioma seleccionado se aplicará a todos los participantes en la reunión. Esto se hace añadiendo "ui_settings": {"language":"XX"} a la llamada a la API en la que se crea la reunión, donde XX es el código del idioma seleccionado (véase Idiomas disponibles para obtener una lista de los idiomas admitidos actualmente).

Por ejemplo, esta llamada a la API creará una sala en la que el idioma se establecerá en español para todos los participantes:

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

$keypair = new Vonage\Client\Keypair(
    VONAGE_APPLICATION_PRIVATE_KEY_PATH
    VONAGE_APPLICATION_ID,
);

$client = new Vonage\Client($keypair);

$room = (new Vonage\Meetings\Room())->fromArray([
    'display_name' => 'New Meeting Room',
    'ui_settings' => [
        'language' => 'es'
    ]
]);

$createdRoom = $client->meetings()->createRoom($room);

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 no se selecciona ningún idioma en la llamada a la API, se selecciona el inglés por defecto.

Idiomas disponibles

Idioma	Código de idioma
Árabe	AR
Portugués de Brasil	PT-BR
Catalán	CA
Chino (Taiwán)	ZH-TW
Chino (continental)	ZH-CN
Inglés	EN
Francés	FR
Alemán	DE
Hebreo	HE
Italiano	IT
Español	ES

Selección individual desde la interfaz de usuario

Esta opción mostrará una configuración de idioma en la interfaz de usuario, permitiendo a cada participante elegir el idioma que desee. Esto se hace añadiendo "is_locale_switcher_available": true a su llamada a la API dentro del available_features objeto:

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

$keypair = new Vonage\Client\Keypair(
    VONAGE_APPLICATION_PRIVATE_KEY_PATH
    VONAGE_APPLICATION_ID,
);

$client = new Vonage\Client($keypair);

$room = (new Vonage\Meetings\Room())->fromArray([
    'display_name' => 'New Meeting Room',
    'available_features' => [
        'is_locale_switcher_available' => true
    ]
]);

$createdRoom = $client->meetings()->createRoom($room);

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

Con esta opción activada, los participantes podrán ver un icono de un globo terráqueo en la barra de herramientas superior derecha dentro de la reunión:

Al hacer clic en el globo terráqueo, el usuario dispondrá de una lista de opciones para cambiar el idioma de la interfaz de usuario: