Azure Communication Services Java 常用库

<dependency>
    <groupId>com.azure</groupId>
    <artifactId>azure-communication-common</artifactId>
    <version>1.4.0</version>
</dependency>

import com.azure.communication.common.CommunicationTokenCredential;
// 简单的静态令牌 - 不刷新
String userToken = "<user-access-token>";
CommunicationTokenCredential credential = new CommunicationTokenCredential(userToken);
// 用于 Chat、Calling 等服务
ChatClient chatClient = new ChatClientBuilder()
    .endpoint("https://<resource>.communication.azure.com")
    .credential(credential)
    .buildClient();

import com.azure.communication.common.CommunicationTokenRefreshOptions;
import java.util.concurrent.Callable;
// 令牌刷新回调 - 在令牌即将过期时调用
Callable<String> tokenRefresher = () -> {
    // 调用您的服务器以获取新令牌
    return fetchNewTokenFromServer();
};
// 配置主动刷新
CommunicationTokenRefreshOptions refreshOptions = new CommunicationTokenRefreshOptions(tokenRefresher)
    .setRefreshProactively(true)      // 在过期前刷新
    .setInitialToken(currentToken);    // 可选的初始令牌
CommunicationTokenCredential credential = new CommunicationTokenCredential(refreshOptions);

import java.util.concurrent.CompletableFuture;
// 异步令牌获取器
Callable<String> asyncRefresher = () -> {
    CompletableFuture<String> future = fetchTokenAsync();
    return future.get();  // 阻塞直到令牌可用
};
CommunicationTokenRefreshOptions options = new CommunicationTokenRefreshOptions(asyncRefresher)
    .setRefreshProactively(true);
CommunicationTokenCredential credential = new CommunicationTokenCredential(options);

import com.azure.identity.InteractiveBrowserCredentialBuilder;
import com.azure.communication.common.EntraCommunicationTokenCredentialOptions;
import java.util.Arrays;
import java.util.List;
// 用于 Teams Phone 扩展性
InteractiveBrowserCredential entraCredential = new InteractiveBrowserCredentialBuilder()
    .clientId("<your-client-id>")
    .tenantId("<your-tenant-id>")
    .redirectUrl("<your-redirect-uri>")
    .build();
String resourceEndpoint = "https://<resource>.communication.azure.com";
List<String> scopes = Arrays.asList(
    "https://auth.msft.communication.azure.com/TeamsExtension.ManageCalls"
);
EntraCommunicationTokenCredentialOptions entraOptions = 
    new

## 通信标识符 (Communication Identifiers)

CommunicationUserIdentifier

### PhoneNumberIdentifier

### MicrosoftTeamsUserIdentifier

### UnknownIdentifier

## 标识符解析 (Identifier Parsing)

## 标识符类型检查 (Type Checking Identifiers)

## 令牌访问 (Token Access)

ntial(token);

// 同步访问
AccessToken accessToken = credential.getToken();
System.out.println("Token 过期时间: " + accessToken.getExpiresAt());
// 异步访问
credential.getTokenAsync()
    .subscribe(token -> {
        System.out.println("Token: " + token.getToken().substring(0, 20) + "...");
        System.out.println("过期时间: " + token.getExpiresAt());
    });

// 完成后清理
credential.close();
// 或使用 try-with-resources
try (CommunicationTokenCredential cred = new CommunicationTokenCredential(options)) {
    // 使用凭据
    chatClient.doSomething();
}

import com.azure.communication.common.CommunicationCloudEnvironment;
// 可用环境
CommunicationCloudEnvironment publicCloud = CommunicationCloudEnvironment.PUBLIC;
CommunicationCloudEnvironment govCloud = CommunicationCloudEnvironment.GCCH;
CommunicationCloudEnvironment dodCloud = CommunicationCloudEnvironment.DOD;
// 在 Teams 标识符上设置
MicrosoftTeamsUserIdentifier teamsUser = new MicrosoftTeamsUserIdentifier("<user-id>")
    .setCloudEnvironment(CommunicationCloudEnvironment.GCCH);

AZURE_COMMUNICATION_ENDPOINT=https://<resource>.communication.azure.com
AZURE_COMMUNICATION_USER_TOKEN=<user-access-token>

// 模式：为聊天/通话客户端创建凭据
public ChatClient createChatClient(String token, String endpoint) {
    CommunicationTokenRefreshOptions refreshOptions = 
        new CommunicationTokenRefreshOptions(this::refreshToken)
            .setRefreshProactively(true)
            .setInitialToken(token);
    
    CommunicationTokenCredential credential = 
        new CommunicationTokenCredential(refreshOptions);
    
    return new ChatClientBuilder()
        .endpoint(endpoint)
        .credential(credential)
        .buildClient();
}
private String refreshToken() {
    // 调用您的 Token 端点
    return tokenService.getNewToken();
}