Android/frameworks_base
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Merge "Update audio processing API docs." into rvc-dev

Browse Source
This commit is contained in:
Tyler Gunn
2020-05-15 22:10:00 +00:00
committed by Android (Google) Code Review
parent 1d932772a1 460b7d49a1
commit 04e5ed5223
2 changed files with 24 additions and 3 deletions
Download Patch File Download Diff File Expand all files Collapse all files

13
telecomm/java/android/telecom/Call.java
View File

@@ -22,6 +22,7 @@ import android.annotation.Nullable;
import android.annotation.SystemApi;
import android.annotation.TestApi;
import android.compat.annotation.UnsupportedAppUsage;
import android.content.pm.ServiceInfo;
import android.net.Uri;
import android.os.Build;
import android.os.Bundle;
@@ -1635,13 +1636,21 @@ public final class Call {
/**
* Instructs Telecom to put the call into the background audio processing state.
*
* <p>
* This method can be called either when the call is in {@link #STATE_RINGING} or
* {@link #STATE_ACTIVE}. After Telecom acknowledges the request by setting the call's state to
* {@link #STATE_AUDIO_PROCESSING}, your app may setup the audio paths with the audio stack in
* order to capture and play audio on the call stream.
*
* <p>
* This method can only be called by the default dialer app.
* <p>
* Apps built with SDK version {@link android.os.Build.VERSION_CODES#R} or later which are using
* the microphone as part of audio processing should specify the foreground service type using
* the attribute {@link android.R.attr#foregroundServiceType} in the {@link InCallService}
* service element of the app's manifest file.
* The {@link ServiceInfo#FOREGROUND_SERVICE_TYPE_MICROPHONE} attribute should be specified.
* @see <a href="https://developer.android.com/preview/privacy/foreground-service-types">
* the Android Developer Site</a> for more information.
* @hide
*/
@SystemApi

14
telecomm/java/android/telecom/CallScreeningService.java
View File

@@ -23,6 +23,7 @@ import android.annotation.TestApi;
import android.app.Service;
import android.content.ComponentName;
import android.content.Intent;
import android.content.pm.ServiceInfo;
import android.net.Uri;
import android.os.Handler;
import android.os.IBinder;
@@ -281,9 +282,20 @@ public abstract class CallScreeningService extends Service {
* Sets whether to request background audio processing so that the in-call service can
* screen the call further. If set to {@code true}, {@link #setDisallowCall} should be
* called with {@code false}, and all other parameters in this builder will be ignored.
*
* <p>
* This request will only be honored if the {@link CallScreeningService} shares the same
* uid as the default dialer app. Otherwise, the call will go through as usual.
* <p>
* Apps built with SDK version {@link android.os.Build.VERSION_CODES#R} or later which
* are using the microphone as part of audio processing should specify the
* foreground service type using the attribute
* {@link android.R.attr#foregroundServiceType} in the {@link CallScreeningService}
* service element of the app's manifest file.
* The {@link ServiceInfo#FOREGROUND_SERVICE_TYPE_MICROPHONE} attribute should be
* specified.
* @see
* <a href="https://developer.android.com/preview/privacy/foreground-service-types">
* the Android Developer Site</a> for more information.
*
* @param shouldScreenCallViaAudioProcessing Whether to request further call screening.
* @hide