Quickstart

Prerequisites

Add cn.seastart.meeting:meeting:2.0.39 as described in Integration.
Get a meetToken from your backend. Don’t store the secret key used to generate tokens in the client.
Request the camera and audio recording runtime permissions in your app.
Prepare the streamVendor agreed for your deployment. The example uses wangsucdn; the actual value depends on your backend configuration.

1. Create and initialize the Engine

Your app should hold a single MeetingEngine in one place. Callbacks stay on the thread they actually come from; switch to the main thread before any UI operation.

private lateinit var meetingEngine: MeetingEngine

fun initMeeting(application: Application, meetToken: String) {
    meetingEngine = MeetingEngine.create(application)
    meetingEngine.initSdk(
        meetToken,
        null,
        object : MeetingResultCallback {
            override fun onSuccess() {
                // The SDK is ready
            }

            override fun onFailure(errorCode: Int, message: String?) {
                // message is for diagnostics only; build user-facing text from errorCode
            }
        }
    )
}

Release the Engine when you no longer use the SDK:

fun releaseMeeting() {
    meetingEngine.release()
}

2. Create a meeting

When an instant meeting is created successfully, MeetingCreatedBean is returned directly; the Data<T> network wrapper is no longer exposed.

val option = CreateImmediateMeetingOption(
    content = "Product review",
    attendType = AttendType.ATTEND_NOT_LIMIT,
    mode = MeetingMode.Normal,
    entryMutePolicy = MuteState.MuteState3
)

meetingEngine.createImmediateMeeting(
    "Weekly project sync",
    option,
    object : MeetingValueResultCallback<MeetingCreatedBean> {
        override fun onSuccess(value: MeetingCreatedBean) {
            val meetingId = value.meetingId
            val roomNo = value.roomNo
        }

        override fun onFailure(errorCode: Int, message: String?) {
            // Creation failed
        }
    }
)

For scheduled meetings, use createScheduleMeeting(), where planTime is a Unix timestamp in seconds and planDur is in minutes.

3. Register in-meeting events

Assign room, member, message, and media events before entering the meeting so you don’t miss the initial events; they are cleared automatically after you exit the meeting.

meetingEngine.roomEvent = object : MeetingRoomSimpleEvent() {
    override fun onDisconnected(
        reason: LeaveReason,
        statusCode: Int,
        message: String?
    ) {
        // The meeting is actually disconnected
    }
}

meetingEngine.userEvent = object : MeetingUserSimpleEvent() {
    override fun onUserEnter(uid: String) {
        val member = meetingEngine.infosManager.getMemberByUid(uid)
        // Refresh the member list
    }

    override fun onTrackAdded(uid: String, trackInfo: TrackInfo) {
        // Decide whether to subscribe based on trackInfo.desc
    }
}

For the full list of events, see Meeting events overview (Chinese).

4. Enter and exit the meeting

A successful entry returns MeetingEnterInfo. In-meeting APIs are still called on MeetingEngine; don’t reference the SDK’s internal MeetingSession.

meetingEngine.enterMeeting(
    activity = this,
    roomNo = "10000001",
    password = null,
    nick = "Alice",
    avatar = "",
    streamVendor = "wangsucdn",
    isAudience = false,
    extendInfo = null,
    callback = object : MeetingValueResultCallback<MeetingEnterInfo> {
        override fun onSuccess(value: MeetingEnterInfo) {
            val meetingId = value.meetingId
            val myUid = value.uid
            // Server-side meeting entry and SRTC join are complete
        }

        override fun onFailure(errorCode: Int, message: String?) {
            // Failed to enter the meeting
        }
    }
)

To enter by meeting ID, use enterMeetingByMeetingId(); the other parameters are the same. To exit the meeting, call:

meetingEngine.exitMeeting()

5. Open and publish the camera and mic

openCamera() / openMic() only do local capture before the meeting; after entering, you must use openCameraAndPublish() / openMicAndPublish() to publish to the meeting.

meetingEngine.openCameraAndPublish(
    localPreview,
    PreOptionCamera._480P,
    object : MeetingResultCallback {
        override fun onSuccess() {
            // The camera is capturing and published
        }

        override fun onFailure(errorCode: Int, message: String?) {
            // This publish and capture have been rolled back
        }
    }
)

meetingEngine.openMicAndPublish(
    PreOptionMic.def,
    object : MeetingResultCallback {
        override fun onSuccess() {
            // The mic is capturing and published
        }

        override fun onFailure(errorCode: Int, message: String?) {
            // This publish and capture have been rolled back
        }
    }
)

Close the devices:

meetingEngine.closeCamera()
meetingEngine.closeMic()

Remote video must be rendered with VcsPlayerGlTextureView or VcsPlayerGlSurfaceView; a plain Android TextureView / SurfaceView doesn’t work. Look up the track from InfosManager, then get the RemoteVideoTrack through the asynchronous result callback.

val targetUid = "remote-user-001"
val trackInfo = meetingEngine.infosManager
    .getTrackInfoByTrackDesc(targetUid, TrackDesc.TRACK_MAIN.value)
    ?: return

meetingEngine.startPlayRemoteVideo(
    uid = targetUid,
    trackDesc = trackInfo.desc,
    view = remoteView,
    event = object : MeetingRemoteVideoSimpleEvent() {
        override fun onReceiveStreamStatusChange(
            uid: String,
            trackDesc: String,
            isChoke: Boolean
        ) {
            // Update the stutter indicator
        }
    },
    callback = object : MeetingValueResultCallback<RemoteVideoTrack> {
        override fun onSuccess(value: RemoteVideoTrack) {
            // Subscribed; you can keep using value to manage the render view
        }

        override fun onFailure(errorCode: Int, message: String?) {
            // Subscription failed
        }
    }
)

Unsubscribe:

meetingEngine.stopPlayRemoteVideo(targetUid, trackInfo.desc)

Next steps

MeetingEngine (Chinese): all public methods, parameters, and return values
Model types (Chinese): configuration and result models
Error codes: handling 202xxx and passed-through errors
Camera presets (Chinese): choosing resolution and bitrate
Audio routing (Chinese): speaker, earpiece, Bluetooth, and wired headsets

Overview

Web SDK

Android SDK

Swift SDK (iOS/macOS)

Server API

Prerequisites

1. Create and initialize the Engine

2. Create a meeting

3. Register in-meeting events

4. Enter and exit the meeting

5. Open and publish the camera and mic

Next steps

​Prerequisites

​1. Create and initialize the Engine

​2. Create a meeting

​3. Register in-meeting events

​4. Enter and exit the meeting

​5. Open and publish the camera and mic

​6. Subscribe to remote video

​Next steps

Prerequisites

1. Create and initialize the Engine

2. Create a meeting

3. Register in-meeting events

4. Enter and exit the meeting

5. Open and publish the camera and mic

6. Subscribe to remote video

Next steps