Skip to main content

Qwen-Livetranslate-Realtime Flutter SDK

Flutter SDK を使用して Qwen-Livetranslate-Realtime に接続するためのガイドです。Dart の呼び出し順序、リクエストパラメーター、イベントを説明します。

Qwen-Livetranslate-Realtime はリアルタイム音声を翻訳します。翻訳テキストを受信するか、テキストと音声の両方を受信できます。

前提条件

  • 対象プラットフォームの Flutter 開発環境を用意します。サンプルアプリには Dart 3.4 以上、4.0 未満が必要です。
  • API キーを取得します。API キーと同じリージョンのサービスエンドポイントを選択します。ワークスペース専用ドメインを使用する場合は、ワークスペース ID も取得します。
モバイルアプリに有効期間の長い API キーをハードコードしないでください。一時 API キーに対応するモデルを使用する場合は、アプリケーションサーバーで一時 API キーを生成し、クライアントに送信します。

SDK のインストール

モバイル音声 SDK の選択とダウンロードを開き、Flutter タブからパッケージをダウンロードして展開します。 展開した SDK ディレクトリを Flutter プロジェクトの packages/aliyun_neonui にコピーし、pubspec.yaml にローカル依存関係を追加します。
dependencies:
  aliyun_neonui:
    path: packages/aliyun_neonui
flutter pub get を実行し、Dart ファイルで SDK をインポートします。
import 'package:aliyun_neonui/neonui.dart';

クイックスタート

サンプルアプリを実行する

  1. 対象のデバイスを接続し、展開した SDK ディレクトリで次のコマンドを実行します。
    cd example
    flutter pub get
    flutter run
    
  2. サンプルアプリのホーム画面で 百炼(DashScope) を開き、サービスエンドポイントを選択して API Key を入力します。ワークスペース専用ドメインを使用する場合は、WorkspaceId も入力します。
  3. Qwen-LiveTranslate 实时音视频翻译 を開き、サンプルを実行します。 録音サンプルを実行するには、マイクへのアクセスを許可してください。
完全なサンプルは SDK パッケージの example/lib/pages/dashscope/dash_live_translate_page.dart にあります。

同梱サンプルで選択できるモデル

  • qwen3.5-livetranslate-flash-realtime

呼び出し手順

NativeNui() で取得したインスタンスで、以下のメソッドを呼び出します。 リクエストパラメーターの接続用 JSON とタスク用 JSON を、それぞれ initJson と sessionJson に使用します。各呼び出しが成功してから次に進みます。
  1. メソッドを呼び出す前に eventStream と ttsAudioStream を購読します。
  2. 接続パラメーターとタスクパラメーターを設定してから、セッションを開始します。
    await nui.nuiInitialize(params: initJson);
    await nui.dialogSetParams(sessionJson);
    await nui.dialogStart(vadMode: VadMode.p2t.code, dialogParams: sessionJson);
    
  3. セッション開始後、音声を取得して sendAudio で PCM データを継続的に送信します。同梱の録音サンプルでは、16 kHz、16 ビット、モノラルの PCM を取得します。 iOS では、マイクを起動してからプレーヤーを起動します。プレーヤーがすでに起動している場合は、マイクの起動後にプレーヤーを再起動し、応答音声が再生されるようにします。
  4. 音声の取得を停止して dialogStop を呼び出します。最後のイベントを処理した後、nuiRelease を呼び出し、購読を解除します。

リクエストパラメーター

以下はパッケージに同梱するモデルのサンプルです。その他の設定については、パッケージ内の example/lib/dashscope_params.dart を参照してください。その他のパラメーターについては、WebSocket 接続ガイドをご参照ください。 YOUR_WS_HOST を対象リージョンの WebSocket ホスト名、YOUR_DEVICE_ID をデバイス識別子、YOUR_API_KEY をそのリージョンの API キーに置き換えます。

接続パラメーター

次の JSON は、文字列として Dart メソッドに渡します。
{
  "device_id": "YOUR_DEVICE_ID",
  "url": "wss://YOUR_WS_HOST/api-ws/v1/realtime?model=qwen3.5-livetranslate-flash-realtime",
  "service_mode": "1",
  "audio_update_manually": "false"
}

タスクパラメーター

次の JSON は、文字列として Dart メソッドに渡します。
{
  "apikey": "YOUR_API_KEY",
  "nls_config": {
    "sample_rate": 16000,
    "sr_format": "pcm",
    "modalities": "[\"text\",\"audio\"]",
    "source_language": "zh",
    "translation": "{\"language\":\"en\"}",
    "turn_detection": "{\"type\":\"server_vad\",\"threshold\":0.2,\"silence_duration_ms\":1000}"
  },
  "service_type": 4
}
URL のクエリパラメーター model で翻訳モデルを選択します。nls_config.model は任意の文字起こし用モデルです。translation は翻訳先の language を含む JSON 文字列です。source_language を省略すると入力言語を自動検出します。

API リファレンス

メソッド

戻り値が Future<int> のメソッドでは、結果コード 0 が成功を表します。sendAudio の戻り値の型は Future<Object?> です。
メソッドのシグネチャ用途
Future<int> nuiInitialize({required String params, int logLevel = 0, bool saveLog = false})接続パラメーターを JSON 文字列で渡して SDK を初期化します。
Future<int> dialogSetParams(String params)現在のセッションに JSON パラメーターを設定します。
Future<int> dialogStart({required int vadMode, String dialogParams = "{}"})セッションを開始します。vadMode は発話の区切り方を選択し、dialogParams はセッション固有の JSON 文字列を受け取ります。
Future<Object?> sendAudio(Uint8List data)PCM 音声のチャンクを送信します。
Future<int> dialogStop()現在の録音セッションを終了し、接続を維持します。
Future<int> dialogCancel()現在のセッションまたは合成タスクをキャンセルします。
Future<int> nuiRelease()SDK リソースを解放します。

イベントとオーディオストリーム

eventStream からイベントを受信します。イベントが Dart の Map の場合は、event でイベント名を確認し、resultCode でタスクのエラーを確認します。 ttsAudioStream から音声チャンクを受信し、アプリで再生します。
イベント用途
EVENT_ASR_PARTIAL_RESULT認識の途中結果
EVENT_RESULT_TRANSLATED翻訳結果
EVENT_RESULT_TRANSLATED_END現在の文の最終翻訳結果
EVENT_TRANSCRIBER_COMPLETEタスクまたは現在の音声出力が完了
EVENT_ASR_ERRORタスクの失敗