Suggestions

close search

StringeeCall2

public class StringeeCall2
extends Object



Represents a voice, video call.
Used to capture an audio-video stream from the device's microphone and camera for use to make or answer a call. Create a StringeeCall2 instance by calling the StringeeCall2 constructor.



Summary


Nested classes
public static class StringeeCallStats

Used to get the call's statistics.

public static enum SignalingState

Defines values for the state of the call.

public static enum MediaState

Defines values for the call media state.

public interface StringeeCallListener

Monitors the call's media streams: local stream, remote stream.

public interface CallStatsListener

Monitors the call states and medias.

Public Constructors
StringeeCall2(StringeeClient client, String from, String to)

Creates a new StringeeCall2 instance to make a call.

Public methods
void answer()

Answers a call and starts the conversation.

void enableVideo(boolean enable)

Enables or disables the local video stream.

String getCallId()

Returns the id of the call.

String getCustomDataFromYourServer()

Returns the custom data from your server.

String getFrom()

Returns the caller's id or phone number.

org.webrtc.SurfaceViewRenderer getLocalView()

Returns the view which Stringee SDK renders local video to.

org.webrtc.SurfaceViewRenderer getRemoteView()

Returns the view which Stringee SDK renders remote video to.

void getStats(CallStatsListener statsListener)

Get the call's statistics.

String getTo()

Returns the callee's id or phone number.

void hangup()

Terminates a call.

boolean isVideoCall()

Check whether the call is a video call.

void makeCall()

Makes a call.

void mute(boolean mute)

Toggle audio on or off.

void reject()

Reject a call.

void renderLocalView(boolean isMediaOverlay)

Displays the caller's video.

void renderRemoteView(boolean isMediaOverlay)

Displays the callee's video.

void ringing(StatusListener listener)

Send a ringing signal

void setCustom(String custom)

Set a customizable text of the call. This text will be sent to Stringee server. Then Stringee server sends it to Your Server via the project's answer_url.

void setCallListener(StringeeCallListener callListener)

Set a StringeeCall.StringeeCallListener object to monitor the call states and medias.

void setVideoCall(boolean videoCall)

By defalt, a Stringee call is a voice call.

void switchCamera(StatusListener listener)

Switches the device's camera.


Public constructors


StringeeCall

StringeeCall(StringeeClient client, String from, String to)

Creates a new StringeeCall2 instance to make a call.

Parameters
client

The client who wants to make or answer a call.

from

The caller's alias to be displayed to the callee (app-to-app call) or the number you've bought (app-to-phone call).

to

The user id of the callee.




Public methods


answer

void answer()

Answers a call and starts the conversation.



enableVideo

void enableVideo(boolean enable)

Enable or disable local video stream.

Parameters
enable

True to enable or false to disable video stream.



getCallId

String getCallId()

Returns the id of the call. The id is generated on Stringee server and passed to the caller via the StringeeCall2.StringeeCallStateListener.onStateChange interface or to callee via the StringeeConnectionListener.onIncomingCall2 interface.



getCustomDataFromYourServer

String getCustomDataFromYourServer()

Returns the custom data from your server when a client makes a call or receives an incoming call.



getFrom

String getFrom()

Returns the caller's id or phone number.



getLocalView

org.webrtc.SurfaceViewRenderer getLocalView()

Returns the view which Stringee SDK renders local video to. You can add this view as a child of ViewGroup objects in your app.



getRemoteView

org.webrtc.SurfaceViewRenderer getRemoteView()

Returns the view which Stringee SDK renders remote video to. You can add this view as a child of ViewGroup objects in your app.



getStats

void getStats(CallStatsListener statsListener)

Get the call's statistics such as: bytesReceived, packetsReceived, packetsLost. The call statistics are returned in a StringeeCallStats object via statsListener.onCallStats(StringeeCallStats statsReport).

Parameters
statsListener

A CallStatsListener instance.



getTo

String getTo()

Returns the callee's id or phone number.



hangup

void hangup()

Terminates a call. This method must be called when you hangs up to release resources. Otherwise, the memory is leaked.



isVideoCall

boolean isVideoCall()

Check whether the call is a video call.



makeCall

void makeCall()

Makes a call.



mute

void mute(boolean mute)

Toggle audio on or off

Parameters
mute

True to toggle audio off or false to toggle audio on.



reject

void reject()

Reject a call.



renderLocalView

void renderLocalView(boolean isMediaOverlay)

Displays the caller's video.

Parameters
isMediaOverlay

Control whether the video is placed on top of another regular surface view in the window.



renderRemoteView

void renderRemoteView(boolean isMediaOverlay)

Displays the callee's video.

Parameters
isMediaOverlay

Control whether the video is placed on top of another regular surface view in the window.



ringing

void ringing(Statuslistener listener)

Send a ringing signal

Parameters
listener

A StatusListener instance.



setCustom

void setCustom(String custom)

Set a customizable text of the call. This text will be sent to Stringee server. Then Stringee server sends it to Your Server via the project's answer_url.

Parameters
custom

The customizable text.



setCallListener

void setCallListener(StringeeCallListener callListener)

Set a StringeeCall2.StringeeCallListener object to monitor the call states and medias.

Parameters
callListener

A StringeeCallListener instance.



setVideoCall

void setVideoCall(boolean videoCall)

By defalt, a Stringee call is a voice call. If you want to make a video call, call the setVideoCall(true) after instantiating a StringeeCall2 instance.

Parameters
videoCall

True for video call, false for audio call.



switchCamera

void switchCamera(StatusListener listener)

Switches the device's camera. By defalt, Stringee SDK uses the front camera.

Parameters
listener

The StatusListener instance.