Interface CallController

  • All Implemented Interfaces:

    
    public interface CallController
    
                        

    CallController provides the entry point to the calling functionality of the Sinch SDK.

    • Constructor Detail

    • Method Detail

      • callUser

         abstract Call callUser(String userId, MediaConstraints mediaConstraints)

        Makes a call to the user with the given id.

        Parameters:
        userId - The app specific id of the user to call.
        mediaConstraints - Media constraints for given user call.
        Returns:

        A Call instance.

      • callUser

         abstract Call callUser(String userId, MediaConstraints mediaConstraints, Map<String, String> callHeaders)

        Makes a call to the user with the given id.

        Parameters:
        userId - The app specific id of the user to call.
        mediaConstraints - Media constraints for given user call.
        callHeaders - Headers to pass with the call.
        Returns:

        A Call instance.

      • callPhoneNumber

         abstract Call callPhoneNumber(String phoneNumber, String cli)

        Calls a phone number and terminates the call to the PSTN-network (Publicly Switched Telephone Network).

        Parameters:
        phoneNumber - The phone number to call.
        cli - Identifier of the caller.
        Returns:

        A Call instance.

      • callPhoneNumber

         abstract Call callPhoneNumber(String phoneNumber, String cli, Map<String, String> callHeaders)

        Calls a phone number and terminates the call to the PSTN-network (Publicly Switched Telephone Network).

        Parameters:
        phoneNumber - The phone number to call.
        cli - Identifier of the caller.
        callHeaders - Headers to pass with the call.
        Returns:

        A Call instance.

      • callSip

         abstract Call callSip(String sipUri)

        Makes a SIP call to the user with the given sip uri. The identity should be in the form "user@server".

        Parameters:
        sipUri - SIP URI to dial in to.
        Returns:

        A Call instance.

      • callSip

         abstract Call callSip(String sipUri, Map<String, String> callHeaders)

        Makes a SIP call to the user with the given sip uri. The identity should be in the form "user@server".

        Parameters:
        sipUri - SIP URI to dial in to.
        callHeaders - Headers to pass with the call.
        Returns:

        A Call instance.

      • callSip

         abstract Call callSip(String sipUri, String cli)

        Makes a SIP call to the user with the given sip uri. The identity should be in the form "user@server".

        Parameters:
        sipUri - SIP URI to dial in to.
        cli - Identifier of the caller.
        Returns:

        A Call instance.

      • callSip

         abstract Call callSip(String sipUri, String cli, Map<String, String> callHeaders)

        Makes a SIP call to the user with the given sip uri. The identity should be in the form "user@server".

        Parameters:
        sipUri - SIP URI to dial in to.
        cli - Identifier of the caller.
        callHeaders - Headers to pass with the call.
        Returns:

        A Call instance.

      • callConference

         abstract Call callConference(String conferenceId)

        Calls the conference with the given id.

        Parameters:
        conferenceId - Conference ID to dial in to.
        Returns:

        A Call instance.

      • callConference

         abstract Call callConference(String conferenceId, String cli)

        Calls the conference with the given id.

        Parameters:
        conferenceId - Conference ID to dial in to.
        cli - Identifier of the caller.
        Returns:

        A Call instance.

      • callConference

         abstract Call callConference(String conferenceId, Map<String, String> callHeaders)

        Calls the conference with the given id.

        Parameters:
        conferenceId - Conference ID to dial in to.
        callHeaders - Headers to pass with the call.
        Returns:

        A Call instance.

      • callConference

         abstract Call callConference(String conferenceId, String cli, Map<String, String> callHeaders)

        Calls the conference with the given id.

        Parameters:
        conferenceId - Conference ID to dial in to.
        cli - Identifier of the caller.
        callHeaders - Headers to pass with the call.
        Returns:

        A Call instance.

      • setRespectNativeCalls

        @Deprecated(message = "Use setRespectNativeCalls(onIncomingSinchCall: Boolean, duringSinchCall: Boolean) instead", replaceWith = @ReplaceWith(expression = "setRespectNativeCalls(onIncomingSinchCall: Boolean, duringSinchCall: Boolean)")) abstract Unit setRespectNativeCalls(Boolean respectNativeCalls)

        Set whether or not the client should respect native calls. If this is set to true, answering native calls will hangup any ongoing Sinch calls. Also, if in a native calls, incoming Sinch calls will be denied automatically. If set to true, the app requires permissions android.permission.READ_PHONE_STATE.

      • setRespectNativeCalls

         abstract Unit setRespectNativeCalls(Boolean onIncomingSinchCall, Boolean duringSinchCall)

        Set whether or not the client should respect native (GSM) calls.

        Parameters:
        onIncomingSinchCall - Whether or not the client should respect native calls on incoming Sinch call.
        duringSinchCall - Whether or not the client should respect native (GSM) calls during ongoing Sinch call.
      • setRespectVoIPCalls

         abstract Unit setRespectVoIPCalls(Boolean onIncomingSinchCall, Boolean duringSinchCall)

        Set whether or not the client should respect other VoIP calls (eg. WhatsAPP, Messenger).

        Parameters:
        onIncomingSinchCall - Whether or not the client should respect other VoIP calls on incoming Sinch call.
        duringSinchCall - Whether or not the client should respect other VoIP calls during ongoing Sinch call.
      • getCall

         abstract Call getCall(String callId)

        Returns the Call object with the given callId.

        Parameters:
        callId - The call identifier string.
        Returns:

        A Call instance if one matches, otherwise null.

      • setWebRtcCallConfiguration

         abstract Unit setWebRtcCallConfiguration(WebRtcCallConfiguration webRtcCallConfiguration)

        Sets the WebRTC configuration for every call created by this CallController. For this method to have effect, it must be called before initiating any outgoing call or relying the push payload.

        Parameters:
        webRtcCallConfiguration - configuration to be used.