azure-communication-callingserver-java

Azure Communication CallingServer（Java）技能——已弃用

⚠️ 已弃用说明

该 SDK 已更名为 Call Automation。对于新项目，请改用 azure-communication-callautomation。本技能仅用于维护遗留代码。

一、用途

本技能面向仍在维护使用 Azure Communication CallingServer Java SDK 的历史项目的开发者，用于识别遗留用法、理解新旧名称对应关系，并规划向 Call Automation 的迁移。其明确限制是：不要在新的集成中使用这个已退役的包。

二、新旧名称对照

CallingServer（旧）与 Call Automation（新）的对应关系如下：

CallingServerClient → CallAutomationClient
CallingServerClientBuilder → CallAutomationClientBuilder
CallConnection → CallConnection（名称相同）
ServerCall → 已移除，改用 CallConnection

三、依赖坐标（旧）

旧版依赖为 Maven 坐标：

<dependency> <groupId>com.azure</groupId> <artifactId>azure-communication-callingserver</artifactId> <version>1.0.0-beta.5</version> </dependency>

四、客户端创建（旧写法与新写法）

旧写法（已弃用）：

// 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);

新写法请参见 azure-communication-callautomation 技能。

六、新开发应参考的能力

对于新项目，请勿使用本 SDK。可参考 azure-communication-callautomation-java 技能了解以下能力：

发起外呼
应答来电
通话录音
DTMF 识别
文本转语音 / 语音转文本
添加/移除参与者
通话转移

七、触发短语

"callingserver legacy"、"deprecated calling SDK"
"migrate callingserver to callautomation"

八、适用时机

仅在维护历史 CallingServer 代码或规划迁移到 azure-communication-callautomation-java 时使用；不要用已退役的包开始新的集成。

九、限制与注意事项

旧版与新写法的代码片段是并列的替代片段，并非可直接替换的迁移方案。请固定经过审查的包版本，并核实确切的替代 API；不应假定旧版录音选项与 Call Automation 兼容。
通话控制和录音会影响真实参与者，涉及成本与敏感通信。请获取通话/账户授权和必要的参与者同意，确保凭据不出现在代码或日志中，切勿仅为验证这些示例而拨打或录制通话。
不要将输出视为针对特定环境的验证、测试或专家评审的替代。
如果缺少必要的输入、权限、安全边界或成功标准，应停止并向对方请求澄清。

技能介绍