Webhooks and Events - Android

Event associated with Recording

• onRecordingStateChanged - Triggered whenever the room's recording state changes.

private val roomEventListener: RoomEventListener = object : RoomEventListener() {
  override fun onRecordingStateChanged(state: RecordingState) {
    when (state) {
        RecordingState.RECORDING_STARTING -> {
            Log.d("onRecordingStateChanged", "Recording is starting")
        }
        RecordingState.RECORDING_STARTED -> {
            Log.d("onRecordingStateChanged", "Recording is started")
        }
        RecordingState.RECORDING_STOPPING -> {
            Log.d("onRecordingStateChanged", "Recording is stopping")
        }
        RecordingState.RECORDING_STOPPED -> {
            Log.d("onRecordingStateChanged", "Recording is stopped")
        }
    }
  }
}

override fun onCreate(savedInstanceState: Bundle?) {
  //...

  // add listener to room
  room!!.addEventListener(roomEventListener)
}

Webhook associated with Recording

recording-starting

• A "Recording Starting" webhook is triggered when the recording process for a room is initiated.

Example

{
    "webhookType": "recording-starting",
    "data": {
        "meetingId": "jvsg-8rjn-j304",
        "sessionId": "613731342f27f56e4fc4b6d0",
    },
}

---

recording-started

• The recording started webhook is received when recording has started successfully in the room.

Example

{
    "webhookType": "recording-started",
    "data": {
        "meetingId": "jvsg-8rjn-j304",
        "sessionId": "613731342f27f56e4fc4b6d0",
    },
}

---

recording-stopping

• A "Recording Stopping" webhook is triggered when the recording end process for a room is initiated.

Example

{
    "webhookType": "recording-stopping",
    "data": {
        "meetingId": "jvsg-8rjn-j304",
        "sessionId": "613731342f27f56e4fc4b6d0",
    },
}

---

recording-stopped

• Recording stopped webhook will be received when recording is successfully stopped in the room.

Example

{
    "webhookType": "recording-stopped",
    "data": {
        "meetingId": "jvsg-8rjn-j304",
        "sessionId": "613731342f27f56e4fc4b6d0",
        "filePath" : "/encoded/videos/62d148951a1eb20029fc9b05.mp4",
        "fileUrl" : "https://cdn.videosdk.live/encoded/videos/62d148951a1eb20029fc9b05.mp4",

    },
}

---

recording-failed

• A "Recording Failed" webhook is generated when the recording process encounters an interruption or issue during either the starting or stopping phases.

Example

{
    "webhookType": "recording-failed",
    "data": {
        "meetingId": "jvsg-8rjn-j304",
        "sessionId": "613731342f27f56e4fc4b6d0",
    },
}