Release date: April 26, 2021

Overview

Android Mobile Messaging SDK version 4.8.1 release includes Voice & Video support and enhancements.

Environmental Requirements

The Android Mobile Messaging SDK version 4.8.1 uses:

  • Minimum API version 21
  • Compile API version 28
  • Target API version 28
  • Maps SDK "com.google.android.gms:play-services-maps:16.1.0"

(unchanged from version 4.7.1)

Maven Central

Maven Central is the new repository for SDK v4.8.1 and above.

Maven Central Repository: LivePerson Messaging SDK

Add mavenCentral() to the project level gradle file.

repositories {
    mavenCentral()
}

New Feature:

Voice and Video integration allows brand agents to communicate with consumers via voice or video calls.

Voice call example screen Video call example screen

Voice & Video capabilities are available only on Android SDK 4.8.1 and above. Only enabled for authentication mode: Code flow and JWT flow.

KB article: Voice & Video Overview

To enable the feature on your Conversational Cloud account please review the KB article

Features and Permissions

Below is the list of features and permissions elements added in the manifest file to support this feature.

<uses-permission android:name="android.permission.CAMERA" />
<uses-permission android:name="android.webkit.resource.AUDIO_CAPTURE" />
<uses-permission android:name="android.webkit.resource.VIDEO_CAPTURE" />
<uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS" />

<uses-feature android:name="android.hardware.audio.pro" />
<uses-feature android:name="android.hardware.microphone" />

If you want to allow consumers to download the app from Google Play Store, even if their devices don't support Audio latency, please add below features in your app's manifest file:

<uses-feature android:name="android.hardware.audio.pro"  android:required="false" tools:replace="required" />
<uses-feature android:name="android.hardware.microphone"  android:required="false" tools:replace="required" />

Similarly for permissions, you can disable these permissions elements by adding:

<uses-permission android:name="android.permission.CAMERA" tools:node="remove" />
<uses-permission android:name="android.webkit.resource.AUDIO_CAPTURE" tools:node="remove" />
<uses-permission android:name="android.webkit.resource.VIDEO_CAPTURE" tools:node="remove" />
<uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS" tools:node="remove" />

How to enable:

<bool name="lp_enable_voice_video_call">true</bool>

Branding and Configurations

lp_enable_voice_video_call

Enables or disables the ability for an Agent to start a voice or video call.

  • Type: bool
  • Default value: false

lp_voice_call_image_icon

Defines default Image icon for Voice Invite.

  • Type: drawable

lp_video_call_image_icon

Defines default Image icon for Video Invite.

  • Type: drawable

lp_voice_video_accept_call_button_image

Defines default background image for Accept button on Voice & Video Invite

  • Type: drawable

lp_voice_video_decline_call_button_image

Defines default background image for Decline button on Voice & Video Invite

  • Type: drawable

lp_voice_video_end_call_button_image

Defines default background image for End button on Voice & Video Invite

  • Type: drawable
  • Preconditions: This image is only shown on the Voice & Video Invite when Consumer has an active Call
  • Notes: To enable this image lp_voice_video_end_call_button_type should be set to hangup`

lp_voice_video_join_call_button_image

Defines default background image for Join button on Voice & Video Invite

  • Type: drawable
  • Preconditions: This image is only shown on the Voice & Video Invite when Consumer has an active Call

lp_voice_video_invite_icon_tint

Defines default icon tint color on Voice & Video Invite

  • Type: color
  • Default value: gray

lp_voice_video_accept_button_tint

Defines default tint color for Accept/Join Button on Voice & Video Invite

  • Type: color
  • Default value: white
  • Note: This property controls both the Accept and Join call Button

lp_voice_video_decline_button_tint

Defines default tint color for Decline/End Button on Voice & Video Invite

  • Type: color
  • Default value: red
  • Note: This property controls both the Decline and End call Button

lp_voice_video_accept_button_background_color

Defines default background color for Accept/Join Button on Voice & Video Invite

  • Type: color
  • Default value: green
  • Note: This property controls both the Accept and Join call Button

lp_voice_video_decline_button_background_color

Defines default background color for Decline/End Button on Voice & Video Invite

  • Type: color
  • Default value: clear
  • Note: This property controls both the Decline and End call Button

lp_voice_video_invite_icon_render_original_image

Defines if use original image lp_video_call_image_icon or lp_voice_call_image_icon image for Voice or Video Invitation Icon

  • Type: boolean
  • Default value: false

lp_voice_video_accept_button_render_original_image

Defines if use original image lp_voice_video_accept_call_button_image or lp_voice_video_join_call_button_image for Accept Button on Voice & Video Invitation

  • Type: boolean
  • Default value: false

lp_voice_video_decline_button_render_original_image

Defines if use lp_voice_video_decline_call_button_image or lp_voice_video_end_call_button_image for Decline Button on Voice & Video Invitation

  • Type: boolean
  • Default value: false

lp_voice_video_end_call_button_type

Defines which icon to display on Join Button for Voice & Video Invitation

0: Close 1: Hangup

  • Type: integer
  • Default value: 0
  • Preconditions: This type is only shown on the Voice & Video Invite when Consumer has an active Call

lp_voice_video_invitation_bubble_background_color

Defines background color for Voice & Video Bubble

  • Type: color
  • Default value: light gray

Attribute Update:

lp_hide_ui_until_auth is added back.

Bugs Fixed:

  • Crash on conversation screen.

Enhancements:

  • Accessibility enhancements.