ライブ字幕翻訳（プライベートベータ）

Vonage Videoセッションの参加者のために、リアルタイムのキャプションをさまざまな言語に翻訳するには、Live Captions Translationを使用します。

プライベートベータ

注：ライブ字幕翻訳は プライベートベータ 機能あなたのプロジェクトでライブキャプション翻訳を有効にするには、お問い合わせください。

プライベート・ベータは、選ばれたお客様が機能のプレビューと評価を行い、フィードバックを提供するために利用できます。フィードバックを取り入れ、お客様のニーズに製品を適合させるために、APIやお客様のコードに影響を与える破壊的な変更が必要になる場合があります。製品が一般に利用可能になった後、プライベート・ベータ期間中に記述されたコードを修正する必要が生じる可能性があることをご了承ください。

このページには以下のセクションがあります：

プライベートベータ
概要
セッションレベルの翻訳
パブリッシャーレベルの入力言語
加入者レベルの翻訳
対応言語
備考

概要

ライブ字幕翻訳はライブ・キャプション機能では、キャプションのリアルタイム翻訳が追加されます。ライブ・キャプションでは、音声は話し言葉で書き起こされます。ライブ・キャプション・トランスレーションを使えば、参加者のためにキャプションを自動的に異なる言語に翻訳することができます。

ライブ・キャプション翻訳を使用する前に、次のことを確認してください。ライブ・キャプション機能には、以下の方法が含まれる。 REST APIを使用してキャプションを開始するそして、その方法はクライアント SDK で字幕の購読を行う.

翻訳は2つのレベルで有効にできる：

セッションレベルの翻訳 - サーバーサイドAPI経由でキャプションを開始するときに、すべての参加者の翻訳言語を設定します。
加入者レベルの翻訳 - 個々の購読者は、セッションレベルの設定とは別に、クライアントSDKを使用して独自の翻訳言語を選択します。

この2つのレベルは、一緒に使うことも、独立して使うこともできる。

セッションレベルの翻訳

を呼び出すときキャプションREST APIを開始 (POST /v2/project/<apiKey>/captions)、オプションの targetLanguageCode パラメータをリクエストボディに追加する：

{
  "sessionId": "<session-id>",
  "token": "A valid OpenTok token with the role set to moderator",
  "languageCode": "en-US",
  "targetLanguageCode": "es-ES",
  "maxDuration": 1800,
  "partialCaptions": true
}

targetLanguageCode (文字列) - (オプション) ターゲット翻訳言語のBCP-47言語コード( 対応言語リスト).設定すると、セッションのすべての参加者は、オリジナルの書き起こし言語ではなく、指定された言語で翻訳されたキャプションを受け取ります。

振る舞い：

もし targetLanguageCode は 未設定 (または省略)、キャプションは通常通り機能する。 languageCode.
もし targetLanguageCode が設定されているデフォルトでは、セッションのすべての参加者は、指定された言語に翻訳されたキャプションを受信します。
自分の翻訳言語を設定した購読者 ( 加入者レベルの翻訳) は、セッションレベルの targetLanguageCode.

パブリッシャーレベルの入力言語

パブリッシャーは、クライアントSDKを使用して話している言語を指定することで、キャプションサービスが音声を正しく解釈できるようにすることができます。これは、異なるパブリッシャーがそれぞれ異なる言語を話す多言語セッションにおいて役立ちます。パブリッシャーレベルの入力言語は、セッション中いつでも変更可能です。

Vonage Video API クライアント SDK のいずれかを使用して、パブリッシャーの入力言語を設定できます。これには、以下のものが含まれます。ウェブ（OpenTok.js）, iOS, アンドロイド, ウィンドウズそしてリナックス. 以下に、各プラットフォームごとの参考例を示します。

入力言語の設定（Web）

デフォルトでは、キャプションの入力言語は設定されていません（null)、サーバーが languageCode キャプションの開始時に定義されます。特定のパブリッシャーの入力言語を変更するには、 setCaptionsInputLanguage 有効なBCP-47言語コードを持つ。パス null デフォルト設定に戻すには。

// Example BCP-47 language code for captions input language
const captionsLanguageCode = 'fr-FR'

// Set the publisher's captions input language
try {
    await publisher.setCaptionsInputLanguage(captionsLanguageCode)
} catch (err) {
    console.error(`Failed to set captions input language: ${err.message}`)
}

// Pass null to revert to the default language
try {
    await publisher.setCaptionsInputLanguage(null)
} catch (err) {
    console.error(`Failed to revert captions input language: ${err.message}`)
}

現在の入力言語を取得する（Web）

用途 getCaptionsInputLanguage 発行者が現在設定している入力言語を確認するため。選択されている BCP-47 言語コードを返すか、 null 入力言語が設定されていない場合。

const captionsLanguage = publisher.getCaptionsInputLanguage()
if (captionsLanguage) {
    console.log(`Captions input language is set to: ${captionsLanguage}`)
} else {
    console.log('No input language set; using the session default.')
}

入力言語の設定（Android）

を使用する。 setCaptionsInputLanguage() PublisherKit オブジェクトのメソッドを使用して、入力言語を設定します。渡す null をクリックするとデフォルトの言語に戻ります。

// Set the publisher's captions input language
publisher.setCaptionsInputLanguage("fr-FR");

// Revert to the default language
publisher.setCaptionsInputLanguage(null);

現在の入力言語を取得する（Android）

を使用する。 getCaptionsInputLanguage() 発行者が現在設定している入力言語を確認する方法。選択されている BCP-47 言語コードを返すか、あるいは null 入力言語が設定されていない場合。

String captionsLanguage = publisher.getCaptionsInputLanguage();
if (captionsLanguage != null) {
    Log.d(TAG, "Captions input language is set to: " + captionsLanguage);
} else {
    Log.d(TAG, "No input language set; using the session default.");
}

入力言語の設定（iOS）

を設定する。 captionsInputLanguage OTPublisherKit オブジェクトのプロパティを、目的の BCP-47 言語コードに設定します。これを nil をクリックするとデフォルトの言語に戻ります。

// Set the publisher's captions input language
publisher.captionsInputLanguage = @"fr-FR";

// Revert to the default language
publisher.captionsInputLanguage = nil;

現在の入力言語を取得する（iOS）

続きを読む captionsInputLanguage このプロパティは、パブリッシャーの現在設定されている入力言語を確認するためのものです。選択されている BCP-47 言語コードを返します。あるいは、 nil 入力言語が設定されていない場合。

NSString *captionsLanguage = publisher.captionsInputLanguage;
if (captionsLanguage) {
    NSLog(@"Captions input language is set to: %@", captionsLanguage);
} else {
    NSLog(@"No input language set; using the session default.");
}

入力言語の設定（Windows）

を設定する。 CaptionsInputLanguage Publisher オブジェクトのプロパティを、目的の BCP-47 言語コードに設定します。これを null をクリックするとデフォルトの言語に戻ります。

// Set the publisher's captions input language
publisher.CaptionsInputLanguage = "fr-FR";

// Revert to the default language
publisher.CaptionsInputLanguage = null;

現在の入力言語を取得する（Windows）

続きを読む CaptionsInputLanguage このプロパティは、パブリッシャーの現在設定されている入力言語を確認するためのものです。選択されている BCP-47 言語コードを返します。あるいは、 null 入力言語が設定されていない場合。

string captionsLanguage = publisher.CaptionsInputLanguage;
if (captionsLanguage != null)
{
    Console.WriteLine($"Captions input language is set to: {captionsLanguage}");
}
else
{
    Console.WriteLine("No input language set; using the session default.");
}

入力言語の設定（Linux）

を使用する。 otc_publisher_set_captions_input_language 発行者の入力言語を設定する関数。以下を渡します。 NULL をクリックするとデフォルトの言語に戻ります。

// Set the publisher's captions input language
otc_publisher_set_captions_input_language(publisher, "fr-FR");

// Revert to the default language
otc_publisher_set_captions_input_language(publisher, NULL);

現在の入力言語の取得（Linux）

用途 otc_publisher_get_captions_input_language 発行者が現在設定している入力言語を確認するため。選択されている BCP-47 言語コードを返すか、 NULL 入力言語が設定されていない場合。

const char* captionsLanguage = otc_publisher_get_captions_input_language(publisher);
if (captionsLanguage != NULL) {
    printf("Captions input language is set to: %s\n", captionsLanguage);
} else {
    printf("No input language set; using the session default.\n");
}

加入者レベルの翻訳

購読者は、クライアントSDKを使用して独自の翻訳言語を選択することができ、セッション中にいつでも変更することができます。これは、セッションレベルの targetLanguageCode.

Vonage Video APIのクライアントSDK（以下を含む）のいずれを使用しても、加入者レベルの変換を設定できます。ウェブ（OpenTok.js）, iOS, アンドロイド, ウィンドウズそしてリナックス. 以下に、各プラットフォームごとの参考例を示します。

翻訳言語の設定（Web）

デフォルトのキャプション言語は languageCode (または targetLanguageCode) を Start Captions API で設定します。特定の購読者の翻訳言語を変更するには setCaptionsTranslationLanguage 有効なBCP-47言語コードを持つ。パス null をクリックするとデフォルトの言語に戻ります。

// Example BCP-47 language code for captions translation
const captionsLanguageCode = 'es-ES'

// Set the subscriber's captions translation language
try {
    await subscriber.setCaptionsTranslationLanguage(captionsLanguageCode)
} catch (err) {
    console.error(`Failed to set captions translation language: ${err.message}`)
}

// Pass null to revert to the default language
try {
    await subscriber.setCaptionsTranslationLanguage(null)
} catch (err) {
    console.error(`Failed to revert captions translation language: ${err.message}`)
}

現在の翻訳言語を取得する (Web)

用途 getCaptionsTranslationLanguage を使用して、加入者が現在選択している翻訳言語を確認します。これは、選択されたBCP-47言語コードを返します。 null 翻訳言語が設定されていない場合

const captionsLanguage = subscriber.getCaptionsTranslationLanguage()
if (captionsLanguage) {
    console.log(`Captions translation language is set to: ${captionsLanguage}`)
} else {
    console.log('No translation language set; using the session default.')
}

翻訳言語の設定（Android）

を使用する。 setCaptionsTranslationLanguage() メソッドを使用して、翻訳言語を設定します。渡す null をクリックするとデフォルトの言語に戻ります。

// Set the subscriber's captions translation language
subscriber.setCaptionsTranslationLanguage("es-ES");

// Revert to the default language
subscriber.setCaptionsTranslationLanguage(null);

現在の翻訳言語を取得する（Android）

を使用する。 getCaptionsTranslationLanguage() メソッドを使用して、サブスクライバが現在選択している翻訳言語をチェックします。このメソッドは、選択された BCP-47 言語コードを返します。 null 翻訳言語が設定されていない場合

String captionsLanguage = subscriber.getCaptionsTranslationLanguage();
if (captionsLanguage != null) {
    Log.d(TAG, "Captions translation language is set to: " + captionsLanguage);
} else {
    Log.d(TAG, "No translation language set; using the session default.");
}

翻訳言語の設定（iOS）

を設定する。 captionsTranslationLanguage プロパティを希望のBCP-47言語コードに設定します。に設定してください。 nil をクリックするとデフォルトの言語に戻ります。

// Set the subscriber's captions translation language
subscriber.captionsTranslationLanguage = @"es-ES";

// Revert to the default language
subscriber.captionsTranslationLanguage = nil;

現在の翻訳言語を取得する（iOS）

続きを読む captionsTranslationLanguage プロパティを使用して、サブスクライバが現在選択している翻訳言語を確認します。これは、選択された BCP-47 言語コードを返します。 nil 翻訳言語が設定されていない場合

NSString *captionsLanguage = subscriber.captionsTranslationLanguage;
if (captionsLanguage) {
    NSLog(@"Captions translation language is set to: %@", captionsLanguage);
} else {
    NSLog(@"No translation language set; using the session default.");
}

翻訳言語の設定（Windows）

を設定する。 CaptionsTranslationLanguage プロパティを、必要な BCP-47 言語コードに設定します。に設定します。 null をクリックするとデフォルトの言語に戻ります。

// Set the subscriber's captions translation language
subscriber.CaptionsTranslationLanguage = "es-ES";

// Revert to the default language
subscriber.CaptionsTranslationLanguage = null;

現在の翻訳言語を取得する（Windows）

続きを読む CaptionsTranslationLanguage プロパティを使用して、サブスクライバが現在選択している翻訳言語を確認します。これは、選択された BCP-47 言語コードを返します。 null 翻訳言語が設定されていない場合

string captionsLanguage = subscriber.CaptionsTranslationLanguage;
if (captionsLanguage != null)
{
    Console.WriteLine($"Captions translation language is set to: {captionsLanguage}");
}
else
{
    Console.WriteLine("No translation language set; using the session default.");
}

対応言語

ライブ・キャプション翻訳は、ライブ・キャプションと同じBCP-47言語コードを使用します。言語コードは対応言語リスト利用可能な言語の全リストはこちら。

備考

ライブ字幕翻訳に必要なものライブ・キャプションを使用してセッションをアクティブにする必要があります。キャプションはキャプションAPIの開始翻訳が可能になる前に。
購読者レベルの翻訳言語を設定することは、セッションレベルの翻訳言語を上書きします。 targetLanguageCode その加入者だけのために。パッシング null はサブスクライバをデフォルトの動作(セッションレベル targetLanguageCode がセットされていれば、そうでなければ元の languageCode).
アーキテクチャ、キャプションの公開、キャプションの購読、ステータスウェブフック、既知の問題など、ライブキャプション機能の基本的なドキュメントについてはライブ字幕ガイド.