plcm-participant.xsd Documentation

Imported Namespaces

Target Namespace

Elements

plcm-participant  PlcmParticipant

A participant in a multipoint conference. From a technical perspective, there is a one to one correspondence between participants and signaling sessions. It is possible for a single person to call into a conference from multiple endpoints, and count as multiple participants. Immersive Telepresence endpoints may count as one or multiple participants, depending on how they handle signaling. Content-Type: application/vnd.plcm.plcm-participant+xml. All attributes are used in ETag calculation except for entity-tag and atom-link.


Complex Types

PlcmParticipant Fields

NameTypeDescriptionAttributes
atomLinkList List of linkSee Definition of link
participant-identifierParticipantIdentifier The unique identifier for this participant. This system assigned identifier is not meaningful.
display-nameDisplayName The display name for this participant.
endpoint-identifierEndpointIdentifier The unique identifier for this participant's endpoint, if it is a registered endpoint.
endpoint-nameEndpointName The display name of this participant's endpoint. For H.323 endpoints, this is the h323-ID. For SIP endpoints, this is the user part of the SIP URI.
dial-stringDialString The phone number of this participant's endpoint. For H.323 endpoints, this is the dialedDigits-ID. For SIP endpoints, this is the SIP URI. Mandatory
conference-identifierConferenceIdentifier The unique identifier for the conference this participant belongs to.
mcu-nameMcuName The name of the MCU this participant is on.
connection-statusConnectionStatus The status of the connection to this participant
chairpersonxs:boolean Indicates whether this participant is a chairperson. Chairpersons have greater privileges than other participants.
lecturerxs:boolean Indicates whether this participant is the lecturer. In lecture-mode conferences, the lecturer's video will be displayed even when other participants are talking.
audio-mutexs:boolean Indicates whether this participant is audio-muted. Audio-muted participants can not be heard.
video-mutexs:boolean Indicates whether this participant is video-muted. Video-muted participants can not be seen.
signaling-protocolSignalingProtocol The signaling protocol use to establish the participant's call.
encrypted-mediaxs:boolean Indicates whether the media stream between the conference and this participant is encrypted.
current-call-bitrate-kbpsxs:unsignedInt The status of the current bitrate applied to the participant's call in kilobits per second. Note that the API client cannot set this value. It is only used for network bandwidth status information.
current-layoutCurrentLayout The name of the current video layout used by the MCU for the conference. Note that the API client cannot set this value.
passbackPassback User defined value for that is opaque to the system.
passthruPassthru User defined value that that is opaque to the system. Note: this value is available after the call is terminated in the userDataC field in the call CDR.
speakerxs:boolean Indicates that this participant is currently speaking.
forward-dtmf-sourceForwardDtmfSource The presence of this attribute indicates that DTMF should be forwarded from a chairperson to this participant. This attribute is set to the SIP URI of the chairperson if the URI is available, otherwise it is set to the literal string "chairperson". This attribute can be set only when a new dial-out participant is created using the REST-API request createParticipant, changing it during a call has no effect.
entity-tagEntityTag The unique value generated from the server object instance. This value is the same value that MUST be applied to the HTTP Entity Tag (ETag) header for a single instance of this object. Client modification of this field is not allowed for this instance.
audio-mute-by-endpointxs:boolean Indicates whether this participant is audio-muted by the end point. Audio-muted participants can not be heard. Note: This field is different than the audio-mute field which is muted by the API to the MCU (or directly by the MCU UI). This field is read only, and can only be changed by the endpoint user; it cannot be changed by the API.
video-mute-by-endpointxs:boolean Indicates whether this participant is video-muted by the participant's endpoint. Video-muted participants can not be seen. Note: This field is different from the video-mute field which indicates that the participant is video muted on the MCU rather than on the participant endpoint. This field is read only and cannot be changed by the API.
audio-mute-by-mcuxs:boolean Indicates whether this participant is audio-muted by the MCU. Audio-muted participants can not be heard. Note that this field is different from the audio-mute field. This field indicates that the participant is muted by non-operator actions detected by the MCU (such as the chairperson using the "mute all except me" DTMF command). This field is read only and cannot be changed by the API.
connection-start-timexs:dateTime


Simple Types


NameTypeRestrictions
EntityTagxs:string
Length of value must be >=1
Length of value must be <=64
ForwardDtmfSourcexs:string
Length of value must be >=1
Length of value must be <=128
Passthruxs:string
Length of value must be >=1
Length of value must be <=512
Passbackxs:string
Length of value must be >=1
Length of value must be <=512
CurrentLayoutxs:string
Length of value must be >=1
Length of value must be <=128
SignalingProtocolxs:string
Value must be one of:
  • H323
  • SIP
  • SIP_H323
  • ISDN
  • UNKNOWN
  • WEBRTC
  • POLY_EVO
ConnectionStatusxs:string
Value must be one of:
  • UNKNOWN
  • CONNECTED_DIAL_IN
  • CONNECTED_DIAL_OUT
McuNamexs:string
Length of value must be >=1
Length of value must be <=128
ConferenceIdentifierxs:string
Length of value must be >=1
Length of value must be <=128
DialStringxs:string
Length of value must be >=1
Length of value must be <=128
EndpointNamexs:string
Length of value must be >=1
Length of value must be <=128
EndpointIdentifierxs:string
Length of value must be >=1
Length of value must be <=128
DisplayNamexs:string
Length of value must be >=1
Length of value must be <=128
ParticipantIdentifierxs:string
Length of value must be >=1
Length of value must be <=128