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

Merge "Clarify start/stop DTMF tone API documentation." am: b212a4bfc7

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

Change-Id: I3fe36c88c02f281d63246007c2e004ebd75791f0
Signed-off-by: Automerger Merge Worker <android-build-automerger-merge-worker@system.gserviceaccount.com>
This commit is contained in:
Tyler Gunn
2023-02-10 21:36:42 +00:00
committed by Automerger Merge Worker
parent f2a74a3a64 b212a4bfc7
commit def39f477a
1 changed files with 9 additions and 2 deletions
Download Patch File Download Diff File Expand all files Collapse all files

11
telecomm/java/android/telecom/Call.java
View File

@@ -1839,8 +1839,15 @@ public final class Call {
/**
* Instructs this {@code Call} to play a dual-tone multi-frequency signaling (DTMF) tone.
*
* Any other currently playing DTMF tone in the specified call is immediately stopped.
* <p>
* Tones are both played locally for the user to hear and sent to the network to be relayed
* to the remote device.
* <p>
* You must ensure that any call to {@link #playDtmfTone(char}) is followed by a matching
* call to {@link #stopDtmfTone()} and that each tone is stopped before a new one is started.
* The play and stop commands are relayed to the underlying
* {@link android.telecom.ConnectionService} as executed; implementations may not correctly
* handle out of order commands.
*
* @param digit A character representing the DTMF digit for which to play the tone. This
* value must be one of {@code '0'} through {@code '9'}, {@code '*'} or {@code '#'}.