Interface Conference


  • public interface Conference
    Conference interface is accessible from the Call interface, and provides access to conferencing related capabilities and actions. The Conference interface provides a set of APIs that allow application developers to access the different features and services provided by Avaya's different conferencing solutions. In general, the capabilities and the set of allowed operations are not only dependent on the capabilities of the conferencing server, but also on the specific privileges assigned to the local user on the conference call. For example, if the local user is a moderator of the call, (s)he will be able to perform conference operations such as lock/unlock the call, start/stop recording, as well as operations on participants such as mute/unmute, add a new participant to the call, or drop an existing participant from the call. Status updates reported by the conference server are reported through the ConferenceListener objects registered with the Conference object.
    • Method Detail

      • addListener

        void addListener​(ConferenceListener listener)
        Adds a new ConferenceListener to the conference object.
        Parameters:
        listener - Listener to be added to the conference.
      • removeListener

        void removeListener​(ConferenceListener listener)
        Removes a ConferenceListener from the conference.
        Parameters:
        listener - Listener instance that is removed from the conference.
      • isConferenceWaitingToStart

        boolean isConferenceWaitingToStart()
        Returns whether the conference call is waiting to be started. If the conference has not started, because the conference requires a moderator to join before start, the method call returns true.

        Note: This feature is not fully supported across all conferencing platforms.

        Returns:
        Conference start status.
      • getInConferenceChatCapability

        Capability getInConferenceChatCapability()
        Returns whether in-conference chat is supported. In-conference chat allows conference participants to exchange messages amongst each other without interrupting the speaker. These messages can either be private between selected participants or shared with all conference participants. The application may use the result of this query to enable or disable chat functions. See Chat for more information about the in-conference chat feature. In-conference chat capability is not supported when the client is used in shared control mode. See SharedControlService
        Returns:
        In-conference chat capability information.
        See Also:
        getInConferenceChat()
      • getInConferenceChat

        Chat getInConferenceChat()
        Returns the Chat object associated with the conference call. The Chat object can be used to query for the current list of messages or to send a new message.
        Returns:
        Chat object associated with the conference call.
        See Also:
        getInConferenceChatCapability()
      • getMeetingMinutesCapability

        Capability getMeetingMinutesCapability()
        Returns whether the meeting minutes feature is supported. The meeting minutes feature allows conference participants to enter notes, for example, to mark the beginning of a new topic during a conference call. See MeetingMinutes for more information about the meeting minutes feature. The application may use the result of this query to enable or disable meeting minutes related functions. Meeting minutes capability is not supported when the client is used in shared control mode. See SharedControlService
        Returns:
        Meeting minutes capability information.
        See Also:
        getMeetingMinutes()
      • getMeetingMinutes

        MeetingMinutes getMeetingMinutes()
        Returns the MeetingMinutes object associated with the conference call. The MeetingMinutes object can be used to query for the list of meeting notes, add a new note, or edit or remove an existing note.
        Returns:
        MeetingMinutes object associated with the conference call.
        See Also:
        getMeetingMinutesCapability()
      • getMobileLinkCapability

        Capability getMobileLinkCapability()
        Returns whether the conference mobile link feature is supported for the conference call. The mobile link feature allows an application to control a conference call while terminating audio and video on a conferencing room system. The application may use the result of this query to enable or disable mobile link related functions. The support for the mobile link is dependent on the conferencing system version. See ConferenceMobileLink for more information about the conference mobile link feature. Mobile link capability is not supported when the client is used in shared control mode. See SharedControlService
        Returns:
        Conference mobile link capability information.
        See Also:
        getMobileLink()
      • getContentSlideViewerCapability

        Capability getContentSlideViewerCapability()
        Returns whether viewing of previously shared slides is supported by the conference call. For example, a person who joins a conference call late can use the content slide viewer feature to view the document pages that have already been shared during the call. The application may use the result of this query to enable or disable functions related to viewing of previously shared slides during the conference. The support for the content slide viewer is dependent on the conferencing system version. See ConferenceSlideViewer for more information. The content slide viewer capability is not supported when the client is used in shared control mode. See SharedControlService
        Returns:
        Content slide viewer capability information.
        See Also:
        getContentSlideViewer()
      • getCollaborationURI

        java.lang.String getCollaborationURI()
        Returns the collaboration URI associated with the conference call, if the conference call is capable of supporting collaboration. If the conference is not capable of supporting collaboration, null is returned.
        Returns:
        Collaboration URI associated with the conference call.
      • getRequestToBecomeModeratorCapability

        Capability getRequestToBecomeModeratorCapability()
        Returns whether the conference server allows the local user to request to become a moderator. This capability is not supported if the conference server does not support a self-promotion mechanism to become a moderator, or if the local user is already a moderator. The application may use the result of this query to enable or disable functions related to requesting to become a moderator. Conference moderation features are not supported when the client is used in shared control mode. See SharedControlService
        Returns:
        Capability information.
        See Also:
        isPinRequiredToBecomeModerator(), requestToBecomeModerator(String, CallCompletionHandler)
      • isPinRequiredToBecomeModerator

        boolean isPinRequiredToBecomeModerator()
        Returns whether the conference call requires entry of a moderator PIN before the local user is allowed to become a moderator. The method returns true only if getRequestToBecomeModeratorCapability() returns supported indication. The application may use this method to prompt the user for moderator PIN before calling requestToBecomeModerator.
        Returns:
        Status of whether PIN is required to become a moderator.
        See Also:
        getRequestToBecomeModeratorCapability()
      • getModerateConferenceCapability

        Capability getModerateConferenceCapability()
        Returns whether the local user can moderate the conference call. The capability returns not supported if the conference call does not have a moderator, or if the local user is not a moderator. Conference moderation features are not supported when the client is used in shared control mode. See SharedControlService
        Returns:
        Moderate conference capability information.
      • getActiveTalkerCapability

        Capability getActiveTalkerCapability()
        Returns whether the conference call reports the active talker information. Reporting of active talkers is dependent on the capabilities of the conferencing system. Active talker capability is not supported when the client is used in shared control mode. See SharedControlService
        Returns:
        Active talker capability information.
        See Also:
        getActiveTalkers()
      • getUpdateLockStatusCapability

        Capability getUpdateLockStatusCapability()
        Returns whether local user can lock/unlock the conference call. The capability returns not supported if the conference call does not support lock/unlock, or if the local user does not have permission to lock/unlock the conference call. Conference moderation capabilities are not supported when the client is used in shared control mode. See SharedControlService
        Returns:
        Update lock status capability information.
        See Also:
        isLocked(), setLocked(boolean, CallCompletionHandler)
      • setLocked

        void setLocked​(boolean lock,
                       CallCompletionHandler handler)
        Locks or unlocks the conference call. If the call is not a conference call or the conference call is not locked, an error indication is returned through the CallCompletionHandler object. When the operation is successful, a status update is reported through the ConferenceListener registered with this Conference object.
        Parameters:
        lock - Set to true to lock the call or false to unlock the call.
        handler - CallCompletionHandler object that wants to learn about the result of the operation, i.e., whether it was successful.
        See Also:
        getUpdateLockStatusCapability(), isLocked()
      • getUpdateLectureModeStatusCapability

        Capability getUpdateLectureModeStatusCapability()
        Returns whether local user can put the conference call into lecture mode. The capability returns not supported if the conference call does not support lecture mode, or if the local user does not have permission to set the call into lecture mode. Conference moderation capabilities are not supported when the client is used in shared control mode. See SharedControlService
        Returns:
        Set lecture mode capability information.
        See Also:
        isLectureModeActive(), setLectureMode(boolean, CallCompletionHandler)
      • setLectureMode

        void setLectureMode​(boolean lecture,
                            CallCompletionHandler handler)
        Enables or disables lecture mode for the conference call. The result of the operation is reported through the input CallCompletionHandler object. When the operation is successful, a status update is reported through the ConferenceListener registered with this Conference object.
        Parameters:
        lecture - Set to true to enable lecture mode for the conference call; false to turn off lecture mode.
        handler - CallCompletionHandler object that wants to learn about the result of the operation, i.e., whether it was successful.
        See Also:
        getUpdateLectureModeStatusCapability(), isLocked()
      • getUpdateContinuationStatusCapability

        Capability getUpdateContinuationStatusCapability()
        Returns whether the local user can change the conference call continuation mode. Call continuation mode allows the conference call to continue after the moderator leaves the conference call. This feature is not applicable to all Avaya conferencing solutions. The capability returns not supported if the conference call does not support conference continuation after the moderator leaves the call, or if the local user does not have permission to set the call continuation mode. Conference moderation capabilities are not supported when the client is used in shared control mode. See SharedControlService
        Returns:
        Update conference continuation capability information.
        See Also:
        isContinuationActive(), setContinuation(boolean, CallCompletionHandler)
      • setContinuation

        void setContinuation​(boolean continuation,
                             CallCompletionHandler handler)
        Enables or disables conference continuation mode for the conference call. Call continuation mode allows the conference call to continue after the moderator leaves the conference call. When the operation is successful, a status update is reported through the ConferenceListener registered with this Conference object.
        Parameters:
        continuation - Set to true to enable conference continuation after moderator exits the call; false to end the conference call when the moderator exits the call.
        handler - CallCompletionHandler object that wants to know success or failure of the operation.
        See Also:
        getUpdateContinuationStatusCapability(), isContinuationActive()
      • getExtendMeetingCapability

        Capability getExtendMeetingCapability()
        Returns whether the local user can extend the end time of the conference call, if the conference has an end time set. The capability returns not supported if the conference call does not support meeting extension, or if the local user does not have permission to extend the conference call. Conference moderation capabilities are not supported when the client is used in shared control mode. See SharedControlService
        Returns:
        Extend meeting capability information.
        See Also:
        getMeetingEndTime(), extendMeeting(int, CallCompletionHandler)
      • getMeetingEndTime

        java.util.Date getMeetingEndTime()
        Returns the meeting end time if an end time is specified for the conference call. If there is no meeting end time specified, the method returns null.
        Returns:
        Meeting end time, if one is specified, null, otherwise.
        See Also:
        Date, getExtendMeetingCapability(), extendMeeting(int, CallCompletionHandler)
      • extendMeeting

        void extendMeeting​(int additionalTimeInMinutes,
                           CallCompletionHandler handler)
        Extends the current meeting end time by the specified number of minutes. When the operation is successful, a status update is reported through the ConferenceListener registered with this Conference object.
        Parameters:
        additionalTimeInMinutes - Additional time by which the conference call is extended.
        handler - CallCompletionHandler object that wants to learn about the result of the operation, i.e., whether it was successful.
        Throws:
        java.lang.IllegalArgumentException - if the additionalTimeInMinutes value is negative
        See Also:
        getExtendMeetingCapability(), getMeetingEndTime()
      • getStartRecordingCapability

        Capability getStartRecordingCapability()
        Returns whether the local user can start conference recording. The capability returns not supported if the conference call does not support recording, or if the local user does not have permission to start recording of the call, or if recording is already active. Conference moderation capabilities are not supported when the client is used in shared control mode. See SharedControlService
        Returns:
        Start recording capability information.
        See Also:
        isRecordingActive(), startRecording(CallCompletionHandler), stopRecording(CallCompletionHandler)
      • getUpdateVideoAllowedStatusCapability

        Capability getUpdateVideoAllowedStatusCapability()
        Returns whether the local user can enable/disable video for the conference call. The capability returns not supported if the conference call does not support control of video allow/disallow, or if the local user does not have permission to control video allow/disallow status of the call. Conference video capabilities are not supported when the client is used in shared control mode. See SharedControlService
        Returns:
        capability information.
        See Also:
        isVideoAllowed(), setVideoAllowed(boolean, CallCompletionHandler)
      • getUpdateEntryExitToneStatusCapability

        Capability getUpdateEntryExitToneStatusCapability()
        Returns whether the local user can control the entry/exit tone setting of the conference call. The capability returns not supported if the conference call does not support entry/exit tones, or if the local user does not have permission to control the entry/exit tones. Conference moderation capabilities are not supported when the client is used in shared control mode. See SharedControlService
        Returns:
        capability information.
        See Also:
        isEntryExitToneActive(), setEntryExitTone(boolean, CallCompletionHandler)
      • getStreamingStatus

        ConferenceStreamingStatus getStreamingStatus()
        Returns whether streaming is enabled for the conference call. The streaming option is specified at conference creation/reservation time, prior to the endpoints joining the conference call.
        Returns:
        Current conference streaming status.
        See Also:
        ConferenceStreamingStatus, getStreamingURI()
      • getStreamingURI

        java.lang.String getStreamingURI()
        Returns the streaming URI for the conference call. The method returns an empty string if streaming is not enabled for the call, or is not supported by the conference server.
        Returns:
        Streaming URI.
        See Also:
        getStreamingStatus()
      • getSubject

        java.lang.String getSubject()
        Returns the subject of the conference if one is provided by the conference server. If there is no subject provided, the method returns null.
        Returns:
        Subject of the conference call.
      • getBrandName

        java.lang.String getBrandName()
        Returns the brand name of the conference if one is provided by the conference server. If there is no brand name provided, the method returns null.
        Returns:
        Brand name of the conference call, e.g., Scopia.
      • getEndConferenceCapability

        Capability getEndConferenceCapability()
        Returns whether the local user can terminate the conference call for all participants. The capability returns not supported if the local user does not have permission to terminate the conference. Conference moderation capabilities are not supported when the client is used in shared control mode. See SharedControlService
        Returns:
        Terminate conference capability information.
        See Also:
        endConference(CallCompletionHandler)
      • endConference

        void endConference​(CallCompletionHandler handler)
        Ends the conference call for all conference participants. This action can only be invoked by a conference moderator.
        Parameters:
        handler - CallCompletionHandler object that wants to learn about the result of the operation, i.e., whether it was successful.
        See Also:
        getEndConferenceCapability()
      • getRetrieveDialInInformationCapability

        Capability getRetrieveDialInInformationCapability()
        Returns whether the user can retrieve dialing information from the conference server The capability returns not supported if the conference server doesn't support this indication.
        Returns:
        Retrieve Dialing Information conference capability information.
        See Also:
        retrieveDialInInformation(CompletionHandlerWithResult)
      • signIn

        void signIn​(java.lang.String portalUserToken,
                    CallCompletionHandler handler)
        Sign in to become a named user in the conference.
        Parameters:
        portalUserToken - User token received from the portal.
        handler - The CallCompletionHandler object that wants to learn about the result of the operation, i.e., whether it was successful.
      • getUpdateMultiplePresentersCapability

        Capability getUpdateMultiplePresentersCapability()
        Returns whether local user can control panel mode status of the conference call. The capability returns not supported if the conference call does not support panel mode setting, or if the local user does not have permission to control the panel mode setting. Update multiple presenters capability is not supported when the client is used in shared control mode. See SharedControlService
        Returns:
        Update allowance of multiple presenters capability information.
        See Also:
        areMultiplePresentersAllowed(), setMultiplePresentersAllowed(boolean, CallCompletionHandler)
      • isPasscodeRequiredToEnterConference

        boolean isPasscodeRequiredToEnterConference()
        Returns whether the current conference is in waiting passcode state or not. see #sendPasscode(String, CallCompletionHandler)
        Returns:
        True if the current conference is in waiting passcode state.
      • isExternalAdmissionRequiredToEnterConference

        boolean isExternalAdmissionRequiredToEnterConference()
        Returns whether the current conference is in waiting external admission state or not. External admission should be done through DTMF.
        Returns:
        True if the current conference is in waiting external admission state.
      • isPermissionRequiredToEnterLockedConference

        boolean isPermissionRequiredToEnterLockedConference()
        Indicates whether the current conference is waiting access to join locked conference.
        Returns:
        True if the current conference is waiting access to join locked conference.
      • getUpdateVideoSelfSeeCapability

        Capability getUpdateVideoSelfSeeCapability()
        Returns whether the local user can control the display of the local user's video in the personal video layout received from the conference server. The capability returns not supported if the conference call does not support this feature. Conference video capabilities are not supported when the client is used in shared control mode. See SharedControlService
        Returns:
        Video self see capability information.
        See Also:
        isVideoSelfSeeActive(), setVideoSelfSee(boolean, CallCompletionHandler)
      • setVideoSelfSee

        void setVideoSelfSee​(boolean selfSee,
                             CallCompletionHandler handler)
        Controls the display of the local user's video in the personal video layout received from the conference server. When the operation is successful, a status update is reported through the ConferenceListener registered with this Conference object.
        Parameters:
        selfSee - true if local video is to be shown in the video; false if local video is to be hidden.
        handler - CallCompletionHandler object that wants to learn about the result of the operation, i.e., whether it was successful.
        See Also:
        getUpdateVideoSelfSeeCapability(), isVideoSelfSeeActive()
      • isActiveSpeakerVideoAlwaysDisplayed

        boolean isActiveSpeakerVideoAlwaysDisplayed()
        Returns whether 'always display active speaker's video' option is currently enabled. This property cannot be changed programmatically.
        Returns:
        Current status of the 'always display active speaker's video' option.
      • getVideoPinCapability

        Capability getVideoPinCapability()
        Returns whether the local user can pin a specific participant's video in a specific position of the current video layout. This capability returns not supported if the conference call does not support video pinning, or video pin requests. Conference video capabilities are not supported when the client is used in shared control mode. See SharedControlService
        Returns:
        Pin video capability information.
        See Also:
        pinVideo(float, float, float, float, CallCompletionHandler)
      • pinVideo

        void pinVideo​(float sourceXCoordinate,
                      float sourceYCoordinate,
                      float destinationXCoordinate,
                      float destinationYCoordinate,
                      CallCompletionHandler handler)
        Requests for a specific participant's video to be pinned in a certain area of the video image. The source and destination coordinates can be any point within a video region inside the video image. They do not have to be a point at the boundary of the video region. In order to undo a previous video pin operation, the application needs to call setVideoLayout(com.avaya.clientservices.call.conference.VideoLayout, com.avaya.clientservices.call.CallCompletionHandler) and specify the VideoLayoutType.DYNAMIC layout option.
        Parameters:
        sourceXCoordinate - Horizontal coordinate of the participant's initial video position in the video image. The float type value in range (0.0, 1.0), with 0.0 referring to the left most side, and 1.0 to the right most side of the video image.
        sourceYCoordinate - Vertical coordinate of the participant's initial video position in the video image. The float type value in range (0.0, 1.0), with 0.0 referring to the top, and 1.0 to the bottom of the video image.
        destinationXCoordinate - Horizontal coordinate of the participant's final video position in the video image. The float type value in range (0.0, 1.0), with 0.0 referring to the left most side, and 1.0 to the right most side of the video image.
        destinationYCoordinate - Vertical coordinate of the participant's final video position in the video image. The float type value in range (0.0, 1.0), with 0.0 referring to the top, and 1.0 to the bottom of the video image.
        handler - CallCompletionHandler object that wants to learn about the result of the operation, i.e., whether it was successful.
        Throws:
        java.lang.IllegalArgumentException - if either of the coordinates is outside of the allowed range (0.0, 1.0)
        See Also:
        getVideoPinCapability()
      • getRaiseHandCapability

        Capability getRaiseHandCapability()
        Returns whether the local user can raise hand (e.g., to get moderator's or panelists' attention). The capability returns not supported if the conference call does not support raising hand. Raise hand capability is not supported when the client is used in shared control mode. See SharedControlService
        Returns:
        Raise hand capability information.
        See Also:
        isHandRaised(), raiseHand(CallCompletionHandler)
      • getLowerHandCapability

        Capability getLowerHandCapability()
        Returns whether the local user can lower hand, when hand was previously raised to get moderator's or panelists' attention. The capability returns not supported if the conference call does not support lowering hand. Lower hand capability is not supported when the client is used in shared control mode. See SharedControlService
        Returns:
        Lower hand capability information.
        See Also:
        isHandRaised(), lowerHand(CallCompletionHandler)
      • getRetrieveParticipantListCapability

        Capability getRetrieveParticipantListCapability()
        Returns whether the conference call can be queried to get the list of conference participants.
        Returns:
        Retrieve participant list capability.
        See Also:
        getParticipants()
      • getPendingParticipants

        java.util.List<PendingParticipant> getPendingParticipants()
        Returns the pending participant list for the conference call. A pending participant is a person who is waiting to join a conference call that is locked. A moderator of the conference call may allow entry of a pending participant into the conference call. During the time that a participant is pending, the same participant could also appear in the active participants list as an ActiveParticipant whose "ConnectionStatus" property is set to "Authorizing". When a pending participant is allowed to enter the locked conference call, the corresponding entry is removed from the pending participant list. Subsequently, a corresponding ActiveParticipant will change it's state to "connected" in list of conference participants. Updates to the participant list (add, remove or update) are reported through the ConferenceListener.onConferencePendingParticipantsChanged(Conference, DataCollectionChangeType, List) listener callback registered with the conference object.
        Returns:
        list of pending participants associated with the conference call.
        See Also:
        getParticipants(), getDroppedParticipants()
      • getMuteAllParticipantsCapability

        Capability getMuteAllParticipantsCapability()
        Returns whether local user can mute all participants at once. The capability returns not supported if the conference call does not support this control, or if the local user does not have permission to mute all on the call. Conference moderation capabilities are not supported when the client is used in shared control mode. See SharedControlService
        Returns:
        Mute all participants capability.
        See Also:
        muteAllParticipants(CallCompletionHandler)
      • getUnmuteAllParticipantsCapability

        Capability getUnmuteAllParticipantsCapability()
        Returns whether the local user can unmute all participants at once. The capability returns not supported if the conference call does not support this control, or if the local user does not have permission to unmute all on the call. Conference moderation capabilities are not supported when the client is used in shared control mode. See SharedControlService
        Returns:
        Unmute all participants capability.
        See Also:
        unmuteAllParticipants(CallCompletionHandler)
      • muteAllParticipants

        void muteAllParticipants​(CallCompletionHandler handler)
        Used by a conference moderator to mute all participants on the conference call. Other moderators, lecturers and presenters are not affected by this operation.
        Parameters:
        handler - CallCompletionHandler object that wants to learn about the result of the operation, i.e., whether it was successful.
        See Also:
        getMuteAllParticipantsCapability()
      • getAddParticipantViaDialoutCapability

        Capability getAddParticipantViaDialoutCapability()
        Returns whether the local user can request the conference server to dial out towards a specified address, for example, to add a new user to the conference call. The capability returns not supported if the conference call does not support the participant dial-out feature, or if the local user does not have permission to initiate dial-out. Conference moderation capabilities are not supported when the client is used in shared control mode. See SharedControlService
        Returns:
        Add participant via dial-out capability.
        See Also:
        addParticipant(String, CallCompletionHandler)
      • addParticipant

        void addParticipant​(java.lang.String participantAddress,
                            CallCompletionHandler handler)
        Add a participant to a call. If the method is called on a 2-party call, the call is escalated to a conference call. This call change is reported via CallListener.onCallConferenceStatusChanged() callback. If the method is called on a conference call, the participant is added to the conference call using the dial-out mechanism initiated by the conference server. The method may be called multiple times to add multiple participants to the conference call. When the dial-out is successful, a new ActiveParticipant object is added to the conference roster list, and the application is notified through ConferenceListener interface registered with this Conference object.
        Parameters:
        participantAddress - Participant to be added to the conference call.
        handler - The CallCompletionHandler object that wants to learn about the result of the operation, i.e., whether it was successful.
        See Also:
        getAddParticipantViaDialoutCapability()
      • getAddParticipantFromCallCapability

        Capability getAddParticipantFromCallCapability​(Call callToAdd)
        Returns whether the local user can request the conference server to add a participant from a specified call to current call, for example, to add a new user to the conference call. The capability returns not supported if the conference call does not support the merge feature, or if the local user does not have permission to initiate it.
        Parameters:
        callToAdd - Call to be merged to the conference call.
        Returns:
        Add participant from call capability.
        See Also:
        addParticipantFromCall(Call, CallCompletionHandler)
      • addParticipantFromCall

        void addParticipantFromCall​(Call existingCall,
                                    CallCompletionHandler handler)
        If the method is called on a 2-party call, the two calls are merged together to create a conference call. This call status change is reported via CallListener.onCallConferenceStatusChanged() callback. If addParticipantFromCall() is called on a conference call, the input argument call is transferred over to the conference call represented by this object. If the user wants to create a conference call by merging multiple existing calls, addParticipantFromCall(call) can be called multiple times. For each successful addition, a new ActiveParticipant object is added to the conference roster list, and the application is notified through ConferenceListener interface registered with this Conference object.
        Parameters:
        existingCall - Call to be transferred over to the conference call.
        handler - The CallCompletionHandler object that wants to learn about the result of the operation, i.e., whether it was successful.
      • getAddTerminalIPAddressViaDialoutCapability

        Capability getAddTerminalIPAddressViaDialoutCapability()
        Returns whether the local user can request the conference server to dial out towards a terminal IP address to add a terminal as a new user to the conference call. The capability returns not supported if the conference call does not support the terminal dial-out feature, or if the local user does not have permission to initiate dial-out.
        Returns:
        Add terminal IP address via dial-out capability.
        See Also:
        addTerminal(String, CallCompletionHandler)
      • addTerminal

        void addTerminal​(java.lang.String terminalIPAddress,
                         CallCompletionHandler handler)
        Add a terminal to a conference call by terminal IP address. The terminal is added using bridge-assisted dial-out. The method may be called multiple times to add multiple terminals to the conference call. If the dial-out is successful, a new ActiveParticipant object is added to the conference roster list. The application is notified through ConferenceListener interface registered with this Conference object. In order to cancel dial-out terminal please use the method removeParticipant(ActiveParticipant, CallCompletionHandler)
        Parameters:
        terminalIPAddress - Terminal IP address to add the terminal to the conference call.
        handler - The CallCompletionHandler object for this operation. Operation success or failure is reported through this handler.
        See Also:
        getAddTerminalIPAddressViaDialoutCapability()
      • getRemoveSelectParticipantCapability

        Capability getRemoveSelectParticipantCapability()
        Returns whether the local user can specify a participant to be removed from the call. The capability returns not supported if the conference call does not support specification of a participant for removal, or if the local user does not have permission to select and drop a participant from the call.
        Returns:
        Remove specified participant capability.
        See Also:
        removeParticipant(ActiveParticipant, CallCompletionHandler)
      • removeParticipant

        void removeParticipant​(ActiveParticipant participant,
                               CallCompletionHandler handler)
        Initiates removal of the selected participant from the conference call. The method call is not successful if this is a two party call or if the server returns an error. For each successful removal, the corresponding ActiveParticipant object is removed from the conference roster list, and the application is notified through ConferenceListener interface registered with this Conference object.
        Parameters:
        participant - Participant to be removed from the call
        handler - The CallCompletionHandler object that wants to learn about the result of the operation, i.e., whether it was successful.
        See Also:
        getRemoveSelectParticipantCapability()
      • getRemoveLastParticipantCapability

        Capability getRemoveLastParticipantCapability()
        Returns whether the last participant can be removed without indicating the participant's ID. This is only supported in Avaya Communication Manager environment.
        Returns:
        Remove last participant capability.
        See Also:
        removeLastParticipant(CallCompletionHandler)
      • removeLastParticipant

        void removeLastParticipant​(CallCompletionHandler handler)
        Removes the last participant that was added to a conference call either locally or remotely. This method is only supported on conference systems that do not support conference roster list. Calling this method for a conference call that supports conference roster information results in error through the supplied handler object. This method can only be used for conference calls where getRemoveLastParticipantCapability() indicates that this operation is supported. If, as a result of removing the last party, the participant count goes down to 2, the Call object transition to a 2-party call. In this case, CallListener.onCallConferenceStatusChanged() is called to report the conference status change.
        Parameters:
        handler - The CallCompletionHandler object that wants to learn about the result of the operation, i.e., whether it was successful.
        See Also:
        getRemoveLastParticipantCapability()
      • getAcceptDenyPendingParticipantCapability

        Capability getAcceptDenyPendingParticipantCapability()
        Returns whether the local user can accept or deny a waiting participant's entry to the locked conference. The capability returns not supported if the conference call does not support the feature where a user can request entry to a conference call that is locked, or if the local user does not have permission to accept/deny a pending participant's entry request, or if there is no one waiting to be admitted to the call. Accept\Deny pending participant capability is not supported when the client is used in shared control mode. See SharedControlService
        Returns:
        Accept\Deny pending participant capability.
        See Also:
        PendingParticipant
      • getSignInCapability

        Capability getSignInCapability()
        Returns whether local user can sign in as named user in current conference session.
        Returns:
        capability information.
      • sendRequestToEnterLockedConference

        void sendRequestToEnterLockedConference​(CallCompletionHandler handler)
        Request for permission to enter a locked conference call. This is preceded by onConferencePermissionToEnterLockedConferenceRequired() call to the application. If the user decides to request permission to enter the locked conference call, this method should be called. If the user decides not to request permission from the moderator, end() should be called to end local user's connection to the conference call.
        Parameters:
        handler - The CallCompletionHandler object that wants to learn about the result of the operation, i.e., whether it was successful.
      • sendPasscode

        void sendPasscode​(java.lang.String passcode,
                          CallCompletionHandler handler)
        Request for admission to enter a conference call that is passcode-protected. This is preceded by onConferencePasscodeRequired() call to the application. If the user provides the passcode to enter the conference call, this method should be called to provide the passcode to the conference server. If the user does not want to provide the passcode, end() should be called to end the local endpoint's request to enter the conference call.
        Parameters:
        passcode - Admission passcode.
        handler - The CallCompletionHandler object that wants to learn about the result of the operation, i.e., whether it was successful.
        See Also:
        isPasscodeRequiredToEnterConference()
      • isEventConference

        boolean isEventConference()
        Indicates whether the call is an event conference or a regular conference. Event conference is a large meeting (up to 2000 active participants) which is mainly used for large events and training. See ConferenceListener.onEventConferenceStatusChanged(Conference, boolean) listener callback registered with the conference object.
        Returns:
        True if the conference has Event type, false for regular type.