com.bandwidth.sdk.model

Class Call

java.lang.Object

com.bandwidth.sdk.model.ModelBase

com.bandwidth.sdk.model.ResourceBase

com.bandwidth.sdk.model.Call

public class Call
extends ResourceBase

Information about call.

Author:

vpotapenko

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
class	Call.CallAudioBuilder
class	Call.CallGatherBuilder
class	Call.CallTransferBuilder

Field Summary

Fields inherited from class com.bandwidth.sdk.model.ResourceBase

client, id, properties

Fields inherited from class com.bandwidth.sdk.model.ModelBase

dateFormat

Constructor Summary

Constructors

Constructor and Description
Call(BandwidthClient client, org.json.simple.JSONObject jsonObject)

Method Summary

Methods

Modifier and Type	Method and Description
void	answerOnIncoming() Answer an incoming phone call.
Call.CallGatherBuilder	callGatherBuilder() Creates a new builder for collecting a series of DTMF digits from a phone call with an optional prompt.
Call.CallTransferBuilder	callTransferBuilder(String transferTo) Creates builder for transferring call.
static Call	create(BandwidthClient client, Map<String,Object> params) Dials a call, from a phone number to a phone number.
static Call	create(Map<String,Object> params) Dials a call, from a phone number to a phone number.
static Call	create(String to, String from) Convenience factory method to make an outbound call
static Call	create(String to, String from, String callbackUrl, String tag) Convenience method to dials a call from a phone number to a phone number
void	createGather(Map<String,Object> gatherParams, Map<String,Object> promptParams)
void	createGather(String promptSentence)
static Call	get(BandwidthClient client, String callId) Convenience factory method for Call, returns a Call object given an id
static Call	get(String callId) Factory method for Call, returns information about an active or completed call.
Date	getActiveTime()
String	getCallbackUrl()
Long	getChargeableDuration()
String	getDirection()
Date	getEndTime()
EventBase	getEvent(String eventId) Gets information about one call event.
String	getEvents()
List<EventBase>	getEventsList() Gets the events that occurred during the call.
String	getFrom()
Gather	getGather(String gatherId) Gets the gather DTMF parameters and results.
List<Recording>	getRecordings() Retrieve all recordings related to the call.
Date	getStartTime()
String	getState()
String	getTo()
protected String	getUri()
void	hangUp() Hang up a phone call.
boolean	isRecordingEnabled()
static ResourceList<Call>	list() Factory method for Call list, returns a list of Call objects with default page, size
static ResourceList<Call>	list(BandwidthClient client, int page, int size) Factor method for Call list, returns a list of Call objects with page, size preference
static ResourceList<Call>	list(int page, int size) Factor method for Call list, returns a list of Call objects with page, size preference
Call.CallAudioBuilder	newAudioBuilder() Creates new builder for playing an audio file or speaking a sentence in a call.
void	playAudio(Map<String,Object> params)
void	playRecording(String recordingUrl)
void	recordingOff() Turn call recording OFF.
void	recordingOn() Turn call recording ON.
void	rejectIncoming() Reject an incoming phone call
void	sendDtmf(String dtmf) Sends DTMF.
protected void	setUp(org.json.simple.JSONObject jsonObject)
void	speakSentence(Map params)
void	speakSentence(String sentence)
void	speakSentence(String sentence, String tag)
void	stopAudioFilePlaying() Stop an audio file playing.
void	stopSentence() Stop an audio sentence.
String	toString()

Methods inherited from class com.bandwidth.sdk.model.ResourceBase

getClient, getId, getProperties, setId, toJSONArray, toJSONObject

Methods inherited from class com.bandwidth.sdk.model.ModelBase

getProperty, getPropertyAsBoolean, getPropertyAsDate, getPropertyAsDouble, getPropertyAsLong, getPropertyAsString, getPropertyAsStringArray, putProperty, toMap, updateProperties

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

Call

public Call(BandwidthClient client,
    org.json.simple.JSONObject jsonObject)

Method Detail

get

public static Call get(String callId)
                throws Exception

Factory method for Call, returns information about an active or completed call.

Parameters:

callId - call id

Returns:

information about a call

Throws:

IOException

Exception

get

public static Call get(BandwidthClient client,
       String callId)
                throws Exception

Convenience factory method for Call, returns a Call object given an id

Parameters:

client -

callId -

Throws:

Exception

list

public static ResourceList<Call> list()
                               throws IOException

Factory method for Call list, returns a list of Call objects with default page, size

Returns:

Throws:

IOException

list

public static ResourceList<Call> list(int page,
                      int size)
                               throws IOException

Factor method for Call list, returns a list of Call objects with page, size preference

Parameters:

page -

size -

Returns:

Throws:

IOException

list

public static ResourceList<Call> list(BandwidthClient client,
                      int page,
                      int size)
                               throws IOException

Factor method for Call list, returns a list of Call objects with page, size preference

Parameters:

page -

size -

Returns:

Throws:

IOException

create

public static Call create(String to,
          String from)
                   throws Exception

Convenience factory method to make an outbound call

Parameters:

to -

from -

Returns:

Throws:

Exception

create

public static Call create(String to,
          String from,
          String callbackUrl,
          String tag)
                   throws Exception

Convenience method to dials a call from a phone number to a phone number

Parameters:

to -

from -

callbackUrl -

maps -

Returns:

Throws:

IOException

Exception

create

public static Call create(Map<String,Object> params)
                   throws Exception

Dials a call, from a phone number to a phone number.

Parameters:

params -

Returns:

Throws:

IOException

Exception

create

public static Call create(BandwidthClient client,
          Map<String,Object> params)
                   throws Exception

Dials a call, from a phone number to a phone number.

Parameters:

params -

Returns:

Throws:

IOException

Exception

setUp

protected void setUp(org.json.simple.JSONObject jsonObject)

Specified by:

setUp in class ResourceBase

getUri

protected String getUri()

speakSentence

public void speakSentence(Map params)
                   throws IOException

Throws:

IOException

speakSentence

public void speakSentence(String sentence)
                   throws IOException

Throws:

IOException

speakSentence

public void speakSentence(String sentence,
                 String tag)
                   throws IOException

Throws:

IOException

playRecording

public void playRecording(String recordingUrl)
                   throws IOException

Throws:

IOException

playAudio

public void playAudio(Map<String,Object> params)
               throws IOException

Throws:

IOException

createGather

public void createGather(String promptSentence)
                  throws IOException

Throws:

IOException

createGather

public void createGather(Map<String,Object> gatherParams,
                Map<String,Object> promptParams)
                  throws IOException

Throws:

IOException

getDirection

public String getDirection()

getState

public String getState()

getFrom

public String getFrom()

getTo

public String getTo()

getCallbackUrl

public String getCallbackUrl()

getEvents

public String getEvents()

getStartTime

public Date getStartTime()

getActiveTime

public Date getActiveTime()

getEndTime

public Date getEndTime()

getChargeableDuration

public Long getChargeableDuration()

isRecordingEnabled

public boolean isRecordingEnabled()

getRecordings

public List<Recording> getRecordings()
                              throws Exception

Retrieve all recordings related to the call.

Returns:

recordings

Throws:

IOException

Exception

getEventsList

public List<EventBase> getEventsList()
                              throws Exception

Gets the events that occurred during the call.

Returns:

events

Throws:

IOException

Exception

getEvent

public EventBase getEvent(String eventId)
                   throws Exception

Gets information about one call event.

Parameters:

eventId - event id

Returns:

information about event

Throws:

IOException

Exception

hangUp

public void hangUp()
            throws Exception

Hang up a phone call.

Throws:

IOException

Exception

answerOnIncoming

public void answerOnIncoming()
                      throws Exception

Answer an incoming phone call.

Throws:

IOException

Exception

rejectIncoming

public void rejectIncoming()
                    throws Exception

Reject an incoming phone call

Throws:

IOException

Exception

recordingOn

public void recordingOn()
                 throws Exception

Turn call recording ON.

Throws:

IOException

Exception

recordingOff

public void recordingOff()
                  throws Exception

Turn call recording OFF.

Throws:

IOException

Exception

callTransferBuilder

public Call.CallTransferBuilder callTransferBuilder(String transferTo)

Creates builder for transferring call.
Example:
call.callTransferBuilder("{number}").sentence("hello").create();

Parameters:

transferTo - number for transferring

Returns:

new builder

newAudioBuilder

public Call.CallAudioBuilder newAudioBuilder()

Creates new builder for playing an audio file or speaking a sentence in a call.
Example:
call.newAudioBuilder().sentence("Hello").create();

Returns:

new builder

stopAudioFilePlaying

public void stopAudioFilePlaying()
                          throws IOException

Stop an audio file playing.

Throws:

IOException

stopSentence

public void stopSentence()
                  throws IOException

Stop an audio sentence.

Throws:

IOException

sendDtmf

public void sendDtmf(String dtmf)
              throws IOException

Sends DTMF.

Parameters:

dtmf - DTMF value

Throws:

IOException

callGatherBuilder

public Call.CallGatherBuilder callGatherBuilder()

Creates a new builder for collecting a series of DTMF digits from a phone call with an optional prompt. This request returns immediately. When gather finishes, an event with the results will be posted to the callback URL.
Example:
call.callGatherBuilder().maxDigits(5).promptFileUrl("url_to_file").create();

Returns:

new builder

getGather

public Gather getGather(String gatherId)
                 throws Exception

Gets the gather DTMF parameters and results.

Parameters:

gatherId - gather id

Returns:

gather DTMF parameters and results

Throws:

IOException

Exception

toString

public String toString()

Overrides:

toString in class Object