Пример Click to Call для Android
Данный пример позволяет сделать аудиозвонок одним кликом кнопки, используя аккаунт заданный в конфиге сервера
/usr/local/FlashphonerWebCallServer/conf/apps/click-to-call/accounts.xml
На скриншоте ниже представлен пример после завершения звонка и закрытия соединения с сервером.
Поля ввода, необходимые для установления соединения и звонка
- 'WCS URL', где 192.168.2.104 - адрес WCS-сервера
- 'Callee', где 001 - SIP логин вызываемого пользователя
Работа с кодом примера
Для разбора кода возьмем класс ClickToCallActivity.java примера click-to-call, который доступен для скачивания в соответствующей сборке 1.0.1.38.
1. Инициализация API.
Flashphoner.init() код
Code Block | ||
---|---|---|
| ||
Flashphoner.init(this); |
При инициализации методу init() передается объект Сontext.
2. Создание сессии.
Flashphoner.createSession() код
Методу передается объект SessionOptions с URL WCS-сервера.
Code Block | ||
---|---|---|
| ||
SessionOptions sessionOptions = new SessionOptions(mWcsUrlView.getText().toString()); session = Flashphoner.createSession(sessionOptions); |
3. Подключение к серверу.
Session.connect(). код
Методу передается объект Connection с параметрами:
- appKey внутреннего серверного приложения 'clickToCallApp'.
Code Block | ||
---|---|---|
| ||
Connection connection = new Connection(); connection.setAppKey("clickToCallApp"); /** * Connect to WCS server */ session.connect(connection); |
4. Получение от сервера события, подтверждающего успешное соединение.
Session.onConnected(), Session.createCall() код
При получении данного события создается звонок методом Session.createCall(). Методу передается SIP-номер вызываемого абонента.
Code Block | ||
---|---|---|
| ||
@Override public void onConnected(final Connection connection) { runOnUiThread(new Runnable() { @Override public void run() { mCallButton.setText(R.string.action_hangup); mCallButton.setTag(R.string.action_hangup); mCallButton.setEnabled(true); mCallStatus.setText("Connection: " + connection.getStatus()); /** * Pass 'callee' to the callOptions and create a new call object */ CallOptions callOptions = new CallOptions(mCalleeView.getText().toString()); call = session.createCall(callOptions); call.on(new CallStatusEvent() { /** * WCS received 100 TRYING from SIP * @param call */ @Override public void onTrying(final Call call) { runOnUiThread(new Runnable() { @Override public void run() { mCallButton.setText(R.string.action_hangup); mCallButton.setTag(R.string.action_hangup); mCallButton.setEnabled(true); mCallStatus.setText("Call: " + call.getStatus()); } }); } /** * WCS received BUSY_HERE or BUSY_EVERYWHERE from SIP * @param call */ @Override public void onBusy(final Call call) { runOnUiThread(new Runnable() { @Override public void run() { mCallButton.setText(R.string.action_call); mCallButton.setTag(R.string.action_call); mCallButton.setEnabled(true); mCallStatus.setText("Call: " + call.getStatus()); } }); } /** * Call failed on server * @param call */ @Override public void onFailed(final Call call) { runOnUiThread(new Runnable() { @Override public void run() { mCallStatus.setText("Call: " + call.getStatus()); } }); } /** * WCS received 180 RINGING from SIP * @param call */ @Override public void onRing(final Call call) { runOnUiThread(new Runnable() { @Override public void run() { mCallStatus.setText("Call: " + call.getStatus()); } }); } /** * Call is set on hold by the remote participant * @param call */ @Override public void onHold(final Call call) { runOnUiThread(new Runnable() { @Override public void run() { mCallStatus.setText("Call: " + call.getStatus()); } }); } /** * Call is established. WCS received 200 OK from SIP on INVITE. * @param call */ @Override public void onEstablished(final Call call) { runOnUiThread(new Runnable() { @Override public void run() { mCallStatus.setText("Call: " + call.getStatus()); } }); } /** * Call is terminated either by caller or by a SIP remote participant. * @param call */ @Override public void onFinished(final Call call) { runOnUiThread(new Runnable() { @Override public void run() { mCallButton.setText(R.string.action_call); mCallButton.setTag(R.string.action_call); mCallButton.setEnabled(true); mCallStatus.setText("Call: " + call.getStatus()); } }); } }); ActivityCompat.requestPermissions(ClickToCallActivity.this, new String[]{Manifest.permission.RECORD_AUDIO}, CALL_REQUEST_CODE); SharedPreferences sharedPref = ClickToCallActivity.this.getPreferences(Context.MODE_PRIVATE); SharedPreferences.Editor editor = sharedPref.edit(); editor.putString("callee", mCalleeView.getText().toString()); editor.apply(); } }); } |
5. Совершение исходящего звонка.
Call.call() код
Code Block | ||
---|---|---|
| ||
case CALL_REQUEST_CODE: { if (grantResults.length == 0 || grantResults[0] != PackageManager.PERMISSION_GRANTED) { mCallButton.setEnabled(false); session.disconnect(); Log.i(TAG, "Permission has been denied by user"); } else { /** * Make the outgoing call */ call.call(); Log.i(TAG, "Permission has been granted by user"); } } |
6. Закрытие соединения.
Session.disconnect() код
Code Block | ||
---|---|---|
| ||
mCallButton.setEnabled(false); session.disconnect(); |
7. Получение события, подтверждающего разъединение.
session.onDisconnection() код
Code Block | ||
---|---|---|
| ||
@Override public void onDisconnection(final Connection connection) { runOnUiThread(new Runnable() { @Override public void run() { mCallButton.setText(R.string.action_call); mCallButton.setTag(R.string.action_call); mCallButton.setEnabled(true); mCallStatus.setText("Connection: " + connection.getStatus()); } }); } |