Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit ef58429d authored by Thomas Stuart's avatar Thomas Stuart
Browse files

remove all uses of AndroidX in telecom frameworks comments 

bug: 271324001
Test: none
Change-Id: Ifbb246d5469a93ec1da8b706edf3a05e87790999
parent 643dc76f

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);

}