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

Commit e4bc4e9c authored by Grace Jia's avatar Grace Jia Committed by Automerger Merge Worker
Browse files

Merge "Annotation and doc improvement for adhoc conference APIs." am: 0251d617 

Original change: https://android-review.googlesource.com/c/platform/frameworks/base/+/1412812

MUST ONLY BE SUBMITTED BY AUTOMERGER

Change-Id: Ie6f423bfbd4965e4cc27c3e1591ecdef29dcf0c8
parents 695b9ee4 0251d617

core/api/current.txt

+5 −5
Original line number Diff line number Diff line
@@ -38399,22 +38399,22 @@ package android.telecom { 
    method public final void conferenceRemoteConnections(android.telecom.RemoteConnection, android.telecom.RemoteConnection);

    method public final void connectionServiceFocusReleased();

    method @Nullable public final android.telecom.RemoteConference createRemoteIncomingConference(@Nullable android.telecom.PhoneAccountHandle, @Nullable android.telecom.ConnectionRequest);

    method public final android.telecom.RemoteConnection createRemoteIncomingConnection(android.telecom.PhoneAccountHandle, android.telecom.ConnectionRequest);

    method @Nullable public final android.telecom.RemoteConnection createRemoteIncomingConnection(@NonNull android.telecom.PhoneAccountHandle, @NonNull android.telecom.ConnectionRequest);

    method @Nullable public final android.telecom.RemoteConference createRemoteOutgoingConference(@Nullable android.telecom.PhoneAccountHandle, @Nullable android.telecom.ConnectionRequest);

    method public final android.telecom.RemoteConnection createRemoteOutgoingConnection(android.telecom.PhoneAccountHandle, android.telecom.ConnectionRequest);

    method @Nullable public final android.telecom.RemoteConnection createRemoteOutgoingConnection(@NonNull android.telecom.PhoneAccountHandle, @NonNull android.telecom.ConnectionRequest);

    method public final java.util.Collection<android.telecom.Conference> getAllConferences();

    method public final java.util.Collection<android.telecom.Connection> getAllConnections();

    method public final android.os.IBinder onBind(android.content.Intent);

    method public void onConference(android.telecom.Connection, android.telecom.Connection);

    method public void onConnectionServiceFocusGained();

    method public void onConnectionServiceFocusLost();

    method @Nullable public android.telecom.Conference onCreateIncomingConference(@Nullable android.telecom.PhoneAccountHandle, @Nullable android.telecom.ConnectionRequest);

    method @Nullable public android.telecom.Conference onCreateIncomingConference(@NonNull android.telecom.PhoneAccountHandle, @NonNull android.telecom.ConnectionRequest);

    method public void onCreateIncomingConferenceFailed(@Nullable android.telecom.PhoneAccountHandle, @Nullable android.telecom.ConnectionRequest);

    method public android.telecom.Connection onCreateIncomingConnection(android.telecom.PhoneAccountHandle, android.telecom.ConnectionRequest);

    method public void onCreateIncomingConnectionFailed(android.telecom.PhoneAccountHandle, android.telecom.ConnectionRequest);

    method public android.telecom.Connection onCreateIncomingHandoverConnection(android.telecom.PhoneAccountHandle, android.telecom.ConnectionRequest);

    method @Nullable public android.telecom.Conference onCreateOutgoingConference(@Nullable android.telecom.PhoneAccountHandle, @Nullable android.telecom.ConnectionRequest);

    method public void onCreateOutgoingConferenceFailed(@Nullable android.telecom.PhoneAccountHandle, @Nullable android.telecom.ConnectionRequest);

    method @Nullable public android.telecom.Conference onCreateOutgoingConference(@NonNull android.telecom.PhoneAccountHandle, @NonNull android.telecom.ConnectionRequest);

    method public void onCreateOutgoingConferenceFailed(@NonNull android.telecom.PhoneAccountHandle, @NonNull android.telecom.ConnectionRequest);

    method public android.telecom.Connection onCreateOutgoingConnection(android.telecom.PhoneAccountHandle, android.telecom.ConnectionRequest);

    method public void onCreateOutgoingConnectionFailed(android.telecom.PhoneAccountHandle, android.telecom.ConnectionRequest);

    method public android.telecom.Connection onCreateOutgoingHandoverConnection(android.telecom.PhoneAccountHandle, android.telecom.ConnectionRequest);

telecomm/java/android/telecom/Conference.java

+1 −1
Original line number Diff line number Diff line
@@ -338,7 +338,7 @@ public abstract class Conference extends Conferenceable { 
     *

     * @param videoState The video state in which to answer the connection.

     */

    public void onAnswer(int videoState) {}

    public void onAnswer(@VideoProfile.VideoState int videoState) {}



    /**

     * Notifies this Conference, which is in {@code STATE_RINGING}, of

telecomm/java/android/telecom/ConnectionService.java

+20 −16
Original line number Diff line number Diff line
@@ -2553,9 +2553,9 @@ public abstract class ConnectionService extends Service { 
     * @return The {@code Connection} object to satisfy this call, or {@code null} to

     *         not handle the call.

     */

    public final RemoteConnection createRemoteIncomingConnection(

            PhoneAccountHandle connectionManagerPhoneAccount,

            ConnectionRequest request) {

    public final @Nullable RemoteConnection createRemoteIncomingConnection(

            @NonNull PhoneAccountHandle connectionManagerPhoneAccount,

            @NonNull ConnectionRequest request) {

        return mRemoteConnectionManager.createRemoteConnection(

                connectionManagerPhoneAccount, request, true);

    }
@@ -2572,9 +2572,9 @@ public abstract class ConnectionService extends Service { 
     * @return The {@code Connection} object to satisfy this call, or {@code null} to

     *         not handle the call.

     */

    public final RemoteConnection createRemoteOutgoingConnection(

            PhoneAccountHandle connectionManagerPhoneAccount,

            ConnectionRequest request) {

    public final @Nullable RemoteConnection createRemoteOutgoingConnection(

            @NonNull PhoneAccountHandle connectionManagerPhoneAccount,

            @NonNull ConnectionRequest request) {

        return mRemoteConnectionManager.createRemoteConnection(

                connectionManagerPhoneAccount, request, false);

    }
@@ -2814,12 +2814,14 @@ public abstract class ConnectionService extends Service { 
     * @param connectionManagerPhoneAccount See description at

     *         {@link #onCreateOutgoingConnection(PhoneAccountHandle, ConnectionRequest)}.

     * @param request Details about the incoming conference call.

     * @return The {@code Conference} object to satisfy this call, or {@code null} to

     *         not handle the call.

     * @return The {@code Conference} object to satisfy this call. If the conference attempt is

     *         failed, the return value will be a result of an invocation of

     *         {@link Connection#createFailedConnection(DisconnectCause)}.

     *         Return {@code null} if the {@link ConnectionService} cannot handle the call.

     */

    public @Nullable Conference onCreateIncomingConference(

            @Nullable PhoneAccountHandle connectionManagerPhoneAccount,

            @Nullable ConnectionRequest request) {

            @NonNull PhoneAccountHandle connectionManagerPhoneAccount,

            @NonNull ConnectionRequest request) {

        return null;

    }
@@ -2922,8 +2924,8 @@ public abstract class ConnectionService extends Service { 
     * @param request The outgoing connection request.

     */

    public void onCreateOutgoingConferenceFailed(

            @Nullable PhoneAccountHandle connectionManagerPhoneAccount,

            @Nullable ConnectionRequest request) {

            @NonNull PhoneAccountHandle connectionManagerPhoneAccount,

            @NonNull ConnectionRequest request) {

    }
@@ -2987,12 +2989,14 @@ public abstract class ConnectionService extends Service { 
     *         a {@code PhoneAccount} registered by this {@code ConnectionService} to use for

     *         making the connection.

     * @param request Details about the outgoing call.

     * @return The {@code Conference} object to satisfy this call, or the result of an invocation

     *         of {@link Connection#createFailedConnection(DisconnectCause)} to not handle the call.

     * @return The {@code Conference} object to satisfy this call. If the conference attempt is

     *         failed, the return value will be a result of an invocation of

     *         {@link Connection#createFailedConnection(DisconnectCause)}.

     *         Return {@code null} if the {@link ConnectionService} cannot handle the call.

     */

    public @Nullable Conference onCreateOutgoingConference(

            @Nullable PhoneAccountHandle connectionManagerPhoneAccount,

            @Nullable ConnectionRequest request) {

            @NonNull PhoneAccountHandle connectionManagerPhoneAccount,

            @NonNull ConnectionRequest request) {

        return null;

    }