Improve docs for uploadCallComposerPicture
Add stuff about when this functionality is available and what image
formats are supported.
Fixes: 180419617
Test: docs onle
Change-Id: I541f32a4021deee6848408898186dcffeff81a89
diff --git a/telephony/java/android/telephony/TelephonyManager.java b/telephony/java/android/telephony/TelephonyManager.java
index ee3a0ef..1079721 100644
--- a/telephony/java/android/telephony/TelephonyManager.java
+++ b/telephony/java/android/telephony/TelephonyManager.java
@@ -4461,6 +4461,10 @@
* This functionality is only available to the app filling the {@link RoleManager#ROLE_DIALER}
* role on the device.
*
+ * This functionality is only available when
+ * {@link CarrierConfigManager#KEY_SUPPORTS_CALL_COMPOSER_BOOL} is set to {@code true} in the
+ * bundle returned from {@link #getCarrierConfig()}.
+ *
* @param pictureToUpload An {@link InputStream} that supplies the bytes representing the
* picture to upload. The client bears responsibility for closing this
* stream after {@code callback} is called with success or failure.
@@ -4469,7 +4473,9 @@
* of {@link #getMaximumCallComposerPictureSize()}, the upload will be
* aborted and the callback will be called with an exception containing
* {@link CallComposerException#ERROR_FILE_TOO_LARGE}.
- * @param contentType The MIME type of the picture you're uploading (e.g. image/jpeg)
+ * @param contentType The MIME type of the picture you're uploading (e.g. image/jpeg). The list
+ * of acceptable content types can be found at 3GPP TS 26.141 sections
+ * 4.2 and 4.3.
* @param executor The {@link Executor} on which the {@code pictureToUpload} stream will be
* read, as well as on which the callback will be called.
* @param callback A callback called when the upload operation terminates, either in success