drgreen/android_frameworks_base
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Merge "Add clarification text on getCallerNumberVerificationStatus docs." am: f83bccb02f am: 793b248026

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

Change-Id: Ie2f31334928f716e3bb1b337081fd5b8af83ab9b
This commit is contained in:
Tyler Gunn
2020-10-09 18:03:34 +00:00
committed by Automerger Merge Worker
parent a95dc0e13f 793b248026
commit 0b22366dc7
1 changed files with 26 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

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

@ -966,6 +966,32 @@ public final class Call {
/** /**
* Gets the verification status for the phone number of an incoming call as identified in * Gets the verification status for the phone number of an incoming call as identified in
* ATIS-1000082. * ATIS-1000082.
* <p>
* For incoming calls, the number verification status indicates whether the device was
* able to verify the authenticity of the calling number using the STIR process outlined
* in ATIS-1000082. {@link Connection#VERIFICATION_STATUS_NOT_VERIFIED} indicates that
* the network was not able to use STIR to verify the caller's number (i.e. nothing is
* known regarding the authenticity of the number.
* {@link Connection#VERIFICATION_STATUS_PASSED} indicates that the network was able to
* use STIR to verify the caller's number. This indicates that the network has a high
* degree of confidence that the incoming call actually originated from the indicated
* number. {@link Connection#VERIFICATION_STATUS_FAILED} indicates that the network's
* STIR verification did not pass. This indicates that the incoming call may not
* actually be from the indicated number. This could occur if, for example, the caller
* is using an impersonated phone number.
* <p>
* A {@link CallScreeningService} can use this information to help determine if an
* incoming call is potentially an unwanted call. A verification status of
* {@link Connection#VERIFICATION_STATUS_FAILED} indicates that an incoming call may not
* actually be from the number indicated on the call (i.e. impersonated number) and that it
* should potentially be blocked. Likewise,
* {@link Connection#VERIFICATION_STATUS_PASSED} can be used as a positive signal to
* help clarify that the incoming call is originating from the indicated number and it
* is less likely to be an undesirable call.
* <p>
* An {@link InCallService} can use this information to provide a visual indicator to the
* user regarding the verification status of a call and to help identify calls from
* potentially impersonated numbers.
* @return the verification status. * @return the verification status.
*/ */
public @Connection.VerificationStatus int getCallerNumberVerificationStatus() { public @Connection.VerificationStatus int getCallerNumberVerificationStatus() {