Подключение голосовых Push-уведомлений
Голосовые Push-уведомления позволяют отображать интерфейс входящего вызова и воспроизводить аудиофайл после принятия звонка. Основные возможности:
- отображение экрана входящего вызова с названием приложения, логотипом и кнопками принятия и отклонения;
- воспроизведение аудиофайла после принятия вызова;
- отображение экрана активного разговора с возможностью завершить вызов или выбрать устройство воспроизведения.
Особенности работы
- В атрибутах Push-сообщения должны присутствовать параметры
voicePushType=audioCallPushиvoiceMessageUrl. - Аудиофайл не сохраняется на устройстве пользователя.
- Во время входящего вызова автоматический поворот экрана отключается.
- При поступлении вызова воспроизведение текущего аудио или видео автоматически приостанавливается.
- При ошибке загрузки библиотека может повторно скачать аудиофайл. Количество попыток определяется параметром
fileDownloadingSettings. - Если уведомление переопределяет параметры отображения окон вызова, после его обработки необходимо вернуть значения по умолчанию.
Для использования голосовых 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'
}
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)
Если в уведомлении переопределяются параметры окон вызова, то после его обработки значения этих параметров должны быть сброшены.
Шаг 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
)
}
}
}