بازگشت به توسعه‌دهندگان

< Flutter UIKit />

UTD Audio Room Kit

اتاق‌های صوتی زندهٔ آمادهٔ استفاده با صندلی‌ها، چت بی‌درنگ و مدیریت محتوا.

نسخه 1.5.0در pub.dev
شروع کنیدمشاهده در pub.dev
iOS 11+Android 21+
audio_room_kit.dart
import 'package:utd_audio_room_kit/utd_audio_room_kit.dart';

UTDAudioRoom(
  appId: '<utd-app-id>',
  appKey: '<utd-app-key>',
  userId: 'user123',
  userName: 'John Doe',
  roomId: 'room456',
  roomOwnerId: 'owner789',
);

Drop-in

UI کامل

0

سرورهای بک‌اند

EN · AR

i18n داخلی

PiP

+ minimize

< utd_audio_room_kit />

ویژگی‌های کلیدی

یک بستهٔ کامل و قابل سفارشی‌سازی Flutter برای تجربه‌های اتاق صوتی زنده، مبتنی بر LiveKit و UTD Stream Engine. رابط کاربری آمادهٔ اتاق همراه با مدیریت صندلی، درخواست صحبت، فهرست اعضا، چت بی‌درنگ، کنترل‌های رسانه، minimize/PiP و مدیریت محتوای کامل میزبان/ادمین — بدون نیاز به هیچ سرور توکن بک‌اند.

رابط کاربری آمادهٔ اتاق صوتی — بدون کد اضافی

مدیریت صندلی: گرفتن، ترک، جابه‌جایی، lock، unlock، kick، mute، swap

صف درخواست صحبت با approve/reject

فهرست اعضا با اقدامات میزبان/ادمین (mute، kick، invite، ban، promote/demote)

چت بی‌درنگ از طریق data-channel با دسته‌بندی و حذف تکرار

کنترل میکروفون و بلندگو با مسیریابی با اولویت بلوتوث

اتصال مجدد لایه‌بندی‌شده (همگام‌سازی سبک <15s، همگام‌سازی کامل <60s)

minimize به روکش شناور و Android OS Picture-in-Picture

سفارشی‌سازی تم و i18n داخلی (EN/AR)

جایگزینی کامل بخش‌ها (هدر، پیام‌ها، کنترل‌ها، پس‌زمینه، صندلی‌ها)

بدون سرور توکن بک‌اند — جریان توکن مبتنی بر appKey

< utd_audio_room_kit />

شروع کنید

1

نصب

Terminal
flutter pub add utd_audio_room_kit
2

مشاهده در pub.dev

اتاق‌های صوتی زندهٔ آمادهٔ استفاده با صندلی‌ها، چت بی‌درنگ و مدیریت محتوا.

مشاهده در pub.dev

< utd_audio_room_kit />

مرجع API

Main widget

The drop-in prebuilt audio-room widget that hosts the full UI and connection lifecycle.

UTDAudioRoomwidget
const UTDAudioRoom({required String appId, required String appKey, required String userId, required String userName, required String roomId, required String roomOwnerId, Set<String> adminIds, UTDAudioRoomConfig config, List<UTDRoomMode> modes, UTDRoomController? controller, ...})

Prebuilt audio-room widget. Mints a token directly from the engine with the publishable appKey (no backend), connects to LiveKit, and renders seats, chat and controls. Self-upgrades admins post-join.

پارامترها

  • appIdStringالزامی

    UTD Stream Engine app ID.

  • appKeyStringالزامی

    Publishable app key (no backend); used to mint tokens via X-App-Key. The server secret never ships.

  • userIdStringالزامی

    Local user identity.

  • userNameStringالزامی

    Local user display name.

  • roomIdStringالزامی

    Room name to join.

  • roomOwnerIdStringالزامی

    Identity of the room owner; the owner joins as host.

  • adminIdsSet<String>پیش‌فرض = const {}

    Identities the app treats as admins at join.

  • adminIdsResolverFuture<Set<String>> Function()?پیش‌فرض = null

    Async admin-list source; triggers a non-blocking self-upgrade if it lists the local user.

  • adminIdsNowSet<String> Function()?پیش‌فرض = null

    Sync admin-list probe used at token time without waiting.

  • layoutModeStringپیش‌فرض = '3'

    Room mode id selecting the seat layout / seat count.

  • configUTDAudioRoomConfigپیش‌فرض = const UTDAudioRoomConfig()

    Behavior, theming and custom-widget configuration.

  • modesList<UTDRoomMode>پیش‌فرض = const []

    Custom room modes registered on the controller.

  • controllerUTDRoomController?پیش‌فرض = null

    Optional externally-owned controller (e.g. when restoring from minimize).

  • onControllerReadyvoid Function(UTDRoomController)?پیش‌فرض = null

    Called once the controller is created/attached.

  • onConnectionChangedvoid Function(bool isConnected)?پیش‌فرض = null

    Fired on connect success/failure.

  • onSeatTapvoid Function(int index, SeatState seat)?پیش‌فرض = null

    Called when a seat is tapped.

  • onSeatChangedvoid Function(List<SeatState> seats)?پیش‌فرض = null

    Called whenever seat state changes.

  • onConnectErrorvoid Function(Object error, StackTrace)?پیش‌فرض = null

    Called when the initial connect fails.

Room controller

Top-level controller owning connection, sub-controllers, roles, bans and speaker flows.

UTDRoomControllerconstructor
UTDRoomController()

Creates the controller and its seat, media, chat, minimize and PiP sub-controllers. Usually created internally by UTDAudioRoom.

initApimethod
void initApi({String baseUrl, String tokenBaseUrl, String? appId, required String appKey})

Initializes the engine and token API clients. Must be called before connect/generateToken. Token issuance and in-room ops use different hosts.

پارامترها

  • baseUrlStringپیش‌فرض = UTDApiClient.defaultBaseUrl

    In-room engine host for seat/speaker/ban/role calls.

  • tokenBaseUrlStringپیش‌فرض = UTDApiClient.defaultTokenBaseUrl

    Edge host used for token generation.

  • appIdString?پیش‌فرض = null

    Engine app ID.

  • appKeyStringالزامی

    Publishable app key sent as X-App-Key for minting.

connectmethodasync
Future<void> connect({required String url, required String token, int seatCount = 9, bool enableMicOnJoin = false, bool useSpeaker = true, Map<String,String> userAttributes, String? roomName})

Connects to the LiveKit room with the given url/token, initializes seats, wires data/role/ban/chat-lock handlers, and optionally enables the mic and speaker.

پارامترها

  • urlStringالزامی

    LiveKit server URL.

  • tokenStringالزامی

    LiveKit access token.

  • seatCountintپیش‌فرض = 9

    Number of seats to initialize.

  • enableMicOnJoinboolپیش‌فرض = false

    Publish the local mic on connect.

  • useSpeakerboolپیش‌فرض = true

    Prefer Bluetooth/loudspeaker output on join.

  • userAttributesMap<String,String>پیش‌فرض = const {}

    Cosmetic LiveKit participant attributes (avatar/frame/etc.).

  • roomNameString?پیش‌فرض = null

    Room name used for seat API calls.

مقدار بازگشتی: Future<void>

generateTokenmethodasync
Future<UTDTokenResponse> generateToken({required String identity, required String roomName, required String roomOwnerId, String role = 'audience', String? name, int? seatCount, String? seatMode, int? hostSeat, String? modeId, ...})

Requests a LiveKit token from the engine and applies the returned per-user bearer to the in-room clients. Throws UTDBannedException on a 403 banned response.

پارامترها

  • identityStringالزامی

    User identity.

  • roomNameStringالزامی

    Room name.

  • roomOwnerIdStringالزامی

    Room owner identity.

  • typeStringپیش‌فرض = 'audio_room'

    Room type.

  • roleStringپیش‌فرض = 'audience'

    Requested role (host/admin/audience).

  • nameString?پیش‌فرض = null

    Display name.

  • seatCountint?پیش‌فرض = null

    Initial seat count (host only).

  • modeIdString?پیش‌فرض = null

    Room mode id (host only).

مقدار بازگشتی: Future<UTDTokenResponse>

leavemethodasync
Future<void> leave()

Leaves the room: tears down listeners, drains any pending mic publish, disconnects LiveKit, and resets minimize/PiP state.

مقدار بازگشتی: Future<void>

changeRolemethodasync
Future<UTDRoleChangeResult> changeRole({required String targetIdentity, required String role})

Changes a participant's role (owner-only; server returns 403 otherwise). Optimistically caches the result; throws on REST error.

پارامترها

  • targetIdentityStringالزامی

    Identity whose role changes.

  • roleStringالزامی

    New role (host/admin/guest/audience).

مقدار بازگشتی: Future<UTDRoleChangeResult>

banUsermethodasync
Future<bool> banUser(String identity, {String? reason, int? durationSeconds, bool global = false})

Bans a user. Room-scoped by default; pass global true for a project-wide ban and durationSeconds null for permanent. Returns true on success.

پارامترها

  • identityStringالزامی

    User to ban.

  • reasonString?پیش‌فرض = null

    Optional ban reason.

  • durationSecondsint?پیش‌فرض = null

    Ban duration; null = permanent.

  • globalboolپیش‌فرض = false

    True for a project-wide ban.

مقدار بازگشتی: Future<bool>

lockCommentsmethodasync
Future<bool> lockComments()

Locks room chat so only host/admin may send (host/admin-only). State is confirmed by the server broadcast, not set optimistically.

مقدار بازگشتی: Future<bool>

requestToSpeakmethodasync
Future<Map<String,dynamic>?> requestToSpeak()

Audience requests to speak (request mode). Returns the API result map, or null on error / when not ready.

مقدار بازگشتی: Future<Map<String,dynamic>?>

inviteToSpeakmethodasync
Future<Map<String,dynamic>?> inviteToSpeak(String targetIdentity, {int? seatIndex})

Host/admin invites a user to speak, optionally targeting a specific seat. Returns the API result map or null.

پارامترها

  • targetIdentityStringالزامی

    Identity to invite.

  • seatIndexint?پیش‌فرض = null

    Target seat the invitee is seated on if accepted.

مقدار بازگشتی: Future<Map<String,dynamic>?>

isConnectedgetter
bool get isConnected

True when the room connection state is connected.

مقدار بازگشتی: bool

isHostOrAdmingetter
bool get isHostOrAdmin

Whether the local participant's role is host or admin.

مقدار بازگشتی: bool

participantsStreamgetterasync
Stream<List<UTDParticipant>> get participantsStream

Stream of all room participants, emitting on join/leave/attribute/metadata changes.

مقدار بازگشتی: Stream<List<UTDParticipant>>

roleChangeStreamgetterasync
Stream<UTDRoleChangeEvent> get roleChangeStream

Stream of role changes for all participants (promotions, demotions, engine auto-corrections).

مقدار بازگشتی: Stream<UTDRoleChangeEvent>

activeSpeakersproperty
final ValueNotifier<Set<String>> activeSpeakers

Reactive set of identities currently speaking, polled from LiveKit every 300ms.

مقدار بازگشتی: ValueNotifier<Set<String>>

commentsLockedproperty
final ValueNotifier<bool> commentsLocked

Reactive whether room chat is currently locked (server-driven; never set optimistically).

مقدار بازگشتی: ValueNotifier<bool>

onBannedcallback
void Function(UTDBanNotice notice)? onBanned

Fired once when the local user is banned from any source (data message, removal, or token 403). Wired internally by UTDAudioRoom.

مقدار بازگشتی: void Function(UTDBanNotice)?

disposemethod
void dispose()

Releases all resources: timers, subscriptions, notifiers, sub-controllers and API clients.

Seat & stage control

Seat state management; all mutations go through the REST API and apply from server _seat_update messages.

UTDSeatControllerclass
UTDSeatController(UTDRoomManager roomManager)

Manages reactive seat state. Mutations call the REST API; local state updates only from _seat_update data messages or room _seats metadata.

takeSeatmethodasync
Future<bool> takeSeat(int index, String userId)

Requests microphone (and Bluetooth on Android) permissions then takes the seat at index via the API. State arrives via _seat_update.

پارامترها

  • indexintالزامی

    Target seat index.

  • userIdStringالزامی

    Identity taking the seat.

مقدار بازگشتی: Future<bool>

leaveSeatmethodasync
Future<bool> leaveSeat(String userId)

Leaves the user's current seat via the API.

پارامترها

  • userIdStringالزامی

    Identity leaving the seat.

مقدار بازگشتی: Future<bool>

moveSeatmethodasync
Future<bool> moveSeat(String userId, int targetSeat)

Atomically moves the user to another seat via the API.

پارامترها

  • userIdStringالزامی

    Identity to move.

  • targetSeatintالزامی

    Destination seat index.

مقدار بازگشتی: Future<bool>

lockSeatmethodasync
Future<bool> lockSeat(int index, {required String identity})

Admin locks the seat at index (host/admin). State arrives via _seat_update.

پارامترها

  • indexintالزامی

    Seat to lock.

  • identityStringالزامی

    Acting host/admin identity.

مقدار بازگشتی: Future<bool>

kickFromSeatmethodasync
Future<bool> kickFromSeat(int index, {required String identity})

Removes the occupant from the seat at index (host/admin only).

پارامترها

  • indexintالزامی

    Seat to vacate.

  • identityStringالزامی

    Acting host/admin identity.

مقدار بازگشتی: Future<bool>

setupSeatsmethodasync
Future<bool> setupSeats({required String identity, required int seatCount, required String seatMode, String? modeId})

Changes seat configuration mid-room (count/mode/modeId) (host/admin only).

پارامترها

  • identityStringالزامی

    Acting host/admin identity.

  • seatCountintالزامی

    New seat count.

  • seatModeStringالزامی

    New seat mode ('free'/'request').

  • modeIdString?پیش‌فرض = null

    New room mode id.

مقدار بازگشتی: Future<bool>

seatsproperty
final ValueNotifier<List<SeatState>> seats

Reactive list of all seat states.

مقدار بازگشتی: ValueNotifier<List<SeatState>>

pendingRequestsproperty
final ValueNotifier<List<SpeakerRequest>> pendingRequests

Reactive list of pending speaker requests (for host/admin UI).

مقدار بازگشتی: ValueNotifier<List<SpeakerRequest>>

getSeatIndexByUserIdmethod
int getSeatIndexByUserId(String userId)

Returns the seat index occupied by a user, or -1 if not seated.

پارامترها

  • userIdStringالزامی

    Identity to look up.

مقدار بازگشتی: int

isSeatAvailablemethod
bool isSeatAvailable(int index, {String? userId})

Whether the seat at index is empty, unlocked and not reserved for someone else.

پارامترها

  • indexintالزامی

    Seat index to test.

  • userIdString?پیش‌فرض = null

    User to evaluate reservations against.

مقدار بازگشتی: bool

Media control

Mic, camera, speaker and Bluetooth-routing controls, kept in sync with server/host-side mutes.

UTDMediaControllerclass
UTDMediaController(UTDRoomManager roomManager)

Controls mic, camera and speaker state and listens to LiveKit mute/permission events to keep reactive state authoritative.

setMicrophoneEnabledmethodasync
Future<void> setMicrophoneEnabled(bool enabled)

Enables/disables the local mic. Refuses to publish on a non-connected room to avoid the addTransceiver-on-disposed-track crash.

پارامترها

  • enabledboolالزامی

    Target mic state.

مقدار بازگشتی: Future<void>

toggleMicrophonemethodasync
Future<void> toggleMicrophone()

Toggles the local microphone on/off.

مقدار بازگشتی: Future<void>

applyBluetoothAudioRoutingmethodasync
Future<void> applyBluetoothAudioRouting()

Re-applies the Android communication audio config with forceHandleAudioRouting so Bluetooth routing works after connect/publish; iOS uses the AVAudioSession path.

مقدار بازگشتی: Future<void>

setSpeakerOnmethodasync
Future<void> setSpeakerOn(bool on)

Routes audio to the loudspeaker (true) or earpiece (false).

پارامترها

  • onboolالزامی

    Speakerphone on/off.

مقدار بازگشتی: Future<void>

muteAllRemoteAudiomethod
void muteAllRemoteAudio(bool mute)

Mutes/unmutes playback of all remote participants' audio (and enforces it on late-subscribed tracks).

پارامترها

  • muteboolالزامی

    Whether to mute remote audio.

isMicEnabledproperty
final ValueNotifier<bool> isMicEnabled

Reactive local mic state, kept in sync with LiveKit track mute/unmute events.

مقدار بازگشتی: ValueNotifier<bool>

canPublishproperty
final ValueNotifier<bool> canPublish

Reactive whether the local participant may publish mic/camera; flips false on demotion.

مقدار بازگشتی: ValueNotifier<bool>

Chat

Room chat send/receive with comment-lock gating and a bounded message buffer.

UTDChatControllerclass
UTDChatController(UTDRoomManager roomManager)

Sends and receives room chat over the data channel, enforcing the comment-lock gate and capping retained messages at 300.

sendMessagemethodasync
Future<void> sendMessage(String text, {Map<String,dynamic>? userData})

Sends a chat message (trimmed, non-empty). Refused when comments are locked and the local user is not host/admin.

پارامترها

  • textStringالزامی

    Message body.

  • userDataMap<String,dynamic>?پیش‌فرض = null

    Optional extra payload attached to the message.

مقدار بازگشتی: Future<void>

addDisplayMessagemethod
void addDisplayMessage(UTDChatMessage message)

Appends a message to the local list without sending it (used for system lines).

پارامترها

  • messageUTDChatMessageالزامی

    Message to display locally.

clearMessagesmethod
void clearMessages()

Clears the local message list.

messagesproperty
final ValueNotifier<List<UTDChatMessage>> messages

Reactive list of chat messages (bounded to the most recent 300).

مقدار بازگشتی: ValueNotifier<List<UTDChatMessage>>

Configuration & theming

Behavior config, color tokens, localized strings and minimize/PiP options.

UTDAudioRoomConfigconstructor
const UTDAudioRoomConfig({bool showControlsBar = true, bool turnOnMicrophoneWhenJoining = false, bool useSpeakerWhenJoining = true, int hostSeatIndex = 0, UTDRoomTheme theme, UTDRoomStrings? strings, bool enableMinimize = true, Widget? headerWidget, ...})

Configures room behavior, theme, strings and custom section/seat builders. Replaces the prebuilt config.

پارامترها

  • showControlsBarboolپیش‌فرض = true

    Show the default controls bar.

  • showSeatNamesboolپیش‌فرض = true

    Show occupant names under seats.

  • enableMinimizeboolپیش‌فرض = true

    Allow minimizing the room to a floating overlay.

  • turnOnMicrophoneWhenJoiningboolپیش‌فرض = false

    Publish the mic on join.

  • useSpeakerWhenJoiningboolپیش‌فرض = true

    Prefer speaker/Bluetooth output on join.

  • hostSeatIndexintپیش‌فرض = 0

    Seat index reserved for the host.

  • themeUTDRoomThemeپیش‌فرض = const UTDRoomTheme()

    Color tokens for the default UI.

  • stringsUTDRoomStrings?پیش‌فرض = null

    Localized strings; null = English defaults.

  • autoHostMicboolپیش‌فرض = true

    Auto-enable the host's mic even if join-mic is false.

  • autoSeatHostboolپیش‌فرض = true

    Auto-seat the host on hostSeatIndex if empty.

  • headerWidgetWidget?پیش‌فرض = null

    Custom header replacing the default.

  • seatBuilderWidget Function(SeatState, double)?پیش‌فرض = null

    Custom builder for a seat slot.

  • avatarBuilderWidget Function(String,double,Map<String,String>,bool,int,String)?پیش‌فرض = null

    Custom occupant avatar builder.

  • userInRoomAttributesMap<String,String>پیش‌فرض = const {}

    Cosmetic attributes published to other participants.

UTDAudioRoomConfig.hostconstructor
factory UTDAudioRoomConfig.host()

Factory preset for a host (microphone on when joining).

resolveStringsmethod
UTDRoomStrings resolveStrings()

Returns the configured strings or the English defaults.

مقدار بازگشتی: UTDRoomStrings

UTDRoomThemeconstructor
const UTDRoomTheme({Color background, Color surface, Color onSurface, Color primary, Color danger, Color seatRingSpeaking, Color badgeHost, Color badgeAdmin, Color badgeGuest, Color sheetBackground, Color bubbleBackground, ...})

Color tokens for the built-in default UI. Every field has a dark-room default, so const UTDRoomTheme() is a complete theme.

پارامترها

  • backgroundColorپیش‌فرض = Color(0xFF14121C)

    Full-screen room background.

  • primaryColorپیش‌فرض = Color(0xFF6C5CE7)

    Accent / call-to-action color.

  • dangerColorپیش‌فرض = Color(0xFFE74C3C)

    Destructive color (leave/kick/ban).

  • seatRingSpeakingColorپیش‌فرض = Color(0xFF2ECC71)

    Ring around an actively-speaking seat.

  • badgeHostColorپیش‌فرض = Color(0xFFFFA726)

    Host role badge color.

  • badgeAdminColorپیش‌فرض = Color(0xFF448AFF)

    Admin role badge color.

copyWithmethod
UTDRoomTheme copyWith({Color? background, Color? primary, Color? danger, ...})

Returns a copy of the theme overriding only the supplied color tokens.

مقدار بازگشتی: UTDRoomTheme

UTDRoomStrings.enconstructor
factory UTDRoomStrings.en()

English defaults for all built-in UI labels (seat actions, requests, host panels, comment-lock, templated lines).

UTDRoomStrings.arconstructor
factory UTDRoomStrings.ar()

Arabic defaults for all built-in UI labels.

UTDMinimizeConfigconstructor
const UTDMinimizeConfig({VoidCallback? onClose, MiniOverlayBuilder? overlayBuilder, double overlayWidth = 120, double overlayHeight = 120, bool enableOSPip = false, int pipAspectWidth = 1, int pipAspectHeight = 1, ...})

Configures the minimize floating overlay and optional Android OS-level Picture-in-Picture (enableOSPip).

پارامترها

  • onCloseVoidCallback?پیش‌فرض = null

    Called when the room is closed from the overlay.

  • overlayBuilderMiniOverlayBuilder?پیش‌فرض = null

    Custom floating-overlay builder.

  • enableOSPipboolپیش‌فرض = false

    Enable Android 12+ system PiP in addition to the overlay.

  • pipAspectWidthintپیش‌فرض = 1

    PiP aspect ratio numerator.

  • pipAspectHeightintپیش‌فرض = 1

    PiP aspect ratio denominator.

Models & enums

Data models for seats, room modes, chat and connection state.

SeatStateclass
const SeatState({required int index, String? occupantUserId, bool isLocked = false, bool isMuted = false, String? reservedFor, Map<String,String> attributes})

Immutable (Equatable) state of a single seat: index, occupant, lock/mute flags, reservation and occupant attributes.

پارامترها

  • indexintالزامی

    Seat index (0 = host seat).

  • occupantUserIdString?پیش‌فرض = null

    Occupant identity; null = empty.

  • isLockedboolپیش‌فرض = false

    Whether the seat is admin-locked.

  • isMutedboolپیش‌فرض = false

    Whether the occupant's mic is muted.

  • reservedForString?پیش‌فرض = null

    Identity this seat is reserved for.

  • attributesMap<String,String>پیش‌فرض = const {}

    Occupant cosmetic attributes (avatar, frame, etc.).

SpeakerRequestclass
const SpeakerRequest({required int id, required String identity, String? createdAt})

A pending request to speak: id, requester identity and createdAt timestamp.

پارامترها

  • idintالزامی

    Request id.

  • identityStringالزامی

    Requesting identity.

  • createdAtString?پیش‌فرض = null

    Creation timestamp.

RoomSeatStateclass
const RoomSeatState({required int count, required String mode, String? modeId, required List<SeatState> seats, required List<SpeakerRequest> requests})

Full seat snapshot from the backend _seats namespace: count, mode, modeId, seats and pending requests.

پارامترها

  • countintالزامی

    Seat count.

  • modeStringالزامی

    Seat mode ('free'/'request').

  • modeIdString?پیش‌فرض = null

    Room mode id.

  • seatsList<SeatState>الزامی

    Per-seat states.

  • requestsList<SpeakerRequest>الزامی

    Pending speaker requests.

UTDRoomModeclass
const UTDRoomMode({required String id, required int seatCount, required List<List<int>> rows, double? seatSize, UTDSeatContainerBuilder? containerBuilder, UTDBackgroundBuilder? backgroundBuilder, String? displayName})

Defines a seat layout mode: id, seat count, row arrangement and optional custom container/background builders. Identity is its id.

پارامترها

  • idStringالزامی

    Unique mode id (e.g. '3').

  • seatCountintالزامی

    Number of seats.

  • rowsList<List<int>>الزامی

    Seat-index layout per row.

  • seatSizedouble?پیش‌فرض = null

    Explicit seat size override.

  • containerBuilderUTDSeatContainerBuilder?پیش‌فرض = null

    Custom seat-grid container builder.

  • backgroundBuilderUTDBackgroundBuilder?پیش‌فرض = null

    Mode-specific background builder.

computeSeatSizemethod
double computeSeatSize(double screenWidth)

Single source of truth for the seat slot size in logical px, scaled sub-linearly (sqrt) with screen width and clamped to 52–120.

پارامترها

  • screenWidthdoubleالزامی

    Available screen width.

مقدار بازگشتی: double

UTDRoomMode.defaultModefield
static const UTDRoomMode defaultMode

Built-in default mode: id '3', 9 seats in a 1-4-4 layout.

مقدار بازگشتی: UTDRoomMode

UTDChatMessageclass
UTDChatMessage({required String senderUserId, required String senderName, required String text, required DateTime timestamp, Map<String,dynamic> userData, String? messageID})

A chat message with sender, text, timestamp, arbitrary userData and an auto-generated messageID. JSON-serializable.

پارامترها

  • senderUserIdStringالزامی

    Sender identity.

  • senderNameStringالزامی

    Sender display name.

  • textStringالزامی

    Message body.

  • timestampDateTimeالزامی

    Message time.

  • userDataMap<String,dynamic>پیش‌فرض = const {}

    Extra payload (e.g. system-line markers).

  • messageIDString?پیش‌فرض = null

    Message id; auto-generated when omitted.

UTDConnectionStateenum
enum UTDConnectionState { disconnected, connecting, connected, reconnecting, error }

Room connection state: disconnected, connecting, connected, reconnecting, error.

مقدار بازگشتی: UTDConnectionState

آماده‌اید با UTD بسازید؟

حساب خود را بسازید، کیف پول اصلی‌تان را شارژ کنید و سرویس‌هایی را که نیاز دارید روشن کنید.

حساب رایگان خود را بسازید