StatefulChatClient interface

Пакет:

@azure/communication-react

Определяет методы, которые позволяют {@Link @azure/communication-chat#ChatClient} использоваться с централизованным созданным состоянием.

Интерфейс предоставляет доступ к прокси-состоянию, а также позволяет зарегистрировать обработчик для событий изменения состояния.

Extends

ChatClient

Методы

dispose()	Очищает кэш ресурсов из клиента потока чата.
downloadResourceToCache(string, string, string)	Загружает ресурс для определенного сообщения и кэширует его.
getState()	Содержит все состояние, которое мы могли бы прокси-сервером из ChatClient {@Link @azure/communication-chat#ChatClient} как ChatClientState {@Link ChatClientState}.
offStateChange((state: ChatClientState) => void)	Разрешает отмену регистрации для событий stateChanged.
onStateChange((state: ChatClientState) => void)	Позволяет обработчику регистрироваться для событий stateChanged.
removeResourceFromCache(string, string, string)	Удаляет ресурс из кэша для определенного сообщения.

Наследуемые методы

createChatThread(CreateChatThreadRequest, CreateChatThreadOptions)	Создает поток чата. Возвращает клиент потока с идентификатором созданного потока.
deleteChatThread(string, OperationOptions)	Удаляет поток чата.
getChatThreadClient(string)	Возвращает ChatThreadClient с определенным идентификатором потока.
listChatThreads(ChatListChatThreadsOptionalParams)	Возвращает список потоков чата пользователя.
off("chatMessageDeleted", (e: ChatMessageDeletedEvent) => void)	Отмена подписки из chatMessageDeleted.
off("chatMessageEdited", (e: ChatMessageEditedEvent) => void)	Отмена подписки из chatMessageEdited.
off("chatMessageReceived", (e: ChatMessageReceivedEvent) => void)	Отмена подписки из chatMessageReceived.
off("chatThreadCreated", (e: ChatThreadCreatedEvent) => void)	Отмена подписки из чатаThreadCreated.
off("chatThreadDeleted", (e: ChatThreadDeletedEvent) => void)	Отмена подписки на chatThreadDeleted.
off("chatThreadPropertiesUpdated", (e: ChatThreadPropertiesUpdatedEvent) => void)	Отмена подписки на chatThreadPropertiesUpdated.
off("participantsAdded", (e: ParticipantsAddedEvent) => void)	Отмена подписки от участниковAdded.
off("participantsRemoved", (e: ParticipantsRemovedEvent) => void)	Отмена подписки от участников Удалена.
off("readReceiptReceived", (e: ReadReceiptReceivedEvent) => void)	Отмена подписки на readReceiptReceived.
off("typingIndicatorReceived", (e: TypingIndicatorReceivedEvent) => void)	Отмена подписки на typeingIndicatorReceived.
on("chatMessageDeleted", (e: ChatMessageDeletedEvent) => void)	Функция подписки для chatMessageDeleted. Исходный отправитель также получит это событие.
on("chatMessageEdited", (e: ChatMessageEditedEvent) => void)	Функция подписки для chatMessageEdited. Исходный отправитель также получит это событие.
on("chatMessageReceived", (e: ChatMessageReceivedEvent) => void)	Функция подписки для chatMessageReceived. Исходный отправитель также получит это событие. Перед подпиской на любое событие необходимо вызвать startRealtimeNotifications.
on("chatThreadCreated", (e: ChatThreadCreatedEvent) => void)	Функция подписки для chatThreadCreated.
on("chatThreadDeleted", (e: ChatThreadDeletedEvent) => void)	Функция подписки для chatThreadDeleted.
on("chatThreadPropertiesUpdated", (e: ChatThreadPropertiesUpdatedEvent) => void)	Функция подписки для chatThreadPropertiesUpdated.
on("participantsAdded", (e: ParticipantsAddedEvent) => void)	Функция подписки для участниковAdded.
on("participantsRemoved", (e: ParticipantsRemovedEvent) => void)	Функция подписки для участников Удалена.
on("readReceiptReceived", (e: ReadReceiptReceivedEvent) => void)	Функция подписки для readReceiptReceived.
on("realTimeNotificationConnected", () => void)	Функция подписки для realTimeNotificationConnected.
on("realTimeNotificationDisconnected", () => void)	Функция подписки для realTimeNotificationDisconnected.
on("typingIndicatorReceived", (e: TypingIndicatorReceivedEvent) => void)	Функция подписки для ввода TypeingIndicatorReceived. Исходный отправитель также получит это событие.
startRealtimeNotifications()	Начните получать уведомления в режиме реального времени. Вызовите эту функцию перед подпиской на любое событие.
stopRealtimeNotifications()	Остановите получение уведомлений в режиме реального времени. Эта функция отменит подписку на все события.

Сведения о методе

dispose()

Очищает кэш ресурсов из клиента потока чата.

function dispose()

downloadResourceToCache(string, string, string)

Загружает ресурс для определенного сообщения и кэширует его.

function downloadResourceToCache(threadId: string, messageId: string, resourceUrl: string)

Параметры

threadId

string

Идентификатор потока чата.

messageId

string

Идентификатор сообщения в чате.

resourceUrl

string

URL-адрес ресурса для получения и кэширования.

getState()

Содержит все состояние, которое мы могли бы прокси-сервером из ChatClient {@Link @azure/communication-chat#ChatClient} как ChatClientState {@Link ChatClientState}.

function getState(): ChatClientState

Возвращаемое значение

ChatClientState

offStateChange((state: ChatClientState) => void)

Разрешает отмену регистрации для событий stateChanged.

function offStateChange(handler: (state: ChatClientState) => void)

Параметры

handler

(state: ChatClientState) => void

Исходный обратный вызов для отмены подписки.

onStateChange((state: ChatClientState) => void)

Позволяет обработчику регистрироваться для событий stateChanged.

function onStateChange(handler: (state: ChatClientState) => void)

Параметры

handler

(state: ChatClientState) => void

Обратный вызов для получения состояния.

removeResourceFromCache(string, string, string)

Удаляет ресурс из кэша для определенного сообщения.

function removeResourceFromCache(threadId: string, messageId: string, resourceUrl: string)

Параметры

threadId

string

Идентификатор потока чата.

messageId

string

Идентификатор сообщения в чате.

resourceUrl

string

URL-адрес ресурса, который нужно удалить из кэша.

Сведения о наследуемом методе

createChatThread(CreateChatThreadRequest, CreateChatThreadOptions)

Создает поток чата. Возвращает клиент потока с идентификатором созданного потока.

function createChatThread(request: CreateChatThreadRequest, options?: CreateChatThreadOptions): Promise<CreateChatThreadResult>

Параметры

request

CreateChatThreadRequest

Запрос на создание потока чата.

options

CreateChatThreadOptions

Параметры операции.

Возвращаемое значение

Promise<CreateChatThreadResult>

унаследовано от ChatClient.createChatThread

deleteChatThread(string, OperationOptions)

Удаляет поток чата.

function deleteChatThread(threadId: string, options?: OperationOptions): Promise<void>

Параметры

threadId

string

Идентификатор удаляемого потока.

options

OperationOptions

Параметры операции.

Возвращаемое значение

Promise<void>

наследуется от ChatClient.deleteChatThread

getChatThreadClient(string)

Возвращает ChatThreadClient с определенным идентификатором потока.

function getChatThreadClient(threadId: string): ChatThreadClient

Параметры

threadId

string

Идентификатор потока для ChatThreadClient

Возвращаемое значение

ChatThreadClient

наследуется от ChatClient.getChatThreadClient

listChatThreads(ChatListChatThreadsOptionalParams)

Возвращает список потоков чата пользователя.

function listChatThreads(options?: ChatListChatThreadsOptionalParams): PagedAsyncIterableIterator<ChatThreadItem, ChatThreadItem[], PageSettings>

Параметры

options

@azure/communication-chat.ChatListChatThreadsOptionalParams

Список параметров потоков чата.

Возвращаемое значение

PagedAsyncIterableIterator<ChatThreadItem, ChatThreadItem[], PageSettings>

унаследовано от ChatClient.listChatThreads

off("chatMessageDeleted", (e: ChatMessageDeletedEvent) => void)

Отмена подписки из chatMessageDeleted.

function off(event: "chatMessageDeleted", listener: (e: ChatMessageDeletedEvent) => void)

Параметры

event

"chatMessageDeleted"

Событие ChatMessageDeletedEvent.

listener

(e: ChatMessageDeletedEvent) => void

Прослушиватель для обработки события.

унаследовано от ChatClient.off

off("chatMessageEdited", (e: ChatMessageEditedEvent) => void)

Отмена подписки из chatMessageEdited.

function off(event: "chatMessageEdited", listener: (e: ChatMessageEditedEvent) => void)

Параметры

event

"chatMessageEdited"

Событие ChatMessageEditedEvent.

listener

(e: ChatMessageEditedEvent) => void

Прослушиватель для обработки события.

унаследовано от ChatClient.off

off("chatMessageReceived", (e: ChatMessageReceivedEvent) => void)

Отмена подписки из chatMessageReceived.

function off(event: "chatMessageReceived", listener: (e: ChatMessageReceivedEvent) => void)

Параметры

event

"chatMessageReceived"

Событие ChatMessageReceivedEvent.

listener

(e: ChatMessageReceivedEvent) => void

Прослушиватель для обработки события.

унаследовано от ChatClient.off

off("chatThreadCreated", (e: ChatThreadCreatedEvent) => void)

Отмена подписки из чатаThreadCreated.

function off(event: "chatThreadCreated", listener: (e: ChatThreadCreatedEvent) => void)

Параметры

event

"chatThreadCreated"

Событие ChatThreadCreatedEvent.

listener

(e: ChatThreadCreatedEvent) => void

Прослушиватель для обработки события.

унаследовано от ChatClient.off

off("chatThreadDeleted", (e: ChatThreadDeletedEvent) => void)

Отмена подписки на chatThreadDeleted.

function off(event: "chatThreadDeleted", listener: (e: ChatThreadDeletedEvent) => void)

Параметры

event

"chatThreadDeleted"

Событие ChatThreadDeletedEvent.

listener

(e: ChatThreadDeletedEvent) => void

Прослушиватель для обработки события.

унаследовано от ChatClient.off

off("chatThreadPropertiesUpdated", (e: ChatThreadPropertiesUpdatedEvent) => void)

Отмена подписки на chatThreadPropertiesUpdated.

function off(event: "chatThreadPropertiesUpdated", listener: (e: ChatThreadPropertiesUpdatedEvent) => void)

Параметры

event

"chatThreadPropertiesUpdated"

Событие ChatThreadPropertiesUpdated.

listener

(e: ChatThreadPropertiesUpdatedEvent) => void

Прослушиватель для обработки события.

унаследовано от ChatClient.off

off("participantsAdded", (e: ParticipantsAddedEvent) => void)

Отмена подписки от участниковAdded.

function off(event: "participantsAdded", listener: (e: ParticipantsAddedEvent) => void)

Параметры

event

"participantsAdded"

УчастникиAddedEvent.

listener

(e: ParticipantsAddedEvent) => void

Прослушиватель для обработки события.

унаследовано от ChatClient.off

off("participantsRemoved", (e: ParticipantsRemovedEvent) => void)

Отмена подписки от участников Удалена.

function off(event: "participantsRemoved", listener: (e: ParticipantsRemovedEvent) => void)

Параметры

event

"participantsRemoved"

УчастникRemovedEvent.

listener

(e: ParticipantsRemovedEvent) => void

Прослушиватель для обработки события.

унаследовано от ChatClient.off

off("readReceiptReceived", (e: ReadReceiptReceivedEvent) => void)

Отмена подписки на readReceiptReceived.

function off(event: "readReceiptReceived", listener: (e: ReadReceiptReceivedEvent) => void)

Параметры

event

"readReceiptReceived"

Событие ReadReceiptReceivedEvent.

listener

(e: ReadReceiptReceivedEvent) => void

Прослушиватель для обработки события.

унаследовано от ChatClient.off

off("typingIndicatorReceived", (e: TypingIndicatorReceivedEvent) => void)

Отмена подписки на typeingIndicatorReceived.

function off(event: "typingIndicatorReceived", listener: (e: TypingIndicatorReceivedEvent) => void)

Параметры

event

"typingIndicatorReceived"

TypeingIndicatorReceivedEvent.

listener

(e: TypingIndicatorReceivedEvent) => void

Прослушиватель для обработки события.

унаследовано от ChatClient.off

on("chatMessageDeleted", (e: ChatMessageDeletedEvent) => void)

Функция подписки для chatMessageDeleted. Исходный отправитель также получит это событие.

function on(event: "chatMessageDeleted", listener: (e: ChatMessageDeletedEvent) => void)

Параметры

event

"chatMessageDeleted"

Событие ChatMessageDeletedEvent.

listener

(e: ChatMessageDeletedEvent) => void

Прослушиватель для обработки события.

унаследовано от ChatClient.on

on("chatMessageEdited", (e: ChatMessageEditedEvent) => void)

Функция подписки для chatMessageEdited. Исходный отправитель также получит это событие.

function on(event: "chatMessageEdited", listener: (e: ChatMessageEditedEvent) => void)

Параметры

event

"chatMessageEdited"

Событие ChatMessageEditedEvent.

listener

(e: ChatMessageEditedEvent) => void

Прослушиватель для обработки события.

унаследовано от ChatClient.on

on("chatMessageReceived", (e: ChatMessageReceivedEvent) => void)

Функция подписки для chatMessageReceived. Исходный отправитель также получит это событие. Перед подпиской на любое событие необходимо вызвать startRealtimeNotifications.

function on(event: "chatMessageReceived", listener: (e: ChatMessageReceivedEvent) => void)

Параметры

event

"chatMessageReceived"

Событие ChatMessageReceivedEvent.

listener

(e: ChatMessageReceivedEvent) => void

Прослушиватель для обработки события.

унаследовано от ChatClient.on

on("chatThreadCreated", (e: ChatThreadCreatedEvent) => void)

Функция подписки для chatThreadCreated.

function on(event: "chatThreadCreated", listener: (e: ChatThreadCreatedEvent) => void)

Параметры

event

"chatThreadCreated"

Событие ChatThreadCreatedEvent.

listener

(e: ChatThreadCreatedEvent) => void

Прослушиватель для обработки события.

унаследовано от ChatClient.on

on("chatThreadDeleted", (e: ChatThreadDeletedEvent) => void)

Функция подписки для chatThreadDeleted.

function on(event: "chatThreadDeleted", listener: (e: ChatThreadDeletedEvent) => void)

Параметры

event

"chatThreadDeleted"

Событие ChatThreadDeletedEvent.

listener

(e: ChatThreadDeletedEvent) => void

Прослушиватель для обработки события.

унаследовано от ChatClient.on

on("chatThreadPropertiesUpdated", (e: ChatThreadPropertiesUpdatedEvent) => void)

Функция подписки для chatThreadPropertiesUpdated.

function on(event: "chatThreadPropertiesUpdated", listener: (e: ChatThreadPropertiesUpdatedEvent) => void)

Параметры

event

"chatThreadPropertiesUpdated"

Событие ChatThreadPropertiesUpdated.

listener

(e: ChatThreadPropertiesUpdatedEvent) => void

Прослушиватель для обработки события.

унаследовано от ChatClient.on

on("participantsAdded", (e: ParticipantsAddedEvent) => void)

Функция подписки для участниковAdded.

function on(event: "participantsAdded", listener: (e: ParticipantsAddedEvent) => void)

Параметры

event

"participantsAdded"

УчастникиAddedEvent.

listener

(e: ParticipantsAddedEvent) => void

Прослушиватель для обработки события.

унаследовано от ChatClient.on

on("participantsRemoved", (e: ParticipantsRemovedEvent) => void)

Функция подписки для участников Удалена.

function on(event: "participantsRemoved", listener: (e: ParticipantsRemovedEvent) => void)

Параметры

event

"participantsRemoved"

УчастникRemovedEvent.

listener

(e: ParticipantsRemovedEvent) => void

Прослушиватель для обработки события.

унаследовано от ChatClient.on

on("readReceiptReceived", (e: ReadReceiptReceivedEvent) => void)

Функция подписки для readReceiptReceived.

function on(event: "readReceiptReceived", listener: (e: ReadReceiptReceivedEvent) => void)

Параметры

event

"readReceiptReceived"

Событие ReadReceiptReceivedEvent.

listener

(e: ReadReceiptReceivedEvent) => void

Прослушиватель для обработки события.

унаследовано от ChatClient.on

on("realTimeNotificationConnected", () => void)

Функция подписки для realTimeNotificationConnected.

function on(event: "realTimeNotificationConnected", listener: () => void)

Параметры

event

"realTimeNotificationConnected"

Событие realTimeNotificationConnected

listener

() => void

Прослушиватель для обработки события.

унаследовано от ChatClient.on

on("realTimeNotificationDisconnected", () => void)

Функция подписки для realTimeNotificationDisconnected.

function on(event: "realTimeNotificationDisconnected", listener: () => void)

Параметры

event

"realTimeNotificationDisconnected"

Событие realTimeNotificationDisconnected

listener

() => void

Прослушиватель для обработки события.

унаследовано от ChatClient.on

on("typingIndicatorReceived", (e: TypingIndicatorReceivedEvent) => void)

Функция подписки для ввода TypeingIndicatorReceived. Исходный отправитель также получит это событие.

function on(event: "typingIndicatorReceived", listener: (e: TypingIndicatorReceivedEvent) => void)

Параметры

event

"typingIndicatorReceived"

TypeingIndicatorReceivedEvent.

listener

(e: TypingIndicatorReceivedEvent) => void

Прослушиватель для обработки события.

унаследовано от ChatClient.on

startRealtimeNotifications()

Начните получать уведомления в режиме реального времени. Вызовите эту функцию перед подпиской на любое событие.

function startRealtimeNotifications(): Promise<void>

Возвращаемое значение

Promise<void>

унаследовано от ChatClient.startRealtimeNotifications

stopRealtimeNotifications()

Остановите получение уведомлений в режиме реального времени. Эта функция отменит подписку на все события.

function stopRealtimeNotifications(): Promise<void>

Возвращаемое значение

Promise<void>

унаследовано от ChatClient.stopRealtimeNotifications