Skip to content

Commit d5464db

Browse files
authored
Document potential pitfall when creating LocalVideoTrack manually. (#556)
1 parent dcbb36b commit d5464db

File tree

1 file changed

+5
-0
lines changed

1 file changed

+5
-0
lines changed

livekit-android-sdk/src/main/java/io/livekit/android/room/participant/LocalParticipant.kt

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -156,6 +156,11 @@ internal constructor(
156156
/**
157157
* Creates a video track, recording video through the camera with the given [options].
158158
*
159+
* Note: If using this in conjunction with [setCameraEnabled], ensure that your created
160+
* camera track is published first before using [setCameraEnabled]. Otherwise, the LiveKit
161+
* SDK will attempt to create its own camera track to manage, and will cause issues since
162+
* generally only one camera session can be active at a time.
163+
*
159164
* @param name The name of the track
160165
* @param options The capture options to use for this track, or [Room.videoTrackCaptureDefaults] if none is passed.
161166
* @param videoProcessor A video processor to attach to this track that can modify the frames before publishing.

0 commit comments

Comments
 (0)