アプリをローカライズする

  • [アーティクル]

Microsoft Teams アプリをローカライズするには、次の要因を考慮してください。

  1. AppSource の一覧をローカライズします。
  2. アプリ マニフェスト内の文字列をローカライズします。
  3. ユーザーからのローカライズされたテキストの送信を処理します。

AppSource の一覧をローカライズする

アプリを Microsoft Teams ストアに発行する場合は、アプリを一覧表示する言語のメタデータ (説明、スクリーンショット、名前) を指定し、パートナー センターの Marketplace 登録情報 ページでこれらの言語を明示的に指定します。 詳細については、「 ローカライズされた Microsoft AppSource フロント」を参照してください。 Teams ストアでローカライズされた登録情報をサポートするには、登録情報に言語を追加できます。 登録情報の パートナー センター で指定する既定の言語情報 アプリの AppSource Web サイト の一覧。 現在、既定の言語は英語です。

ローカライズを構成する

アプリの追加言語を構成するには、 パートナー センターで、英語とアプリの追加言語の両方を選択します。 次の例では、フランス語を追加の言語として使用します。

  1. 英語を追加する
    • アプリ名を入力します。
    • アプリの簡単な説明を英語で入力します。
    • アプリの長い説明を英語で入力します。
    • 長い説明に「: このアプリはフランス語で使用できます」と入力します。
    • アプリ UI の画像 (英語) をアップロードします。
  2. フランス語の追加
    • アプリ名を入力します。
    • フランス語でアプリの簡単な説明を入力します。
    • フランス語でアプリの長い説明を入力します。
    • アプリ UI の画像 (フランス語) をアップロードします。

英語でアップロードした画像は、AppSource で使用されます。

アプリ マニフェストで文字列をローカライズする

Microsoft Teams アプリ スキーマ v1.5 以降を使用して、アプリをローカライズします。 これを行うには、manifest.json ファイルの属性を 以上に設定$schemaし、プロパティをmanifestVersionバージョン (1.5この場合) に$schema更新https://developer.microsoft.com/json-schemas/teams/v1.5/MicrosoftTeams.schema.jsonします。

アプリケーションで localizationInfo サポートされている既定の言語で プロパティを追加します。 既定の言語は、ユーザーのクライアント設定が追加の言語と一致しない場合、最終的なフォールバック言語として使用されます。

注:

マニフェスト のバージョンは、manifest.json ファイルと localization.json ファイルの両方で同じである必要があります。

manifest.json の変更の例

次 manifest.json は、アプリケーションで localizationInfo サポートされている既定の言語と共 additionalLanguagesに プロパティを追加するのに役立ちます。

{
  "$schema": "https://developer.microsoft.com/json-schemas/teams/v1.5/MicrosoftTeams.schema.json",
  "manifestVersion": "1.5",
  "localizationInfo": {
  "defaultLanguageTag": "en",
  "additionalLanguages": [
   {
    "languageTag": "es-mx",
    "file": "es-mx.json"
   }
  ]
 }
  ...
}

ローカライズの例 .json の変更

ローカライズ .json の例を次に示します。

{
  "$schema": "https://developer.microsoft.com/json-schemas/teams/v1.5/MicrosoftTeams.Localization.schema.json",
  "manifestVersion": "1.5",
  "name.short": "Localización",
  "name.full": "Aplicación de localización",
  ...
}

マニフェスト内のすべてのユーザー向け文字列の翻訳を含む追加の .json ファイルを提供できます。 これらのファイルは ローカライズ ファイル JSON スキーマ に準拠している必要があり、マニフェストのプロパティに localizationInfo 追加する必要があります。 各ファイルは、Teams や Outlook などの Microsoft 365 ホスト アプリケーションを使用して適切な文字列を選択する言語タグに関連付けられています。 言語タグは の形式をとりますが、目的の <language>-<region> 言語を <region> サポートするすべてのリージョンをターゲットにするには、この部分を省略できます。

Microsoft 365 ホスト アプリケーションは、既定の言語文字列 ( ユーザーの言語のみ文字列 -> ユーザーの言語 + ユーザーのリージョン文字列)> の順序で文字列を適用します。

たとえば、既定のfr言語 (フランス語、すべてのリージョン)、および (英語、すべてのリージョン) と en-gb (英語、英国) のen追加言語ファイルを指定すると、ユーザーの言語は にen-gb設定されます。 言語の選択に基づいて、次の変更が行われます。

  1. Microsoft 365 ホスト アプリケーションは、文字列を fr 受け取り、文字列で en 上書きします。
  2. 文字列を en 文字列で上書きします en-gb 。

ユーザーの言語が に en-ca設定されている場合、言語の選択に基づいて次の変更が行われます。

  1. Microsoft 365 ホスト アプリケーションは、文字列を fr 受け取り、文字列で en 上書きします。
  2. ローカライズは指定されていない en-ca ので en 、ローカライズが使用されます。

ユーザーの言語が に es-es設定されている場合、Microsoft 365 ホスト アプリケーションは文字列を fr 受け取ります。 Microsoft 365 ホスト アプリケーションでは、言語ファイルが指定eses-esされていないため、文字列はオーバーライドされません。

そのため、マニフェストで最上位レベルの言語のみの翻訳を指定する必要があります。 たとえば、 en ではなく en-usです。 リージョン レベルのオーバーライドは、それらを必要とするいくつかの文字列に対してのみ指定する必要があります。

manifest.json の変更の例

変更は manifest.json 、次の例に示されています。

{
  ...
  "localizationInfo": {
    "defaultLanguageTag": "en",
    "additionalLanguages": [
      {
        "languageTag": "en-gb",
        "file": "en-gb.json"
      },
      {
        "languageTag": "fr",
        "file": "fr.json"
      },
      {
        "languageTag": "pl",
        "file": "pl.json"
      }
    ]
  }
  ...
}

ローカライズ .json ファイルの例

変更は localization.json 、次の例に示されています。

{
  "$schema": "https://developer.microsoft.com/json-schemas/teams/v1.8/MicrosoftTeams.Localization.schema.json",
  "name.short": "Le App",
  "name.full": "App pour Microsoft Teams",
  "description.short": "Créez d'excellentes applications pour Microsoft Teams avec App.",
  "description.full": "Créez de nouvelles applications Microsoft Teams, concevez et prévisualisez des cartes bot, et explorez la documentation avec App.",
  "staticTabs[0].name": "Editeur de manifest",
  "staticTabs[1].name": "Editeur de cartes",
  "staticTabs[2].name": "Bibliothèque de contrôles",
  "bots[0].commandLists[0].commands[0].title": "chercher",
  "bots[0].commandLists[0].commands[0].description": "Rechercher la documentation Teams pertinente"
}

ユーザーからのローカライズされたテキストの送信を処理する

ローカライズされたバージョンのアプリケーションを指定すると、ユーザーは同じ言語で応答します。 Teams ではユーザーの申請が既定の言語に翻訳されないため、アプリはローカライズされた言語の応答を処理する必要があります。 たとえば、ローカライズされた を指定した commandList場合、ボットへの応答は、既定の言語ではなく、コマンドのローカライズされたテキストです。 アプリは適切に応答する必要があります。

コード サンプル

サンプルの名前 説明 .NET Node.js
アプリのローカライズ ボットとタブを使用した Teams アプリのローカライズ。 表示 表示

次の手順

JSON スキーマの参照のローカライズ

関連項目