azure-communication-callingserver-java について
非推奨となったAzure Communication CallingServer SDKを使うJavaプロジェクトの保守ガイドです。旧来の使い方と移行時の注意点を扱い、新規開発では`azure-communication-callautomation`を使うよう案内します。
主な機能
- 01旧CallingServerクライアントのガイド
- 02旧通話録音の例
- 03移行時のクラス名対応表
- 04新規開発向け代替案の案内
活用シーン
- 01既存CallingServerコードの保守
- 02Call Automationへの移行計画
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ sickn33/ agentic-awesome-skills --skill azure-communication-callingserver-javaインストール後、Claude Code で/azure-communication-callingserver-javaを入力して読み込まれたか確認します。
詳細
Azure Communication CallingServer(Java)- 非推奨
⚠️ 非推奨:この SDK は Call Automation に名称変更されました。新しいプロジェクトでは、代わりに
azure-communication-callautomationを使用してください。このスキルはレガシーコードの保守専用です。
Call Automation への移行
<dependency>
<groupId>com.azure</groupId>
<artifactId>azure-communication-callingserver</artifactId>
<version>1.0.0-beta.5</version>
</dependency>
<dependency>
<groupId>com.azure</groupId>
<artifactId>azure-communication-callautomation</artifactId>
<version>1.6.0</version>
</dependency>
クラス名の変更
| CallingServer(旧) | Call Automation(新) |
|---|---|
CallingServerClient | CallAutomationClient |
CallingServerClientBuilder | CallAutomationClientBuilder |
CallConnection | CallConnection(同じ) |
ServerCall | 削除済み - CallConnection を使用 |
レガシークライアントの作成
// OLD WAY (deprecated)
import com.azure.communication.callingserver.CallingServerClient;
import com.azure.communication.callingserver.CallingServerClientBuilder;
CallingServerClient legacyClient = new CallingServerClientBuilder()
.connectionString("<connection-string>")
.buildClient();
// NEW WAY
import com.azure.communication.callautomation.CallAutomationClient;
import com.azure.communication.callautomation.CallAutomationClientBuilder;
CallAutomationClient automationClient = new CallAutomationClientBuilder()
.connectionString("<connection-string>")
.buildClient();
レガシー録音
// OLD WAY
StartRecordingOptions options = new StartRecordingOptions(serverCallId)
.setRecordingStateCallbackUri(callbackUri);
StartCallRecordingResult result = legacyClient.startRecording(options);
String recordingId = result.getRecordingId();
legacyClient.pauseRecording(recordingId);
legacyClient.resumeRecording(recordingId);
legacyClient.stopRecording(recordingId);
// NEW WAY - see azure-communication-callautomation skill
新規開発の場合
新しいプロジェクトでは、この SDK を使用しないでください。
以下については、azure-communication-callautomation-java スキルを参照してください。
- 発信通話の発信
- 着信への応答
- 通話の録音
- DTMF の認識
- テキスト読み上げ/音声認識
- 参加者の追加/削除
- 通話の転送
トリガーフレーズ
- 「callingserver のレガシー版」、「非推奨の通話 SDK」
- 「callingserver から callautomation への移行」
使用する場合
過去の CallingServer コードの保守、または azure-communication-callautomation-java への移行計画の場合にのみ使用してください。廃止されたパッケージを使用して新しい統合を開始しないでください。
制限事項
- レガシーと新しいスニペットは別々の断片であり、そのまま置き換えられる移行手順ではありません。確認済みのパッケージバージョンを固定し、正確な置き換え先 API を検証してください。レガシーの録音オプションに Call Automation との互換性があるとは限りません。
- 通話制御と録音は、実際の参加者、費用、機密性の高い通信に影響する可能性があります。通話/アカウントの権限と必要な参加者の同意を得て、認証情報をコードやログに含めないでください。また、これらの例を検証する目的だけで通話を発信したり録音したりしないでください。
- 出力を、環境固有の検証、テスト、または専門家によるレビューの代わりとして扱わないでください。
- 必要な入力、権限、安全上の境界、または成功基準が不足している場合は、停止して確認を求めてください。
コメント
Markdown 対応