Localizar a biblioteca da interface do usuário em um aplicativo

Para obter documentação detalhada e guias de início rápido sobre a Biblioteca da Interface do Usuário da Web, consulte o Storybook da Biblioteca da Interface do Usuário da Web.

Para saber mais, consulte Localização na Biblioteca da Interface do Usuário da Web.

Para obter mais informações, consulte a biblioteca de interface do usuário do Android de código aberto e o código do aplicativo de exemplo.

Línguas disponíveis

A tabela a seguir lista CallCompositeSupportedLocale IDs para traduções prontas para uso. Se pretender localizar o composto, passe um objeto Locale de CallCompositeSupportedLocale para CallCompositeLocalizationOptions como opções para CallComposite.

Provedor de localização

CallCompositeLocalizationOptions é um wrapper de opções que define todas as strings para componentes da Biblioteca de Interface de Utilizador do Android usando CallCompositeSupportedLocale. Por padrão, todos os rótulos de texto usam cadeias de caracteres em inglês. Você pode usar CallCompositeLocalizationOptions para definir um idioma diferente passando um Locale objeto de CallCompositeSupportedLocale. Pronta para uso, a Biblioteca da Interface do Usuário inclui um conjunto de Locale objetos que podem ser usados com os componentes e compostos da interface do usuário.

Você também pode obter uma lista de Locale objetos usando a função CallCompositeSupportedLocale.getSupportedLocales()estática .

Para usar CallCompositeLocalizationOptions, especifique CallCompositeSupportedLocale e passe para CallCompositeBuilder. O exemplo a seguir localiza a composição para o francês.

import com.azure.android.communication.ui.calling.models.CallCompositeLocalizationOptions
import com.azure.android.communication.ui.calling.models.CallCompositeSupportedLocale

// CallCompositeSupportedLocale provides a list of supported locales
val callComposite: CallComposite =
            CallCompositeBuilder().localization(
                CallCompositeLocalizationOptions(CallCompositeSupportedLocale.FR)
            ).build()

import com.azure.android.communication.ui.calling.models.CallCompositeLocalizationOptions;
import com.azure.android.communication.ui.calling.models.CallCompositeSupportedLocale;

// CallCompositeSupportedLocale provides a list of supported locales
CallComposite callComposite = 
    new CallCompositeBuilder()
        .localization(new CallCompositeLocalizationOptions(CallCompositeSupportedLocale.FR))
        .build();

Direção do layout

Certas culturas (por exemplo, árabe e hebraico) podem precisar de localização para ter um layout da direita para a esquerda. Você pode especificar layoutDirection como parte do CallCompositeLocalizationOptions. O layout do composto será espelhado, mas o texto permanecerá na direção da cadeia de caracteres.

import com.azure.android.communication.ui.calling.models.CallCompositeLocalizationOptions
import com.azure.android.communication.ui.calling.models.CallCompositeSupportedLocale

// CallCompositeSupportedLocale provides a list of supported locales
val callComposite: CallComposite =
            CallCompositeBuilder().localization(
                CallCompositeLocalizationOptions(CallCompositeSupportedLocale.FR, LayoutDirection.LTR)
            ).build()

import com.azure.android.communication.ui.calling.models.CallCompositeLocalizationOptions;
import com.azure.android.communication.ui.calling.models.CallCompositeSupportedLocale;

// CallCompositeSupportedLocale provides a list of supported locales
CallComposite callComposite = 
    new CallCompositeBuilder()
        .localization(new CallCompositeLocalizationOptions(CallCompositeSupportedLocale.FR, LayoutDirection.LTR))
        .build();

LayoutDirection.RTL	LayoutDirection.LTR

Personalização de traduções

Há duas opções para personalizar as traduções de idiomas que fornecemos. Você pode usar a lista de chaves de localização para substituir uma cadeia de caracteres específica para o par chave/valor. Você pode especificar a localidade como um dos idiomas suportados. Quando uma chave não é fornecida, ela retornará a uma cadeia de caracteres de tradução suportada. Se você especificar um idioma sem suporte, deverá fornecer traduções para todas as chaves desse idioma (usando o string.xml arquivo) e, em seguida, retornar às cadeias de caracteres em inglês quando uma chave não for fornecida.

Digamos que você queira que a barra de controle use cadeias de caracteres da localidade Inglês (EUA), mas queira alterar o rótulo do botão Ingressar na Chamada para Iniciar Reunião no modo de exibição de configuração. Crie um string.xml arquivo (ou outro nome de arquivo) com o par chave/valor para as chaves selecionadas que você deseja substituir. O exemplo a seguir substitui a chave azure_communication_ui_calling_setup_view_button_join_call.

Para obter mais informações, consulte a biblioteca de interface do usuário do iOS de código aberto e o código de aplicativo de exemplo.

Deteção de idioma

Se o seu aplicativo oferecer suporte à localização, a Biblioteca da Interface do Usuário será exibida com base no idioma preferido do sistema do usuário, se fizer parte dos idiomas disponíveis listados na próxima seção. Caso contrário, o idioma assume como padrão as cadeias de caracteres predefinidas em inglês (en).

Línguas disponíveis

A tabela a seguir lista traduções prontas para locale. Caso queiras localizar o composto, insere locale em LocalizationOptions como opções em CallComposite.

Você também pode obter uma lista de locale estruturas usando a função SupportedLocale.valuesestática .

let locales: [Locale] = SupportedLocale.values.map{ $0.identifier }
print(locales)

// ["de", "de-DE", "en", "en-GB", "en-US", "es", "es-ES", "fr", "fr-FR", "it", "it-IT", "ja", "ja-JP", "ko", "ko-KR", "nl", "nl-NL", "pt", "pt-BR", "ru", "ru-RU", "tr", "tr-TR", "zh", "zh-Hans", "zh-Hans-CN", "zh-Hant", "zh-Hant-TW"]

Opções de Localização

LocalizationOptions é um wrapper de opções que define todas as cadeias de caracteres para componentes da Biblioteca da Interface do Usuário usando locale. Por padrão, todos os rótulos de texto usam cadeias de caracteres em inglês (en). Você pode usar LocalizationOptions para definir uma estrutura diferente locale . Pronta para uso, a biblioteca da interface do usuário inclui um conjunto de locale estruturas que podem ser usadas com os componentes e compostos da interface do usuário.

Para usar LocalizationOptions, especifique uma estrutura Swift locale (com ou sem um código de região) e passe para CallCompositeOptions. O exemplo a seguir localiza o composto para francês para França (fr-FR).

// Creating a Swift locale structure
var localizationOptions = LocalizationOptions(locale: Locale(identifier: "fr-FR"))

// Use IntelliSense SupportedLocale to get supported locale structures
localizationOptions = LocalizationOptions(locale: SupportedLocale.frFR)

let callCompositeOptions = CallCompositeOptions(localization: localizationOptions)
let callComposite = CallComposite(withOptions: callCompositeOptions)

Direção do layout

Certas culturas (por exemplo, árabe e hebraico) podem precisar de localização para ter layout da direita para a esquerda. Você pode especificar layoutDirection como parte do LocalizationOptions. O layout do composto será espelhado, mas o texto permanecerá na direção da cadeia de caracteres.

var localizationOptions: LocalizationOptions

// Initializer with locale and layoutDirection
localizationOptions = LocalizationOptions(locale: Locale(identifier: "en"),
                                          layoutDirection: .rightToLeft)

// Initializer with locale, localizableFilename, and layoutDirection
localizationOptions = LocalizationOptions(locale: Locale(identifier: "en"),
                                          localizableFilename: "Localizable",
                                          layoutDirection: .rightToLeft)

// Add localizationOptions as an option
let callCompositeOptions = CallCompositeOptions(localization: localizationOptions)
let callComposite = CallComposite(withOptions: callCompositeOptions)

O exemplo a seguir mostra o espelhamento de layout da direita para a esquerda. Se você não especificar layoutDirection, o padrão será false (layout da esquerda para a direita).

layoutDirection = .leftToRight (padrão)	layoutDirection = .rightToLeft

Personalização de traduções

Há duas opções para personalizar as traduções de idiomas que fornecemos. Para substituir uma cadeia de caracteres específica, você pode usar a lista de chaves de localização para o par chave/valor. Você pode especificar locale como um dos idiomas suportados. Quando uma chave não é fornecida, ela retorna a uma cadeia de caracteres de tradução suportada. Se você especificar um idioma sem suporte, deverá fornecer traduções para todas as chaves desse idioma (usando o Localizable.strings arquivo) e, em seguida, retornar às cadeias de caracteres em inglês quando uma chave não for fornecida.

Digamos que você queira que a barra de controle use cadeias de caracteres da localidade Inglês (EUA), mas queira alterar o rótulo do botão Ingressar na Chamada para Iniciar Reunião no modo de exibição de configuração. Ative a localização no projeto para a instância locale que pretende substituir. Crie um Localizable.strings arquivo (ou outro nome de arquivo com a extensão .strings) com o par chave/valor para as chaves selecionadas que você deseja substituir. O exemplo a seguir substitui a chave AzureCommunicationUI.SetupView.Button.JoinCall.

Para especificar que você está substituindo com Localizable.strings, crie um LocalizationOptions objeto para especificar locale e localizationFilename. Ou, quando está a usar o inicializador locale, ele examina as chaves em Localizable.strings para locale.collatorIdentifier como o idioma do seu projeto.

let localizationOptions = LocalizationOptions(locale: Locale(identifier: "fr"),
                                              localizableFilename: "Localizable")
let callCompositeOptions = CallCompositeOptions(localization: localizationOptions)
let callComposite = CallComposite(withOptions: callCompositeOptions)

Locução de acessibilidade para localização

Para que o voiceover funcione corretamente para uma localização, certifique-se de que o idioma foi adicionado às localizações da sua aplicação. Em seguida, o voiceover deteta que a aplicação suporta o idioma especificado em LocalizationOptions para locale. Ele seleciona a voz para o idioma usando a voz encontrada em Configurações>de Acessibilidade>Fala no dispositivo. Você pode verificar se o idioma foi adicionado ao seu projeto, conforme mostrado no exemplo a seguir.