OpenIMSDKDocs

Type at least two characters to search titles and routes.

EN

Language

ENEnglishEnglish docs简中简体中文中文文档
Browse SDKs · Flutter
Platform
SDKsFlutterIncludes Enterprise features

Audio and video calling overview

Learn about call signaling, room data, and event boundaries in the OpenIM Flutter SDK.

Copy

The OpenIM Flutter SDK's SignalingManager provides the signaling APIs needed to start, accept, reject, cancel, and hang up calls, retrieve rooms, and synchronize call state. It coordinates who joins which room and the call lifecycle. It does not capture the camera, play remote media streams, or render the call interface.

Pass the roomID, token, and liveURL returned by the SDK to the selected real-time audio/video media engine. The application handles device permissions, media tracks, weak-network behavior, and UI state. OpenIM Flutter SDK provides call signaling here, not a complete real-time media implementation.

Call flow

  1. Call signalingInvite()Enterprise to start a one-to-one call or signalingInviteInGroup()Enterprise to start a group call.
  2. The invitee receives SignalingInfo through onReceiveNewInvitationEnterprise and chooses whether to accept or reject it.
  3. The accepting client calls signalingAccept()Enterprise, then both sides use the returned room credentials to connect their media engines.
  4. During the call, update local state from participant, media-stream, and custom-signaling listeners.
  5. The initiator can cancel an unanswered invitation. Any participant can hang up an established call.

Core data

DataDescription
InvitationInfoInviter, invitees, group, room, media type, timeout, and conversation type. All fields are nullable and must be validated in listeners.
SignalingInfoOperator userID, original invitation, and optional offlinePushInfo.
SignalingCertificateroomID, token, liveURL, and busy-user list returned by OpenIMServer.
RoomCallingInfoRoom, invitation, participants, and join credentials retrieved for a group.

customData is not a field on Flutter's InvitationInfo. Use room custom signaling for application negotiation data; it is intended for lightweight, temporary coordination and does not provide file transfer or durable state storage.

State updates and event ownership

For write operations such as invite, accept, reject, cancel, and hang up, handle the Future and listener separately. Future completion means that the current signaling request completed. A listener represents an incremental state observed by the inviter, invitee, another device, or a room participant. They are not the same completion signal.

See Call events for the complete invitation lifecycle, participant, hang-up, and media-stream listener. See Send a custom signal for custom signaling. Room and credential queries return snapshots only through their Futures and are documented in the three pages under Call information.

Do not configure a listener on this overview page. Use roomID as the primary key for call state and combine it with user IDs for participant state. Re-query room information whenever the current room snapshot is required.