Java 用 Azure Communication Chat クライアントライブラリ - バージョン 1.3.13

[アーティクル]
10/21/2023

Azure Communication Chat には、Azure Communication Servicesのチャットアプリケーションで使用される API が含まれています。

ソースコード | パッケージ (Maven) | API リファレンスドキュメント | 製品ドキュメント

作業の開始

前提条件

アクティブなサブスクリプションが含まれる Azure アカウント。無料でアカウントを作成できます。
Java Development Kit (JDK) バージョン 8 以降。
Apache Maven。
デプロイ済みの Communication Services リソース。 Azure Portal またはAzure PowerShellを使用して設定できます。

パッケージを組み込む

BOM ファイルを含める

ライブラリの一般提供 (GA) バージョンに依存するには、azure-sdk-bom をプロジェクトに含めてください。次のスニペットでは、{bom_version_to_target} プレースホルダーをバージョン番号に置き換えます。 BOM の詳細については、 AZURE SDK BOM README に関するページを参照してください。

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>com.azure</groupId>
            <artifactId>azure-sdk-bom</artifactId>
            <version>{bom_version_to_target}</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

次に、バージョンタグのない依存関係セクションに直接依存関係を含めます。

<dependencies>
  <dependency>
    <groupId>com.azure</groupId>
    <artifactId>azure-communication-chat</artifactId>
  </dependency>
</dependencies>

直接依存関係を含める

BOM に存在しないライブラリの特定のバージョンに依存する場合は、次のように直接依存関係をプロジェクトに追加します。

<dependency>
    <groupId>com.azure</groupId>
    <artifactId>azure-communication-chat</artifactId>
    <version>1.3.13</version>
</dependency>

主要な概念

チャット会話は、チャットスレッドによって表されます。チャットスレッド内の各ユーザーは、参加者と呼ばれます。参加者は、1 対 1 のチャットで個人的にチャットしたり、1:N グループチャットに参加したりできます。

クラスとクラスをChatClientChatThreadClient初期化したら、次のチャット操作を実行できます。

チャットスレッドの作成、取得、一覧表示、更新、削除

チャットメッセージの送信、取得、一覧表示、更新、削除

参加者の取得、追加、削除

開封確認メッセージを送信して取得する

共同作成

このプロジェクトでは、共同作成と提案を歓迎しています。ほとんどの共同作成では、共同作成者使用許諾契約書 (CLA) にご同意いただき、ご自身の共同作成内容を使用する権利を Microsoft に供与する権利をお持ちであり、かつ実際に供与することを宣言していただく必要があります。

pull request を送信すると、CLA を提供して PR (ラベル、コメントなど) を適宜装飾する必要があるかどうかを CLA ボットが自動的に決定します。ボットによって提供される手順にそのまま従ってください。この操作は、Microsoft の CLA を使用するすべてのリポジトリについて、1 回だけ行う必要があります。

このプロジェクトでは、Microsoft オープンソースの倫理規定を採用しています。詳しくは、「Code of Conduct FAQ (倫理規定についてよくある質問)」を参照するか、opencode@microsoft.com 宛てに質問またはコメントをお送りください。

Azure Communication Resource エンドポイントの作成後に設定する

endpoint = "https:// Azure-Communication-Resource-Name.communications.azure.com"

ユーザーアクセストークンを要求する

ユーザーのアクセストークンを使用することで、Azure Communication Services に対して直接認証を行うクライアントアプリケーションを作成できます。サーバーでこれらのトークンを生成し、クライアントデバイスに渡してから、それらを使用して Communication Services SDK を初期化します。

ユーザーアクセストークンからユーザーアクセストークンを生成する方法について説明します

例

次のセクションでは、次のような最も一般的なタスクをカバーするいくつかのコードスニペットを示します。

チャットクライアントを作成する
チャットスレッド操作
チャットメッセージ操作
チャットスレッド参加者の操作
開封確認操作
通知操作の入力

チャットクライアントを作成する

String endpoint = "https://<RESOURCE_NAME>.communcationservices.azure.com";

// Your user access token retrieved from your trusted service
String token = "SECRET";
CommunicationTokenCredential credential = new CommunicationTokenCredential(token);

// Initialize the chat client
final ChatClientBuilder builder = new ChatClientBuilder();
builder.endpoint(endpoint)
    .credential(credential);
ChatClient chatClient = builder.buildClient();

チャットスレッド操作

チャットスレッドの作成

チャットクライアントを作成するには、Communications Service エンドポイントと、前提条件の手順の一部として生成されたアクセストークンを使用します。ユーザーのアクセストークンを使用することで、Azure Communication Services に対して直接認証を行うクライアントアプリケーションを作成できます。サーバーでこれらのトークンを生成した後、それらをクライアントデバイスに渡します。チャットクライアントにトークンを渡すには、Common SDK の CommunicationTokenCredential クラスを使用する必要があります。

チャットスレッドは、createChatThread メソッドを使用して作成します。 createChatThreadOptions はスレッド要求を記述するために使用されます。例を次のコードスニペットに示します。

を使用して topic スレッドトピックを指定します。
を使用して participants 、スレッドに追加するスレッドの参加者を一覧表示します。

CreateChatThreadResult は、チャットスレッドの作成から返された応答です。これには、スレッドクライアントを取得するために使用できる ChatThread オブジェクトを返す getChatThread() メソッドが含まれています。そのスレッドクライアントからは、作成されたスレッドに対して参加者の追加、メッセージの送信などを含む操作を実行するための ChatThreadClient を取得できます。ChatThread オブジェクトには、スレッドの一意の ID を取得する getId() メソッドも含まれています。

List<ChatParticipant> participants = new ArrayList<ChatParticipant>();

ChatParticipant firstParticipant = new ChatParticipant()
    .setCommunicationIdentifier(user1)
    .setDisplayName("Participant Display Name 1");

ChatParticipant secondParticipant = new ChatParticipant()
    .setCommunicationIdentifier(user2)
    .setDisplayName("Participant Display Name 2");

participants.add(firstParticipant);
participants.add(secondParticipant);

CreateChatThreadOptions createChatThreadOptions = new CreateChatThreadOptions("Topic")
    .setParticipants(participants);
CreateChatThreadResult result = chatClient.createChatThread(createChatThreadOptions);

String chatThreadId = result.getChatThread().getId();

チャットスレッドのプロパティを取得する

メソッドは getChatThreadProperties 、サービスからスレッドのプロパティを取得します。

ChatThreadClient chatThreadClient = chatClient.getChatThreadClient("Id");
ChatThreadProperties chatThreadProperties = chatThreadClient.getProperties();

スレッドを削除する

チャットスレッドchatThreadIdを削除するには、メソッドを使用deleteChatThreadします。これは、チャットスレッドの一意の ID です。

String chatThreadId = "Id";
chatClient.deleteChatThread(chatThreadId);

チャットスレッドクライアントを取得する

getChatThreadClient メソッドは、既に存在するスレッドのスレッドクライアントを返します。作成したスレッドに対し、参加者の追加、メッセージの送信などの操作を実行するときに使用できます。chatThreadId は、既存のチャットスレッドの一意の ID です。

String chatThreadId = "Id";
ChatThreadClient chatThreadClient = chatClient.getChatThreadClient(chatThreadId);

チャットスレッドトピックを更新する

Use メソッドを使用して updateTopic スレッドのトピック topic を更新し、スレッドの新しいトピックを保持します。

chatThreadClient.updateTopic("New Topic");

チャットメッセージ操作

チャットメッセージを送信する

メソッドを sendMessage 使用して、が作成されたチャットスレッドにチャットメッセージを chatThreadClient 送信します。 sendChatMessageOptions はチャットメッセージ要求を記述するために使用されます。例を次のコードスニペットに示します。

チャットメッセージの内容は、content を使用して設定します。
[通常] や [高] などのチャットメッセージの優先度レベルを指定するには、を使用 priority します。
送信者の表示名を指定するには、senderDisplayName を使用します。

チャットメッセージの SendChatMessageResult 送信から返された応答には、メッセージの一意の ID である ID が含まれています。

SendChatMessageOptions sendChatMessageOptions = new SendChatMessageOptions()
    .setContent("Message content")
    .setSenderDisplayName("Sender Display Name");

SendChatMessageResult sendResult = chatThreadClient.sendMessage(sendChatMessageOptions);

チャットメッセージを取得する

メソッドは getMessage 、サービスからチャットメッセージを取得します。 chatMessageId はチャットメッセージの一意の ID です。

String chatMessageId = "Id";
ChatMessage chatMessage = chatThreadClient.getMessage(chatMessageId);

チャットメッセージを取得する

チャットメッセージは、チャットスレッドクライアントのメソッドを listMessages 使用して、指定した間隔 (ポーリング) で取得できます。

PagedIterable<ChatMessage> chatMessagesResponse = chatThreadClient.listMessages();
chatMessagesResponse.iterableByPage().forEach(resp -> {
    System.out.printf("Response headers are %s. Url %s  and status code %d %n", resp.getHeaders(),
        resp.getRequest().getUrl(), resp.getStatusCode());
    resp.getElements().forEach(message ->
        System.out.printf("Message id is %s.", message.getId()));
});

listMessages は、メッセージに対して .editMessage() や .deleteMessage() を使用して行われた編集や削除を含む、最新バージョンのメッセージを返します。

削除されたメッセージについては、そのメッセージがいつ削除されたかを示す datetime 値が chatMessage.getDeletedOn() から返されます。

編集されたメッセージについては、メッセージがいつ編集されたかを示す datetime が chatMessage.getEditedOn() から返されます。

メッセージの最初の作成日時には、chatMessage.getCreatedOn() を使用してアクセスできます。これをメッセージの並べ替えに使用することができます。

listMessages は、で chatMessage.getType()識別できるさまざまな種類のメッセージを返します。次の種類があります。

text:スレッド参加者によって送信された通常のチャットメッセージ。
html: スレッド参加者によって送信された HTML チャットメッセージ。
topicUpdated:トピックが更新されたことを示すシステムメッセージ。
participantAdded:1 人以上の参加者がチャットスレッドに追加されたことを示すシステムメッセージ。
participantRemoved:参加者がチャットスレッドから削除されたことを示すシステムメッセージ。

詳細については、「メッセージの種類」を参照してください。

チャットメッセージを更新する

chatThreadId と messageId で識別されるチャットメッセージを更新するために使用 updateMessage します。 chatMessageId はチャットメッセージの一意の ID です。 updateChatMessageOptions はチャットメッセージの更新の要求を記述するために使用されます。例を次のコードスニペットに示します。

を使用して content 、新しいチャットメッセージコンテンツを提供します。

String chatMessageId = "Id";
UpdateChatMessageOptions updateChatMessageOptions = new UpdateChatMessageOptions()
    .setContent("Updated message content");

chatThreadClient.updateMessage(chatMessageId, updateChatMessageOptions);

チャットメッセージを削除する

chatMessageId で識別されるチャットメッセージを更新するには、を使用 updateMessage します。 chatMessageId はチャットメッセージの一意の ID です。

String chatMessageId = "Id";
chatThreadClient.deleteMessage(chatMessageId);

チャットスレッド参加者の操作

チャット参加者を一覧表示する

チャットスレッドの参加者を含むページコレクションを取得するには、を使用 listParticipants します。

PagedIterable<ChatParticipant> chatParticipantsResponse = chatThreadClient.listParticipants();
chatParticipantsResponse.iterableByPage().forEach(resp -> {
    System.out.printf("Response headers are %s. Url %s  and status code %d %n", resp.getHeaders(),
        resp.getRequest().getUrl(), resp.getStatusCode());
    resp.getElements().forEach(chatParticipant ->
        System.out.printf("Participant id is %s.", ((CommunicationUserIdentifier) chatParticipant.getCommunicationIdentifier()).getId()));
});

参加者を追加する

メソッドを使用して addParticipants 、参加者をチャットスレッドに追加します。 participants スレッドに追加する参加者のリスト。

communicationIdentifierは、CommunicationIdentityClient を使用して作成した CommunicationIdentifier です。詳細情報: ユーザーの作成。
display_name (省略可) は、スレッドメンバーの表示名です。
share_history_time (省略可) は、メンバーとの間でチャット履歴が共有される際の起点となる時刻です。チャットスレッドの始めから履歴を共有する場合は、スレッドの作成日時と同じかそれ以前の任意の日付にこのプロパティを設定してください。メンバーが追加された時点よりも前の履歴は共有しない場合は、現在の日付に設定します。部分的に履歴を共有するには、必要な日付に設定します。

List<ChatParticipant> participants = new ArrayList<ChatParticipant>();

ChatParticipant firstParticipant = new ChatParticipant()
    .setCommunicationIdentifier(user1)
    .setDisplayName("Display Name 1");

ChatParticipant secondParticipant = new ChatParticipant()
    .setCommunicationIdentifier(user2)
    .setDisplayName("Display Name 2");

participants.add(firstParticipant);
participants.add(secondParticipant);

chatThreadClient.addParticipants(participants);

参加者を削除する

メソッドを使用して removeParticipant 、チャットスレッドから参加者を削除します。 identifier は、作成した CommunicationIdentifier です。

chatThreadClient.removeParticipant(user);

開封確認操作

開封確認メッセージを送信する

メソッドを使用して sendReadReceipt 、ユーザーの代わりに開封確認イベントをチャットスレッドに投稿します。 `messageId` は、開封されたチャットメッセージの一意の ID です。

String chatMessageId = "Id";
chatThreadClient.sendReadReceipt(chatMessageId);

開封確認メッセージを取得する

getReadReceipts メソッドは、チャットスレッドの開封確認メッセージを取得します。

PagedIterable<ChatMessageReadReceipt> readReceiptsResponse = chatThreadClient.listReadReceipts();
readReceiptsResponse.iterableByPage().forEach(resp -> {
    System.out.printf("Response headers are %s. Url %s  and status code %d %n", resp.getHeaders(),
        resp.getRequest().getUrl(), resp.getStatusCode());
    resp.getElements().forEach(readReceipt ->
        System.out.printf("Read message id is %s.", readReceipt.getChatMessageId()));
});

通知操作の入力

入力通知を送信する

ユーザーの代わりに、入力通知イベントをチャットスレッドに投稿するには、メソッドを使用 sendTypingNotification します。 typingNotificationOptions は、入力通知要求を記述するために使用されます。

通知送信者の表示名を設定するには、を使用 senderDisplayName します。

TypingNotificationOptions options = new TypingNotificationOptions();
options.setSenderDisplayName("Sender Display Name");
chatThreadClient.sendTypingNotificationWithResponse(options, Context.NONE);

トラブルシューティング

進行中。

次の手順

Azure 通信サービス用の他のクライアントライブラリを確認する

次の方法で共有

Java 用 Azure Communication Chat クライアント ライブラリ - バージョン 1.3.13

作業の開始

前提条件

パッケージを組み込む

BOM ファイルを含める

直接依存関係を含める

主要な概念

チャット スレッドの作成、取得、一覧表示、更新、削除

チャット メッセージの送信、取得、一覧表示、更新、削除

参加者の取得、追加、削除

開封確認メッセージを送信して取得する

共同作成

Azure Communication Resource エンドポイントの作成後に設定する

ユーザー アクセス トークンを要求する

例

チャット クライアントを作成する

チャット スレッド操作

チャット スレッドの作成

チャット スレッドのプロパティを取得する

スレッドを削除する

チャット スレッド クライアントを取得する

チャット スレッド トピックを更新する

チャット メッセージ操作

チャット メッセージを送信する

チャット メッセージを取得する

チャット メッセージを取得する

チャット メッセージを更新する

チャット メッセージを削除する

チャット スレッド参加者の操作

チャット参加者を一覧表示する

参加者を追加する

参加者を削除する

開封確認操作

開封確認メッセージを送信する

開封確認メッセージを取得する

通知操作の入力

入力通知を送信する

トラブルシューティング

次の手順

フィードバック

その他のリソース

Java 用 Azure Communication Chat クライアントライブラリ - バージョン 1.3.13

チャットスレッドの作成、取得、一覧表示、更新、削除

チャットメッセージの送信、取得、一覧表示、更新、削除

ユーザーアクセストークンを要求する

チャットクライアントを作成する

チャットスレッド操作

チャットスレッドの作成

チャットスレッドのプロパティを取得する

チャットスレッドクライアントを取得する

チャットスレッドトピックを更新する

チャットメッセージ操作

チャットメッセージを送信する

チャットメッセージを取得する

チャットメッセージを取得する

チャットメッセージを更新する

チャットメッセージを削除する

チャットスレッド参加者の操作