Merge "remove all uses of AndroidX in telecom frameworks comments" into udc-dev (24945b1d) · Commits · e / os / android_frameworks_base

telecomm/java/android/telecom/CallControl.java

+14 −11

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

telecomm/java/android/telecom/CallEventCallback.java

+10 −7

Original line number	Diff line number	Diff line
		@@ -60,14 +60,17 @@ public interface CallEventCallback {

		/**
		* Informs this {@link android.telecom.CallEventCallback} on events raised from a
		* {@link android.telecom.InCallService} presenting this call. The event key and extra values
		* are defined in AndroidX. This enables alternative calling surfaces, such as an automotive
		* UI, to relay requests to perform other non-standard call actions to the app. For example,
		* an automotive calling solution may offer the ability for the user to raise their hand
		* during a meeting.
		* {@link android.telecom.InCallService} presenting this call. These events and the
		* associated extra keys for the {@code Bundle} parameter are mutually defined by a VoIP
		* application and {@link android.telecom.InCallService}. This enables alternative calling
		* surfaces, such as an automotive UI, to relay requests to perform other non-standard call
		* 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 extras the updated value in relation to the event (ex. 4 participants)
		* @param event a string event identifier agreed upon between a VoIP application and an
		* {@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);
		}