Перейти к основному содержимому

Подключение голосовых Push-уведомлений

Обновлено: 2 сентября 2026

Голосовые Push-уведомления позволяют отображать интерфейс входящего вызова и воспроизводить аудиофайл после принятия звонка. Основные возможности:

  • отображение экрана входящего вызова с названием приложения, логотипом и кнопками принятия и отклонения;
  • воспроизведение аудиофайла после принятия вызова;
  • отображение экрана активного разговора с возможностью завершить вызов или выбрать устройство воспроизведения.

Особенности работы​

  • В атрибутах Push-сообщения должны присутствовать параметры voicePushType=audioCallPush и voiceMessageUrl.
  • Аудиофайл не сохраняется на устройстве пользователя.
  • Во время входящего вызова автоматический поворот экрана отключается.
  • При поступлении вызова воспроизведение текущего аудио или видео автоматически приостанавливается.
  • При ошибке загрузки библиотека может повторно скачать аудиофайл. Количество попыток определяется параметром fileDownloadingSettings.
  • Если уведомление переопределяет параметры отображения окон вызова, после его обработки необходимо вернуть значения по умолчанию.
warning

Для использования голосовых Push-уведомлений должны выполняться следующие условия:

  • Android 8.0 (API 26) или выше;
  • размер аудиофайла — не более 5 МБ;
  • поддерживаемые форматы: mp3, wav, flac, aac.

Интеграция библиотеки​

Шаг 1. Обновите AndroidManifest.xml​

Добавьте в файл AndroidManifest.xml необходимые разрешения и зарегистрируйте обработчик событий.

<?xml version="1.0" encoding="utf-8"?>

<manifest xmlns:android="http://schemas.android.com/apk/res/android">

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

<permission
android:name="[APP_PACKAGE_NAME].permission.voicepush.RECEIVE_VP"
android:protectionLevel="signature" />

<uses-permission
android:name="[APP_PACKAGE_NAME].permission.voicepush.RECEIVE_VP" />

<application>

<receiver
android:name="[VOICE_PUSH_BROADCAST_RECEIVER]"
android:exported="false"
android:permission="[APP_PACKAGE_NAME].permission.voicepush.RECEIVE_VP">

<intent-filter>
<action android:name="com.edna.android.voicepush.ERROR_EVENT" />
<action android:name="com.edna.android.voicepush.VOICE_PUSH_EVENT" />
</intent-filter>

</receiver>

</application>

</manifest>

Используемые параметры:

ПараметрОписание
[VOICE_PUSH_BROADCAST_RECEIVER]Класс-наследник VoicePushBroadcastReceiver, обрабатывающий события библиотеки
[APP_PACKAGE_NAME]Полное имя пакета приложения

Шаг 2. Добавьте зависимости​

app/build.gradle с использованием BOM Рекомендуемый вариант​

apply plugin: 'com.google.gms.google-services'

android {
compileSdkVersion 36

defaultConfig {
minSdkVersion 26
targetSdkVersion 36
}
}

compileOptions {
sourceCompatibility JavaVersion.VERSION_17
targetCompatibility JavaVersion.VERSION_17
}

kotlinOptions {
jvmTarget = '17'
}

dependencies {
roomVersion = '2.5.0' // или выше, если ранее использовался
releaseImplementation platform('com.edna.android:push-lite-bom-release:3.19.0')
releaseImplementation "com.edna.android:voice-push-release"

debugImplementation platform('com.edna.android:push-lite-bom-debug:3.19.0')
debugImplementation "com.edna.android:voice-push-debug"
}

app/build.gradle без использования BOM​

apply plugin: 'com.google.gms.google-services'

android {
compileSdkVersion 36

defaultConfig {
minSdkVersion 26
targetSdkVersion 36
}
}

compileOptions {
sourceCompatibility JavaVersion.VERSION_17
targetCompatibility JavaVersion.VERSION_17
}

kotlinOptions {
jvmTarget = '17'
}

dependencies {
debugImplementation 'com.edna.android:push-lite-debug:3.19.0'
debugImplementation 'com.edna.android:voice-push-debug:1.4.0'

releaseImplementation 'com.edna.android:push-lite-release:3.19.0'
releaseImplementation 'com.edna.android:voice-push-release:1.4.0'
}
warning

Debug- и release-версии библиотеки работают с разными серверами. Для сборок приложений, которые публикуются в Google Play, используйте только библиотеку push-lite-release.

Шаг 3. Настройте библиотеку​

Добавьте инициализацию в метод Application.onCreate().

val size = TypedValue.applyDimension(
TypedValue.COMPLEX_UNIT_DIP,
54f,
resources.displayMetrics
).toInt()

val commonCallStyles = CommonCallStyles(
IncomingCallStyles(
acceptButton = ButtonStyle(size),
declineButton = ButtonStyle(size)
)
)

val voicePushController = VoicePushController(this)
voicePushController.setDefaultData(DefaultVoicePushData.commonData)
DefaultVoicePushData.commonCallStyles = commonCallStyles
voicePushController.setDefaultStyle(commonCallStyles)
warning

Если в уведомлении переопределяются параметры окон вызова, то после его обработки значения этих параметров должны быть сброшены.

Шаг 4. Создайте параметры оформления​

Создайте объект DefaultVoicePushData, содержащий настройки отображения вызова.

object DefaultVoicePushData {

var commonData = CommonData(
IncomingCallData(
"Входящий звонок",
"Название приложения",
"ic_custom_caller"
),
ActiveCallData(
"Входящий разговор",
"Название приложения",
"ic_custom_caller"
),
NotificationData(
"Входящий",
"Название приложения",
"ic_custom_caller"
),
fileDownloadingSettings = FileDownloadingSettings(
downloadingAttemptsCellular = 1,
downloadingAttemptsWifi = 2
)
)

var commonCallStyles = CommonCallStyles()

}

Шаг 5. Создайте обработчик голосовых Push​

Создайте класс-наследник VoicePushBroadcastReceiver.

class CustomVoicePushReceiver : VoicePushBroadcastReceiver() {

override fun onVoicePushAction(
context: Context,
voicePushEvent: VoicePushData
) {
}

override fun onVoicePushError(
context: Context,
voicePushError: VoicePushError
) {
}

}

Шаг 6. Обновите PushBroadcastReceiver​

Для корректной обработки голосовых Push вызовите super.onShortPushReceived().

class CustomPushBroadcastReceiver : PushBroadcastReceiver() {

override fun onShortPushReceived(
context: Context,
messageId: String?,
alert: String?,
bundle: Bundle
) {

if (!bundle.containsKey("fullVoicePush")) {
super.onShortPushReceived(
context,
messageId,
alert,
bundle
)
}

}

}