iOS Video Application Recommendations and Best Practices

1
var room: Room? // Set when connected to a video room
2
var micTrack: LocalAudioTrack?
3

4
var isLocalMicOn = false {
5
    didSet {
6
        guard oldValue != isLocalMicOn else {
7
            return
8
        }
9

10
        if isLocalMicOn {
11
            guard let micTrack = LocalAudioTrack(options: nil, enabled: true, name: "mic") else {
12
                return
13
            }
14

15
            self.micTrack = micTrack
16
            room?.localParticipant?.publishAudioTrack(micTrack)
17
        } else {
18
            guard let micTrack = micTrack else {
19
                return
20
            }
21

22
            room?.localParticipant?.unpublishAudioTrack(micTrack)
23
            self.micTrack = nil
24
        }
25
    }
26
}

1
var room: Room? // Set when connected to a video room
2
var cameraSource: CameraSource?
3
var cameraTrack: CameraTrack?
4

5
var isLocalCameraOn = false {
6
    didSet {
7
        guard oldValue != isLocalCameraOn else {
8
            return
9
        }
10

11
        if isLocalCameraOn {
12
            guard
13
                let cameraSource = CameraSource(delegate: self),
14
                let cameraTrack = LocalVideoTrack(source: cameraSource, enabled: true, name: "camera")
15
                let captureDevice = CameraSource.captureDevice(position: .front),
16
            else {
17
                return
18
            }
19

20
            cameraSource.startCapture(device: captureDevice, completion: nil)
21

22
            room?.localParticipant?.publishVideoTrack(cameraTrack)
23
            self.cameraSource = cameraSource
24
            self.cameraTrack = cameraTrack
25
        } else {
26
            if let cameraTrack = cameraTrack {
27
                participant?.unpublishVideoTrack(cameraTrack)
28
            }
29

30
            cameraSource?.stopCapture()
31
            cameraSource = nil
32
            cameraTrack = nil
33
        }
34
    }
35
}

1
extension RemoteParticipant {
2
    var isMicOn: Bool {
3
        // Make sure to use the same track name that your app is using to create the microphone track
4
        guard let track = participant.remoteAudioTracks.first(where: { $0.trackName == "mic" }) else {
5
            return false
6
        }
7

8
        return track.isTrackSubscribed && track.isTrackEnabled
9
    }
10

11
    var isCameraOn: Bool {
12
        // Make sure to use the same track name that your app is using to create the camera track
13
        guard let track = participant.remoteVideoTracks.first(where: { $0.trackName == "camera" }) else {
14
            return false
15
        }
16

17
        return track.isTrackSubscribed && track.isTrackEnabled
18
    }
19
}

1
var cameraTrack: CameraTrack? // Set when camera is turned on
2

3
// CameraSourceDelegate
4
func cameraSourceWasInterrupted(source: CameraSource, reason: AVCaptureSession.InterruptionReason) {
5
    cameraTrack?.isEnabled = false
6
}
7

8
func cameraSourceInterruptionEnded(source: CameraSource) {
9
    cameraTrack?.isEnabled = true
10
}

1
// RoomDelegate function
2
func roomDidFailToConnect(room: Room, error: Error) {
3
    // Handle error
4
}

1
// RoomDelegate function
2
func roomDidDisconnect(room: Room, error: Error?) {
3
    if let error = error {
4
        // Handle error
5
    }
6
}