/azure-communication-callingserver-java

Azure Communication CallingServer Java SDK - Migration Guide

⚠️ DEPRECATED: This SDK has been renamed to Call Automation. For new projects, use azure-communication-callautomation instead.

Migration Summary

The azure-communication-callingserver package is deprecated. All new development should use azure-communication-callautomation.

Dependency Change

<!-- OLD (deprecated) -->
<dependency>
    <groupId>com.azure</groupId>
    <artifactId>azure-communication-callingserver</artifactId>
    <version>1.0.0-beta.5</version>
</dependency>

<!-- NEW (use this instead) -->
<dependency>
    <groupId>com.azure</groupId>
    <artifactId>azure-communication-callautomation</artifactId>
    <version>1.6.0</version>
</dependency>

Class Name Changes

Client Creation Migration

Old Way (Deprecated)

import com.azure.communication.callingserver.CallingServerClient;
import com.azure.communication.callingserver.CallingServerClientBuilder;

CallingServerClient client = new CallingServerClientBuilder()
    .connectionString("<connection-string>")
    .buildClient();

New Way (Recommended)

import com.azure.communication.callautomation.CallAutomationClient;
import com.azure.communication.callautomation.CallAutomationClientBuilder;

CallAutomationClient client = new CallAutomationClientBuilder()
    .connectionString("<connection-string>")
    .buildClient();

Recording Migration

Old Way

StartRecordingOptions options = new StartRecordingOptions(serverCallId)
    .setRecordingStateCallbackUri(callbackUri);

StartCallRecordingResult result = client.startRecording(options);
String recordingId = result.getRecordingId();

client.pauseRecording(recordingId);
client.resumeRecording(recordingId);
client.stopRecording(recordingId);

New Way

See the azure-communication-callautomation skill for the new recording API.

For New Development

Use the azure-communication-callautomation skill for:

• Making outbound calls
• Answering incoming calls
• Call recording
• DTMF recognition
• Text-to-speech / speech-to-text
• Adding/removing participants
• Call transfer

Reference

See the Call Automation skill for complete documentation.