Participant.kt
5.4 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
package io.livekit.android.room.participant
import io.livekit.android.room.track.LocalTrackPublication
import io.livekit.android.room.track.RemoteTrackPublication
import io.livekit.android.room.track.Track
import io.livekit.android.room.track.TrackPublication
import livekit.LivekitModels
open class Participant(var sid: String, identity: String? = null) {
var participantInfo: LivekitModels.ParticipantInfo? = null
private set
var identity: String? = identity
internal set
var audioLevel: Float = 0f
internal set
var isSpeaking: Boolean = false
internal set(v) {
val changed = v == field
field = v
if (changed) {
listener?.onSpeakingChanged(this)
internalListener?.onSpeakingChanged(this)
}
}
var metadata: String? = null
internal set(v) {
val prevMetadata = field
field = v
if (prevMetadata != v) {
listener?.onMetadataChanged(this, prevMetadata)
internalListener?.onMetadataChanged(this, prevMetadata)
}
}
var connectionQuality: ConnectionQuality = ConnectionQuality.UNKNOWN
internal set
/**
* Listener for when participant properties change
*/
var listener: ParticipantListener? = null
/**
* @suppress
*/
internal var internalListener: ParticipantListener? = null
val hasInfo
get() = participantInfo != null
var tracks = mutableMapOf<String, TrackPublication>()
var audioTracks = mutableMapOf<String, TrackPublication>()
private set
var videoTracks = mutableMapOf<String, TrackPublication>()
private set
/**
* @suppress
*/
fun addTrackPublication(publication: TrackPublication) {
val track = publication.track
track?.sid = publication.sid
tracks[publication.sid] = publication
when (publication.kind) {
Track.Kind.AUDIO -> audioTracks[publication.sid] = publication
Track.Kind.VIDEO -> videoTracks[publication.sid] = publication
else -> {}
}
}
/**
* @suppress
*/
internal open fun updateFromInfo(info: LivekitModels.ParticipantInfo) {
sid = info.sid
identity = info.identity
participantInfo = info
metadata = info.metadata
}
override fun equals(other: Any?): Boolean {
if (this === other) return true
if (javaClass != other?.javaClass) return false
other as Participant
if (sid != other.sid) return false
return true
}
override fun hashCode(): Int {
return sid.hashCode()
}
}
interface ParticipantListener {
// all participants
/**
* When a participant's metadata is updated, fired for all participants
*/
fun onMetadataChanged(participant: Participant, prevMetadata: String?) {}
/**
* Fired when the current participant's isSpeaking property changes. (including LocalParticipant)
*/
fun onSpeakingChanged(participant: Participant) {}
/**
* The participant was muted.
*
* For the local participant, the callback will be called if setMute was called on the
* [LocalTrackPublication], or if the server has requested the participant to be muted
*/
fun onTrackMuted(publication: TrackPublication, participant: Participant) {}
/**
* The participant was unmuted.
*
* For the local participant, the callback will be called if setMute was called on the
* [LocalTrackPublication], or if the server has requested the participant to be muted
*/
fun onTrackUnmuted(publication: TrackPublication, participant: Participant) {}
// remote participants
/**
* When a new track is published to room after the local participant has joined.
*
* It will not fire for tracks that are already published
*/
fun onTrackPublished(publication: RemoteTrackPublication, participant: RemoteParticipant) {}
/**
* A [RemoteParticipant] has unpublished a track
*/
fun onTrackUnpublished(publication: RemoteTrackPublication, participant: RemoteParticipant) {}
/**
* Subscribed to a new track
*/
fun onTrackSubscribed(track: Track, publication: RemoteTrackPublication, participant: RemoteParticipant) {}
/**
* Error had occurred while subscribing to a track
*/
fun onTrackSubscriptionFailed(
sid: String,
exception: Exception,
participant: RemoteParticipant
) {
}
/**
* A subscribed track is no longer available.
* Clients should listen to this event and handle cleanup
*/
fun onTrackUnsubscribed(
track: Track,
publication: RemoteTrackPublication,
participant: RemoteParticipant
) {
}
/**
* Received data published by another participant
*/
fun onDataReceived(data: ByteArray, participant: RemoteParticipant) {}
}
enum class ConnectionQuality {
EXCELLENT,
GOOD,
POOR,
UNKNOWN;
companion object {
fun fromProto(proto: LivekitModels.ConnectionQuality): ConnectionQuality {
return when (proto) {
LivekitModels.ConnectionQuality.EXCELLENT -> EXCELLENT
LivekitModels.ConnectionQuality.GOOD -> GOOD
LivekitModels.ConnectionQuality.POOR -> POOR
LivekitModels.ConnectionQuality.UNRECOGNIZED -> UNKNOWN
}
}
}
}