Приложение "Телефон" по умолчанию позволяет фреймворку Android Telecom сообщать вашему приложению о статусе вызова. Для этого используются менеджер ролей и сервис InCallService, который заменяет приложение "Телефон" по умолчанию на устройстве Android. Реализуйте InCallService API. Реализация должна соответствовать следующим требованиям:
В нем не должно быть функций звонков, а только пользовательский интерфейс для них. Он должен обрабатывать все вызовы, о которых знает фреймворк Telecom, и не делать предположений о характере вызовов. Например, не следует предполагать, что вызовы осуществляются через SIM-карту, или применять ограничения, основанные на одном ConnectionService, например ограничения для видеовызовов.
Приложение для звонков позволяет пользователям принимать и совершать аудио- и видеовызовы на устройстве. Приложения для звонков используют собственный пользовательский интерфейс, а не интерфейс приложения "Телефон" по умолчанию, как показано на скриншоте ниже.

Пример приложения для звонков, использующего собственный пользовательский интерфейс
Фреймворк Android включает пакет android.telecom, который содержит классы, помогающие создать приложение для звонков в соответствии с фреймворком Telecom. Разработка приложения в соответствии с фреймворком Telecom дает следующие преимущества:
- Приложение корректно взаимодействует с нативной телекоммуникационной подсистемой устройства.
- Приложение правильно взаимодействует с другими приложениями для звонков, которые также соответствуют фреймворку.
- Фреймворк помогает приложению управлять маршрутизацией аудио и видео.
- Фреймворк помогает приложению определить, имеют ли его вызовы фокус.
Декларации и разрешения в манифесте
В манифесте приложения укажите, что оно использует разрешение MANAGE_OWN_CALLS, как показано в примере ниже.
<manifest … >
<uses-permission android:name="android.permission.MANAGE_OWN_CALLS"/>
</manifest>
Подробнее о декларировании разрешений для приложения см. Разрешения.
Вам нужно объявить службу, которая указывает класс, реализующий класс ConnectionService в вашем приложении. Чтобы телекоммуникационная подсистема могла связаться со службой, в ней должно быть объявлено разрешение BIND_TELECOM_CONNECTION_SERVICE. В примере ниже показано, как объявить сервис в манифесте приложения.
<service android:name="com.example.MyConnectionService"
android:permission="android.permission.BIND_TELECOM_CONNECTION_SERVICE">
<intent-filter>
<action android:name="android.telecom.ConnectionService" />
</intent-filter>
</service>
Подробнее о компонентах приложения…
Реализуйте сервис подключения
В приложении для звонков должна быть реализация класса ConnectionService, к которому может привязываться подсистема телекоммуникаций.
В реализации ConnectionService необходимо переопределить следующие методы:
onCreateOutgoingConnection(PhoneAccountHandle, ConnectionRequest)Телекоммуникационная подсистема вызывает этот метод в ответ на вызов
placeCall(Uri, Bundle)вашим приложением для создания нового исходящего вызова. Приложение возвращает новый экземпляр реализации классаConnection(подробнее о том, как реализовать подключение), который представляет новый исходящий вызов. Вы можете настроить исходящее подключение, выполнив следующие действия:- Приложение должно вызвать метод
setConnectionProperties(int)с константойPROPERTY_SELF_MANAGEDв качестве аргумента, чтобы указать, что подключение было инициировано приложением для звонков. - Если ваше приложение поддерживает удержание вызовов, вызовите метод
setConnectionCapabilities(int)и задайте в качестве аргумента значение битовой маски константCAPABILITY_HOLDиCAPABILITY_SUPPORT_HOLD. - Чтобы задать имя вызывающего абонента, используйте метод
setCallerDisplayName(String, int), передав константуPRESENTATION_ALLOWEDв качестве параметраint. Это укажет, что имя вызывающего абонента должно быть показано. - Чтобы убедиться, что исходящий вызов имеет соответствующее состояние видео, вызовите метод
setVideoState(int)объектаConnectionи отправьте значение, возвращенное методомgetVideoState()объектаConnectionRequest.
- Приложение должно вызвать метод
onCreateOutgoingConnectionFailed(PhoneAccountHandle, ConnectionRequest)Телекоммуникационная подсистема вызывает этот метод, когда ваше приложение вызывает метод
placeCall(Uri, Bundle)и исходящий вызов не может быть выполнен. В этом случае приложение должно сообщить пользователю (например, с помощью всплывающего окна или уведомления), что исходящий вызов не может быть выполнен. Приложение не сможет совершить вызов, если в данный момент выполняется экстренный вызов или вызов в другом приложении, который нельзя поставить на удержание.onCreateIncomingConnection(PhoneAccountHandle, ConnectionRequest)Телекоммуникационная подсистема вызывает этот метод, когда ваше приложение вызывает метод
addNewIncomingCall(PhoneAccountHandle, Bundle), чтобы сообщить системе о новом входящем вызове в вашем приложении. Ваше приложение возвращает новый экземпляр вашей реализацииConnection(дополнительную информацию см. в разделе Реализация подключения), представляющий новый входящий вызов. Вы можете настроить входящее подключение, выполнив следующие действия:- Приложение должно вызвать метод
setConnectionProperties(int)с константойPROPERTY_SELF_MANAGEDв качестве аргумента, чтобы указать, что подключение было инициировано приложением для звонков. - Если ваше приложение поддерживает удержание вызовов, вызовите метод
setConnectionCapabilities(int)и задайте в качестве аргумента значение битовой маски константCAPABILITY_HOLDиCAPABILITY_SUPPORT_HOLD. - Чтобы задать имя вызывающего абонента, используйте метод
setCallerDisplayName(String, int), передав константуPRESENTATION_ALLOWEDв качестве параметраint. Это укажет, что имя вызывающего абонента должно быть показано. - Чтобы указать номер телефона или адрес входящего вызова, используйте метод
setAddress(Uri, int)объектаConnection. - Чтобы убедиться, что исходящий вызов имеет соответствующее состояние видео, вызовите метод
setVideoState(int)объектаConnectionи отправьте значение, возвращенное методомgetVideoState()объектаConnectionRequest.
- Приложение должно вызвать метод
onCreateIncomingConnectionFailed(PhoneAccountHandle, ConnectionRequest)Телекоммуникационная подсистема вызывает этот метод, когда ваше приложение вызывает метод
addNewIncomingCall(PhoneAccountHandle, Bundle), чтобы сообщить о новом входящем вызове, но входящий вызов не разрешен (подробнее см. в разделе Ограничения на вызовы). Приложение должно отклонить входящий вызов без звука и, если нужно, показать уведомление о пропущенном вызове.
Как установить связь
Чтобы представить звонки в приложении, создайте подкласс Connection. В реализации переопределите следующие методы:
onShowIncomingCallUi()Телекоммуникационная подсистема вызывает этот метод, когда вы добавляете новый входящий вызов и ваше приложение должно показать интерфейс входящего вызова.
onCallAudioStateChanged(CallAudioState)Телекоммуникационная подсистема вызывает этот метод, чтобы сообщить приложению, что текущий аудиомаршрут или режим изменился. Вызывается в ответ на изменение аудиорежима в приложении с помощью метода
setAudioRoute(int). Этот метод также может вызываться, если система меняет маршрут аудио (например, при отключении Bluetooth-гарнитуры).onHold()Телекоммуникационная подсистема вызывает этот метод, когда хочет поставить вызов на удержание. В ответ на этот запрос приложение должно удержать вызов, а затем вызвать метод
setOnHold(), чтобы сообщить системе, что вызов удерживается. Подсистема Telecom может вызвать этот метод, когда сервис, используемый во время звонка, например Android Auto, хочет передать запрос пользователя на удержание вызова. Телекоммуникационная подсистема также вызывает этот метод, если пользователь совершает звонок в другом приложении. ПодробнееInCallService…onUnhold()Подсистема телекоммуникаций вызывает этот метод, когда хочет возобновить вызов, который был поставлен на удержание. После возобновления вызова приложение должно вызвать метод
setActive(), чтобы сообщить системе, что вызов больше не находится на удержании. Подсистема телекоммуникаций может вызвать этот метод, когда сервис, показывающий ваш звонок, например Android Auto, хочет передать запрос на возобновление звонка. Подробнее о сервисах, доступных во время звонка, рассказывается в статьеInCallService.onAnswer()Телекоммуникационная подсистема вызывает этот метод, чтобы сообщить вашему приложению, что на входящий вызов нужно ответить. После того как приложение ответит на вызов, оно должно вызвать метод
setActive(), чтобы сообщить системе, что на вызов был дан ответ. Телекоммуникационная подсистема может вызвать этот метод, когда ваше приложение добавляет новый входящий вызов, а в другом приложении уже есть текущий вызов, который нельзя поставить на удержание. В таких случаях телекоммуникационная подсистема показывает интерфейс входящего вызова от имени вашего приложения. Фреймворк предоставляет перегруженный метод, который позволяет указать состояние видео, в котором нужно ответить на вызов. Дополнительную информацию можно найти в статьеonAnswer(int).onReject()Подсистема телекоммуникаций вызывает этот метод, когда хочет отклонить входящий вызов. После отклонения вызова приложение должно вызвать
setDisconnected(DisconnectCause)и указатьREJECTEDв качестве параметра. Затем приложение должно вызвать методdestroy(), чтобы сообщить системе, что вызов обработан. Телекоммуникационная подсистема вызывает этот метод, когда пользователь отклоняет входящий вызов из вашего приложения.onDisconnect()Телекоммуникационная подсистема вызывает этот метод, когда хочет завершить вызов. После завершения вызова приложение должно вызвать метод
setDisconnected(DisconnectCause)и указатьLOCALв качестве параметра, чтобы показать, что вызов был прерван по запросу пользователя. Затем приложение должно вызвать методdestroy(), чтобы сообщить телекоммуникационной подсистеме, что вызов обработан. Система может вызвать этот метод, когда пользователь завершил вызов через другой сервис, например Android Auto. Система также вызывает этот метод, когда ваш вызов должен быть отключен, чтобы можно было совершить другой вызов, например, если пользователь хочет совершить экстренный вызов. Дополнительную информацию о сервисах во время звонка можно найти в статьеInCallService.
Как обрабатывать распространенные сценарии звонков
Чтобы использовать API ConnectionService в последовательности вызовов, необходимо взаимодействовать с другими классами в пакете android.telecom. В следующих разделах описаны распространенные сценарии вызовов и то, как ваше приложение должно использовать API для их обработки.
Как отвечать на звонки
Процесс обработки входящих вызовов зависит от того, есть ли вызовы в других приложениях. Разница в процессах обусловлена тем, что фреймворк Telecom должен устанавливать определенные ограничения, когда в других приложениях есть активные вызовы. Это необходимо, чтобы обеспечить стабильную работу всех приложений для звонков на устройстве. Подробнее об ограничениях на вызовы…
Нет активных звонков в других приложениях.
Чтобы отвечать на входящие вызовы, когда в других приложениях нет активных вызовов, выполните следующие действия:
- Приложение получает новый входящий вызов, используя обычные механизмы.
- Используйте метод
addNewIncomingCall(PhoneAccountHandle, Bundle), чтобы сообщить телекоммуникационной подсистеме о новом входящем вызове. - Телекоммуникационная подсистема связывается с реализацией
ConnectionServiceвашего приложения и запрашивает новый экземпляр классаConnection, представляющий новый входящий вызов, с помощью методаonCreateIncomingConnection(PhoneAccountHandle, ConnectionRequest). - Телекоммуникационная подсистема сообщает приложению, что оно должно показать пользовательский интерфейс входящего вызова, используя метод
onShowIncomingCallUi(). - Приложение показывает интерфейс входящего вызова, используя уведомление со связанным полноэкранным интентом. Дополнительную информацию можно найти по адресу
onShowIncomingCallUi(). - Вызовите метод
setActive(), если пользователь принимает входящий вызов, илиsetDisconnected(DisconnectCause), указавREJECTEDв качестве параметра, а затем вызовите методdestroy(), если пользователь отклоняет входящий вызов.
Активные вызовы в других приложениях, которые нельзя поставить на удержание.
Чтобы ответить на входящий вызов, когда в других приложениях есть активные вызовы, которые нельзя поставить на удержание, выполните следующие действия:
- Приложение получает новый входящий вызов, используя обычные механизмы.
- Используйте метод
addNewIncomingCall(PhoneAccountHandle, Bundle), чтобы сообщить телекоммуникационной подсистеме о новом входящем вызове. - Телекоммуникационная подсистема связывается с реализацией
ConnectionServiceв вашем приложении и запрашивает новый экземпляр объектаConnection, представляющий новый входящий вызов, с помощью методаonCreateIncomingConnection(PhoneAccountHandle, ConnectionRequest). - Телекоммуникационная подсистема показывает интерфейс входящего вызова.
- Если пользователь принимает вызов, телекоммуникационная подсистема вызывает метод
onAnswer(). Вызовите методsetActive(), чтобы сообщить телекоммуникационной подсистеме, что вызов подключен. - Если пользователь отклоняет вызов, телекоммуникационная подсистема вызывает метод
onReject(). Вызовите методsetDisconnected(DisconnectCause), указав в качестве параметраREJECTED, а затем вызовите методdestroy().
Совершать исходящие вызовы.
При совершении исходящего вызова необходимо учитывать, что он может быть невозможен из-за ограничений, накладываемых фреймворком Telecom. Подробнее об ограничениях на звонки…
Чтобы сделать исходящий вызов, выполните следующие действия:
- Пользователь инициирует исходящий вызов в вашем приложении.
- Используйте метод
placeCall(Uri, Bundle), чтобы сообщить телекоммуникационной подсистеме о новом исходящем вызове. При работе с параметрами метода учитывайте следующее:- Параметр
Uriпредставляет адрес, по которому выполняется вызов. Для обычных номеров телефонов используйте схему URItel:. - Параметр
Bundleпозволяет предоставить информацию о приложении для звонков, добавив объектPhoneAccountHandleприложения в дополнительный параметрEXTRA_PHONE_ACCOUNT_HANDLE. Приложение должно предоставлять объектPhoneAccountHandleдля каждого исходящего вызова. - Параметр
Bundleтакже позволяет указать, включает ли исходящий вызов видео, с помощью значенияSTATE_BIDIRECTIONALв дополнительном параметреEXTRA_START_CALL_WITH_VIDEO_STATE. Учитывайте, что по умолчанию телекоммуникационная подсистема направляет видеовызовы на громкую связь.
- Параметр
- Телекоммуникационная подсистема привязывается к реализации
ConnectionServiceв вашем приложении. - Если приложение не может выполнить исходящий вызов, телекоммуникационная подсистема вызывает метод
onCreateOutgoingConnectionFailed(PhoneAccountHandle, ConnectionRequest), чтобы сообщить приложению, что вызов не может быть выполнен в данный момент. Приложение должно сообщить пользователю, что звонок не может быть выполнен. - Если ваше приложение может совершить исходящий вызов, телекоммуникационная подсистема вызывает метод
onCreateOutgoingConnection(PhoneAccountHandle, ConnectionRequest). Приложение должно возвращать экземпляр классаConnection, представляющий новый исходящий вызов. Подробнее о свойствах, которые нужно задать в подключении… - Когда исходящий вызов будет подключен, вызовите метод
setActive(), чтобы сообщить телекоммуникационной подсистеме, что вызов активен.
Как завершить вызов
Чтобы завершить звонок, выполните следующие действия:
- Вызовите
setDisconnected(DisconnectCause), передавLOCALв качестве параметра, если пользователь завершил вызов, илиREMOTE, если вызов завершил другой абонент. - Вызовите метод
destroy().
Ограничения на вызовы
Чтобы обеспечить единообразие и простоту звонков для пользователей, фреймворк Telecom накладывает некоторые ограничения на управление вызовами на устройстве. Например, у пользователя установлены два приложения для звонков, в которых реализован API ConnectionService с самостоятельным управлением: FooTalk и BarTalk. В этом случае действуют следующие ограничения:
На устройствах с уровнем API 27 или ниже только одно приложение может поддерживать текущий вызов в любой момент времени. Это ограничение означает, что пока у пользователя есть текущий вызов с использованием приложения FooTalk, приложение BarTalk не может инициировать или принять новый звонок.
На устройствах с уровнем API 28 или выше, если FooTalk и BarTalk запрашивают разрешения
CAPABILITY_SUPPORT_HOLDиCAPABILITY_HOLD, пользователь может поддерживать несколько текущих вызовов, переключаясь между приложениями, чтобы начать или принять другой вызов.Если пользователь совершает обычный управляемый вызов (например, с помощью встроенного приложения "Телефон" или "Телефонный набор"), он не может совершать вызовы из приложений для звонков. Это означает, что если пользователь совершает обычный звонок через оператора мобильной связи, он не может одновременно совершать звонок через FooTalk или BarTalk.
Телекоммуникационная подсистема отключает вызовы вашего приложения, если пользователь набирает номер экстренной службы.
Приложение не может принимать или совершать исходящие вызовы, пока пользователь находится в режиме экстренного вызова.
Если в другом приложении для звонков есть текущий вызов, когда ваше приложение получает входящий вызов, ответ на входящий вызов завершает все текущие вызовы в другом приложении. Ваше приложение не должно показывать обычный пользовательский интерфейс входящего вызова. Фреймворк Telecom показывает пользовательский интерфейс входящего вызова и сообщает пользователю, что при ответе на новый звонок текущий будет завершен. Это означает, что если пользователь разговаривает по FooTalk и в приложении BarTalk поступает входящий вызов, фреймворк Telecom сообщает пользователю, что у него есть новый входящий вызов BarTalk и что ответ на вызов BarTalk завершит его вызов FooTalk.
Как сделать приложение "Телефон" приложением по умолчанию
Стандартное приложение для звонков/приложение "Телефон" – это приложение, которое предоставляет пользовательский интерфейс во время вызова, когда устройство находится в режиме вызова. Кроме того, оно позволяет пользователю совершать звонки и просматривать историю вызовов на устройстве. На устройстве есть стандартное приложение "Телефон" для звонков. Пользователь может выбрать другое приложение, которое будет выполнять эту роль. Для этого приложение должно использовать RoleManager, чтобы запросить роль RoleManager.ROLE_DIALER.
Стандартное приложение "Телефон" предоставляет пользовательский интерфейс, когда устройство находится в режиме вызова, но не в режиме автомобиля (то есть UiModeManager#getCurrentModeType() не равно Configuration.UI_MODE_TYPE_CAR).
Чтобы получить роль RoleManager.ROLE_DIALER, приложение должно соответствовать ряду требований:
- Оно должно обрабатывать намерение
Intent#ACTION_DIAL. Это означает, что в приложении должен быть интерфейс с панелью набора номера, чтобы пользователь мог совершать исходящие вызовы. - Оно должно полностью реализовывать API
InCallServiceи предоставлять интерфейс как для входящего вызова, так и для текущего вызова.
Для экстренных вызовов ВСЕГДА будет использоваться предустановленное приложение, даже если ваше приложение выполняет роль RoleManager.ROLE_DIALER. Чтобы обеспечить оптимальную работу при совершении экстренного вызова, приложение для набора номера по умолчанию должно ВСЕГДА использовать TelecomManager.placeCall(Uri, Bundle) для совершения исходящих вызовов (включая экстренные). Это позволяет платформе убедиться, что запрос поступил от приложения для звонков по умолчанию. Если приложение для звонков, которое не было предустановлено, использует Intent#ACTION_CALL для экстренного вызова, то для подтверждения будет вызвано предустановленное приложение с помощью Intent#ACTION_DIAL. Это не очень удобно для пользователя.
Ниже приведен пример регистрации манифеста для InCallService. Метаданные TelecomManager#METADATA_IN_CALL_SERVICE_UI указывают, что эта реализация InCallService должна заменить встроенный интерфейс во время звонка.
Метаданные TelecomManager#METADATA_IN_CALL_SERVICE_RINGING указывают, что этот InCallService будет воспроизводить рингтон для входящих вызовов. Подробнее о том, как показывать интерфейс входящего вызова и воспроизводить рингтон в приложении, рассказывается ниже.
<service android:name="your.package.YourInCallServiceImplementation"
android:permission="android.permission.BIND_INCALL_SERVICE"
android:exported="true">
<meta-data android:name="android.telecom.IN_CALL_SERVICE_UI" android:value="true" />
<meta-data android:name="android.telecom.IN_CALL_SERVICE_RINGING"
android:value="true" />
<intent-filter>
<action android:name="android.telecom.InCallService"/>
</intent-filter>
</service>
Примечание. Не помечайте InCallService атрибутом android:exported="false". В противном случае при вызовах может не выполняться привязка к вашей реализации.
Помимо реализации API InCallService, вам также необходимо объявить в манифесте действие, которое обрабатывает намерение Intent#ACTION_DIAL. Ниже показано, как это сделать.
<activity android:name="your.package.YourDialerActivity"
android:label="@string/yourDialerActivityLabel">
<intent-filter>
<action android:name="android.intent.action.DIAL" />
<category android:name="android.intent.category.DEFAULT" />
</intent-filter>
<intent-filter>
<action android:name="android.intent.action.DIAL" />
<category android:name="android.intent.category.DEFAULT" />
<data android:scheme="tel" />
</intent-filter>
</activity>
Когда пользователь устанавливает ваше приложение и запускает его в первый раз, вы должны использовать RoleManager, чтобы предложить пользователю сделать ваше приложение приложением "Телефон" по умолчанию.
В примере кода ниже показано, как приложение может запросить разрешение на использование в качестве приложения для звонков по умолчанию.
private static final int REQUEST_ID = 1;
public void requestRole() {
RoleManager roleManager = (RoleManager) getSystemService(ROLE_SERVICE);
Intent intent = roleManager.createRequestRoleIntent(RoleManager.ROLE_DIALER);
startActivityForResult(intent, REQUEST_ID);
}
public void onActivityResult(int requestCode, int resultCode, Intent data) {
if (requestCode == REQUEST_ID) {
if (resultCode == android.app.Activity.RESULT_OK) {
// Your app is now the default dialer app
} else {
// Your app is not the default dialer app
}
}
}
Доступ к InCallService для носимых устройств
Если у вас стороннее сопутствующее приложение и вы хотите получить доступ к InCallService API, вы можете:
- Объявите разрешение MANAGE_ONGOING_CALLS в манифесте
- Свяжите приложение с носимым устройством через API
CompanionDeviceManager. Подробнее о подключении дополнительных устройств… - Реализуйте InCallService с разрешением BIND_INCALL_SERVICE.
Показ уведомления о входящем вызове
Когда приложение получает новый входящий вызов черезInCallService#onCallAdded(Call), оно должно показать интерфейс входящего вызова. Для этого оно должно использовать API NotificationManager, чтобы опубликовать новое уведомление о входящем вызове.
Если в приложении объявлены метаданные TelecomManager#METADATA_IN_CALL_SERVICE_RINGING, оно отвечает за воспроизведение рингтона для входящих вызовов. Приложение должно создать объект NotificationChannel, в котором указан нужный рингтон. Пример:
NotificationChannel channel = new NotificationChannel(YOUR_CHANNEL_ID, "Incoming Calls",
NotificationManager.IMPORTANCE_MAX);
// other channel setup stuff goes here.
// We'll use the default system ringtone for our incoming call notification channel. You can
// use your own audio resource here.
Uri ringtoneUri = RingtoneManager.getDefaultUri(RingtoneManager.TYPE_RINGTONE);
channel.setSound(ringtoneUri, new AudioAttributes.Builder()
// Setting the AudioAttributes is important as it identifies the purpose of your
// notification sound.
.setUsage(AudioAttributes.USAGE_NOTIFICATION_RINGTONE)
.setContentType(AudioAttributes.CONTENT_TYPE_SONIFICATION)
.build());
NotificationManager mgr = getSystemService(NotificationManager.class);
mgr.createNotificationChannel(channel);
Когда приложение получает новый входящий вызов, оно создает для него объект Notification и связывает его с каналом уведомлений о входящих вызовах. Вы можете указать в уведомлении PendingIntent, которое запустит полноэкранный интерфейс входящего вызова. Если пользователь активно использует телефон, фреймворк менеджера уведомлений покажет ваше уведомление как всплывающее. Если пользователь не работает с телефоном, то вместо этого будет использоваться полноэкранный интерфейс входящего вызова.
Пример:
// Create an intent which triggers your fullscreen incoming call user interface.
Intent intent = new Intent(Intent.ACTION_MAIN, null);
intent.setFlags(Intent.FLAG_ACTIVITY_NO_USER_ACTION | Intent.FLAG_ACTIVITY_NEW_TASK);
intent.setClass(context, YourIncomingCallActivity.class);
PendingIntent pendingIntent = PendingIntent.getActivity(context, 1, intent, PendingIntent.FLAG_MUTABLE_UNAUDITED);
// Build the notification as an ongoing high priority item; this ensures it will show as
// a heads up notification which slides down over top of the current content.
final Notification.Builder builder = new Notification.Builder(context);
builder.setOngoing(true);
builder.setPriority(Notification.PRIORITY_HIGH);
// Set notification content intent to take user to the fullscreen UI if user taps on the
// notification body.
builder.setContentIntent(pendingIntent);
// Set full screen intent to trigger display of the fullscreen UI when the notification
// manager deems it appropriate.
builder.setFullScreenIntent(pendingIntent, true);
// Setup notification content.
builder.setSmallIcon( yourIconResourceId );
builder.setContentTitle("Your notification title");
builder.setContentText("Your notification content.");
// Use builder.addAction(..) to add buttons to answer or reject the call.
NotificationManager notificationManager = mContext.getSystemService(
NotificationManager.class);
notificationManager.notify(YOUR_CHANNEL_ID, YOUR_TAG, YOUR_ID, builder.build());
```