Kotlin SDK API Reference

1dependencies {
2    implementation("com.baxcloud:client:1.0.0")
3}

1<uses-permission android:name="android.permission.CAMERA" />
2<uses-permission android:name="android.permission.RECORD_AUDIO" />
3<uses-permission android:name="android.permission.INTERNET" />

1import android.Manifest
2import android.content.pm.PackageManager
3import androidx.core.app.ActivityCompat
4import androidx.core.content.ContextCompat
5
6fun requestPermissions(activity: Activity) {
7    val permissions = arrayOf(
8        Manifest.permission.CAMERA,
9        Manifest.permission.RECORD_AUDIO
10    )
11    
12    if (permissions.any { 
13        ContextCompat.checkSelfPermission(activity, it) != PackageManager.PERMISSION_GRANTED 
14    }) {
15        ActivityCompat.requestPermissions(activity, permissions, REQUEST_CODE)
16    }
17}

1import com.baxcloud.client.BaxCloudClient
2import com.baxcloud.client.BaxCloudConfig
3
4val client = BaxCloudClient(
5    context = applicationContext,
6    config = BaxCloudConfig(
7        projectId = "your-project-id",
8        apiKey = "your-api-key"
9    )
10)

1lifecycleScope.launch {
2    val room = client.createRoom(
3        BaxcloudCreateRoomOptions(
4            roomName = "meeting-123",
5            liveType = BaxcloudLiveType.VIDEO_CONFERENCE,
6            maxParticipants = 50
7        )
8    )
9    println("Room created: ${room.roomName}")
10}

lifecycleScope.launch {
    client.deleteRoom("meeting-123")
}

lifecycleScope.launch {
    val rooms = client.listRooms()
    println("Total rooms: ${rooms.size}")
}

lifecycleScope.launch {
    val room = client.getRoom("meeting-123")
    println("Room info: $room")
}

1lifecycleScope.launch {
2    val token = client.getToken(
3        BaxcloudRoomOptions(
4            roomName = "meeting-123",
5            participant = BaxcloudUser(
6                userId = "user-1",
7                name = "Alice",
8                avatarUrl = "https://example.com/avatar.jpg",
9                isHost = true
10            ),
11            liveType = BaxcloudLiveType.VIDEO_CONFERENCE
12        )
13    )
14    println("Access token: ${token.token}")
15}

1lifecycleScope.launch {
2    try {
3        val room = client.connect(
4            BaxcloudRoomOptions(
5                roomName = "my-room",
6                participant = BaxcloudUser(
7                    userId = "user-123",
8                    name = "John Doe",
9                    avatarUrl = "https://example.com/avatar.jpg",
10                    isHost = true
11                ),
12                liveType = BaxcloudLiveType.VIDEO_CALL,
13                canJoinWithNoHost = true
14            )
15        )
16        println("Connected to room: ${room.name}")
17    } catch (e: Exception) {
18        println("Connection failed: ${e.message}")
19    }
20}

lifecycleScope.launch {
    client.disconnect()
    println("Disconnected from room")
}

lifecycleScope.launch {
    client.sendRealtimeMessage(
        BaxcloudSendRealtimeMessageOptions(
            roomName = "meeting-123",
            message = "Hello everyone!",
            sender = BaxcloudUser(
                userId = "user-1",
                name = "Alice"
            )
        )
    )
}

1lifecycleScope.launch {
2    val recording = client.startRecording(
3        BaxcloudStartRecordingOptions(
4            roomName = "my-room",
5            fileType = "MP4"
6        )
7    )
8    println("Recording started: ${recording.egressId}")
9}

lifecycleScope.launch {
    client.stopRecording(recording.egressId)
    println("Recording stopped")
}

1lifecycleScope.launch {
2    // List all active recordings
3    val activeRecordings = client.listActiveRecordings()
4    
5    // List active recordings for a specific room
6    val roomRecordings = client.listActiveRecordings("my-room")
7}

1lifecycleScope.launch {
2    val recordings = client.listRecordings(
3        BaxcloudListRecordingsOptions(
4            status = "COMPLETED",
5            page = 1,
6            limit = 20
7        )
8    )
9    println("Recordings: ${recordings.items}")
10    println("Total: ${recordings.meta.total}")
11}

lifecycleScope.launch {
    val recording = client.getRecording("recording-123")
    println("Recording status: ${recording.status}")
    println("File URL: ${recording.fileUrl}")
}

1lifecycleScope.launch {
2    val result = client.getRecordingDownloadUrl("recording-123", 7200)
3    val downloadUrl = result["downloadUrl"] as String
4    val expiresIn = result["expiresIn"] as Int
5    println("Download URL (expires in 2 hours): $downloadUrl")
6}

1val controller = BaxCloudRoomController.instance
2controller.initialize(client, context)

<uses-permission android:name="android.permission.CAMERA" />
<uses-permission android:name="android.permission.RECORD_AUDIO" />
<uses-permission android:name="android.permission.INTERNET" />