Lokalisierung

Die Meetings API unterstützt die Lokalisierung der Benutzeroberfläche eines Meetings und ermöglicht es Ihnen, die verwendete Sprache zu ändern. Dies kann auf zwei Arten gesteuert werden:

Im API-Aufruf vordefiniert - Dadurch kann die Sprache für alle Teilnehmer der Besprechung über eine Option im API-Aufruf vordefiniert werden.
Auswahl aus der UI - fügt der Benutzeroberfläche eine Sprachauswahloption hinzu, mit der jeder Teilnehmer des Meetings seine bevorzugte Sprache auswählen kann.

Anwendung einer Sprache auf alle Teilnehmer

Mit dieser Option kann die Sprache im API-Aufruf voreingestellt werden; die gewählte Sprache wird auf alle Teilnehmer des Meetings angewendet. Dies geschieht durch Hinzufügen von "ui_settings": {"language":"XX"} zu dem API-Aufruf, bei dem Sie Ihre Besprechung erstellen, wobei XX ist der Sprachcode der gewählten Sprache (siehe Verfügbare Sprachen unten für eine Liste der derzeit unterstützten Sprachen).

Mit diesem API-Aufruf wird zum Beispiel ein Raum erstellt, in dem die Sprache für alle Teilnehmer auf Spanisch eingestellt ist:

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

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

Wenn beim API-Aufruf keine Sprache ausgewählt wird, wird standardmäßig Englisch ausgewählt.

Verfügbare Sprachen

Sprache	Sprache Code
Arabisch	AR
Brasilianisches Portugiesisch	PT-BR
Katalanisch	CA
Chinesisch (Taiwan)	ZH-TW
Chinesisch (Festland)	ZH-CN
Englisch	EN
Französisch	FR
Deutsch	DE
Hebräisch	HE
Italienisch	IT
Spanisch	ES

Individuelle Auswahl aus der UI

Mit dieser Option wird eine Spracheinstellung in der Benutzeroberfläche angezeigt, die es jedem Teilnehmer ermöglicht, die gewünschte Sprache auszuwählen. Dies geschieht durch Hinzufügen von "is_locale_switcher_available": true zu Ihrem API-Aufruf innerhalb der available_features Objekt:

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

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

Wenn diese Option aktiviert ist, sehen die Teilnehmer in der rechten oberen Symbolleiste des Meetings ein Globussymbol:

Wenn der Benutzer auf die Weltkugel klickt, erhält er eine Liste mit Optionen zum Ändern der Sprache der Benutzeroberfläche: