Update documentation of NEW_OUTGOING_CALL
Adds call-handling as a use case for NEW_OUTGOING_CALL
bug: 8987211
Change-Id: Icd9c53a2dd1a5948a749e133600db21c2560fd1f
diff --git a/core/java/android/content/Intent.java b/core/java/android/content/Intent.java
index 65f904f..001a65c 100644
--- a/core/java/android/content/Intent.java
+++ b/core/java/android/content/Intent.java
@@ -2294,6 +2294,10 @@
* <p>Emergency calls cannot be intercepted using this mechanism, and
* other calls cannot be modified to call emergency numbers using this
* mechanism.
+ * <p>Some apps (such as VoIP apps) may want to redirect the outgoing
+ * call to use their own service instead. Those apps should first prevent
+ * the call from being placed by setting resultData to <code>null</code>
+ * and then start their own app to make the call.
* <p>You must hold the
* {@link android.Manifest.permission#PROCESS_OUTGOING_CALLS}
* permission to receive this Intent.</p>