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

Merge "remove all uses of AndroidX in telecom frameworks comments" into udc-dev

Browse Source
This commit is contained in:
Thomas Stuart
2023-03-03 00:13:49 +00:00
committed by Android (Google) Code Review
parent e8132b1c51 ef58429d0c
commit 24945b1d1e
2 changed files with 24 additions and 18 deletions
Download Patch File Download Diff File Expand all files Collapse all files

25
telecomm/java/android/telecom/CallControl.java
View File

@@ -294,18 +294,21 @@ public final class CallControl {
/** /**
* Raises an event to the {@link android.telecom.InCallService} implementations tracking this * Raises an event to the {@link android.telecom.InCallService} implementations tracking this
* call via {@link android.telecom.Call.Callback#onConnectionEvent(Call, String, Bundle)}. * call via {@link android.telecom.Call.Callback#onConnectionEvent(Call, String, Bundle)}.
* These events and the associated extra keys for the {@code Bundle} parameter are defined * These events and the associated extra keys for the {@code Bundle} parameter are mutually
* in Android X. This API is used to relay additional information about a call other than * defined by a VoIP application and {@link android.telecom.InCallService}. This API is used to
* what is specified in the {@link android.telecom.CallAttributes} to * relay additional information about a call other than what is specified in the
* {@link android.telecom.InCallService}s. This might include, for example, a change to the list * {@link android.telecom.CallAttributes} to {@link android.telecom.InCallService}s. This might
* of participants in a meeting, or the name of the speakers who have their hand raised. Where * include, for example, a change to the list of participants in a meeting, or the name of the
* appropriate, the {@link InCallService}s tracking this call may choose to render this * speakers who have their hand raised. Where appropriate, the {@link InCallService}s tracking
* additional information about the call. An automotive calling UX, for example may have enough * this call may choose to render this additional information about the call. An automotive
* screen real estate to indicate the number of participants in a meeting, but to prevent * calling UX, for example may have enough screen real estate to indicate the number of
* distractions could suppress the list of participants. * participants in a meeting, but to prevent distractions could suppress the list of
* participants.
* *
* @param event that is defined in AndroidX (ex. The number of participants changed) * @param event a string event identifier agreed upon between a VoIP application and an
* @param extras the updated value in relation to the event (ex. 4 participants) * {@link android.telecom.InCallService}
* @param extras a {@link android.os.Bundle} containing information about the event, as agreed
* upon between a VoIP application and {@link android.telecom.InCallService}.
*/ */
public void sendEvent(@NonNull String event, @NonNull Bundle extras) { public void sendEvent(@NonNull String event, @NonNull Bundle extras) {
Objects.requireNonNull(event); Objects.requireNonNull(event);

17
telecomm/java/android/telecom/CallEventCallback.java
View File

@@ -60,14 +60,17 @@ public interface CallEventCallback {
/** /**
* Informs this {@link android.telecom.CallEventCallback} on events raised from a * Informs this {@link android.telecom.CallEventCallback} on events raised from a
* {@link android.telecom.InCallService} presenting this call. The event key and extra values * {@link android.telecom.InCallService} presenting this call. These events and the
* are defined in AndroidX. This enables alternative calling surfaces, such as an automotive * associated extra keys for the {@code Bundle} parameter are mutually defined by a VoIP
* UI, to relay requests to perform other non-standard call actions to the app. For example, * application and {@link android.telecom.InCallService}. This enables alternative calling
* an automotive calling solution may offer the ability for the user to raise their hand * surfaces, such as an automotive UI, to relay requests to perform other non-standard call
* during a meeting. * actions to the app. For example, an automotive calling solution may offer the ability for
* the user to raise their hand during a meeting.
* *
* @param event that is defined in AndroidX (ex. the number of participants changed) * @param event a string event identifier agreed upon between a VoIP application and an
* @param extras the updated value in relation to the event (ex. 4 participants) * {@link android.telecom.InCallService}
* @param extras a {@link android.os.Bundle} containing information about the event, as agreed
* upon between a VoIP application and {@link android.telecom.InCallService}.
*/ */
void onEvent(@NonNull String event, @NonNull Bundle extras); void onEvent(@NonNull String event, @NonNull Bundle extras);
} }