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

Commit 792a50a3 authored by Thomas Stuart's avatar Thomas Stuart
Browse files

update docs for Connection#onHold() 

The topic adds a transactional way to verify call state changes.
Connection#onHold can now lead to the call being disconnected if the
Connection#setOnHold is not called within the 2 second timeframe. The
docs should be updated to reflect this behavior change.

Test: build + existing Telecom test suite
Fixes: b/267234374
Change-Id: I910843d4e8adec8d38cd32915f223540cefb9ac6
parent 8813848c

telecomm/java/android/telecom/Connection.java

+5 −1
Original line number Diff line number Diff line
@@ -3388,7 +3388,11 @@ public abstract class Connection extends Conferenceable { 
    public void onAbort() {}



    /**

     * Notifies this Connection of a request to hold.

     * Notifies this Connection of a request to hold. {@link Connection#setOnHold} should be within

     * the onHold() body in order to transition the call state to {@link Connection#STATE_HOLDING}.

     * <p>

     * Note: If the Connection does not transition to  {@link Connection#STATE_HOLDING} within 2

     * seconds, the call will be disconnected.

     */

    public void onHold() {}