android/android-9.0.0_r35 : android/provider/VoicemailContract.java

VoicemailContract
https://source.android.com/
/*
 * Copyright (C) 2011 The Android Open Source Project
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *      http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License
 */

package android.provider;

import android.annotation.SdkConstant;
import android.annotation.SdkConstant.SdkConstantType;
import android.content.ComponentName;
import android.content.ContentResolver;
import android.content.ContentValues;
import android.content.Context;
import android.content.Intent;
import android.database.ContentObserver;
import android.net.Uri;
import android.provider.CallLog.Calls;
import android.telecom.PhoneAccount;
import android.telecom.PhoneAccountHandle;
import android.telecom.Voicemail;

import java.util.List;

The contract between the voicemail provider and applications. Contains
definitions for the supported URIs and columns.
The content providers exposes two tables through this interface:

   Voicemails table: This stores the actual voicemail records. The columns and URIs for accessing this table are defined by the Voicemails class. 
   Status table: This provides a way for the voicemail source application to convey its current state to the system. The columns and URIS for accessing this table are defined by the Status class. 

 The minimum permission needed to access this content provider is ADD_VOICEMAIL.ADD_VOICEMAIL or carrier privileges (see TelephonyManager.hasCarrierPrivileges). 
Voicemails are inserted by what is called as a "voicemail source" application, which is responsible for syncing voicemail data between a remote server and the local voicemail content provider. "voicemail source" application should always set the PARAM_KEY_SOURCE_PACKAGE in the URI to identify its package. 
In addition to the ContentObserver notifications the voicemail provider also generates broadcast intents to notify change for applications that are not active and therefore cannot listen to ContentObserver notifications. Broadcast intents with following actions are generated: 

   ACTION_NEW_VOICEMAIL is generated for each new voicemail inserted. 
   Intent.ACTION_PROVIDER_CHANGED is generated for any change made into the database, including new voicemail. 

/**
 * The contract between the voicemail provider and applications. Contains
 * definitions for the supported URIs and columns.
 *
 * <P>The content providers exposes two tables through this interface:
 * <ul>
 *   <li> Voicemails table: This stores the actual voicemail records. The
 *   columns and URIs for accessing this table are defined by the
 *   {@link Voicemails} class.
 *   </li>
 *   <li> Status table: This provides a way for the voicemail source application
 *   to convey its current state to the system. The columns and URIS for
 *   accessing this table are defined by the {@link Status} class.
 *   </li>
 * </ul>
 *
 * <P> The minimum permission needed to access this content provider is
 * {@link android.Manifest.permission#ADD_VOICEMAIL} or carrier privileges (see
 * {@link android.telephony.TelephonyManager#hasCarrierPrivileges}).
 *
 * <P>Voicemails are inserted by what is called as a "voicemail source"
 * application, which is responsible for syncing voicemail data between a remote
 * server and the local voicemail content provider. "voicemail source"
 * application should always set the {@link #PARAM_KEY_SOURCE_PACKAGE} in the
 * URI to identify its package.
 *
 * <P>In addition to the {@link ContentObserver} notifications the voicemail
 * provider also generates broadcast intents to notify change for applications
 * that are not active and therefore cannot listen to ContentObserver
 * notifications. Broadcast intents with following actions are generated:
 * <ul>
 *   <li> {@link #ACTION_NEW_VOICEMAIL} is generated for each new voicemail
 *   inserted.
 *   </li>
 *   <li> {@link Intent#ACTION_PROVIDER_CHANGED} is generated for any change
 *    made into the database, including new voicemail.
 *   </li>
 * </ul>
 */
public class VoicemailContract {
    Not instantiable. /** Not instantiable. */
    private VoicemailContract() {
    }

    The authority used by the voicemail provider. /** The authority used by the voicemail provider. */
    public static final String AUTHORITY = "com.android.voicemail";
    Parameter key used in the URI to specify the voicemail source package name.
 This field must be set in all requests that originate from a voicemail source.
/**
     * Parameter key used in the URI to specify the voicemail source package name.
     * <p> This field must be set in all requests that originate from a voicemail source.
     */
    public static final String PARAM_KEY_SOURCE_PACKAGE = "source_package";

    Broadcast intent when a new voicemail record is inserted. /** Broadcast intent when a new voicemail record is inserted. */
    @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION)
    public static final String ACTION_NEW_VOICEMAIL = "android.intent.action.NEW_VOICEMAIL";

    Broadcast intent to request a voicemail source to fetch voicemail content of a specific
voicemail from the remote server. The voicemail to fetch is specified by the data uri
of the intent.
 All voicemail sources are expected to handle this event. After storing the content the application should also set Voicemails.HAS_CONTENT to 1; /**
     * Broadcast intent to request a voicemail source to fetch voicemail content of a specific
     * voicemail from the remote server. The voicemail to fetch is specified by the data uri
     * of the intent.
     * <p>
     * All voicemail sources are expected to handle this event. After storing the content
     * the application should also set {@link Voicemails#HAS_CONTENT} to 1;
     */
    @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION)
    public static final String ACTION_FETCH_VOICEMAIL = "android.intent.action.FETCH_VOICEMAIL";

    Broadcast intent to request all voicemail sources to perform a sync with the remote server.
/**
     * Broadcast intent to request all voicemail sources to perform a sync with the remote server.
     */
    @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION)
    public static final String ACTION_SYNC_VOICEMAIL = "android.provider.action.SYNC_VOICEMAIL";

    Broadcast intent to inform a new visual voicemail SMS has been received. This intent will
only be delivered to the telephony service.
See Also: EXTRA_VOICEMAIL_SMS
EXTRA_TARGET_PACKAGE
@hide /**
     * Broadcast intent to inform a new visual voicemail SMS has been received. This intent will
     * only be delivered to the telephony service.
     *
     * @see #EXTRA_VOICEMAIL_SMS
     * @see #EXTRA_TARGET_PACKAGE
     *
     * @hide */
    @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION)
    public static final String ACTION_VOICEMAIL_SMS_RECEIVED =
            "com.android.internal.provider.action.VOICEMAIL_SMS_RECEIVED";

    Extra in ACTION_VOICEMAIL_SMS_RECEIVED indicating the content of the SMS. 
@hide /**
     * Extra in {@link #ACTION_VOICEMAIL_SMS_RECEIVED} indicating the content of the SMS.
     *
     * @hide
     */
    public static final String EXTRA_VOICEMAIL_SMS = "android.provider.extra.VOICEMAIL_SMS";

    Extra in ACTION_VOICEMAIL_SMS_RECEIVED indicating the target package to bind VisualVoicemailService. This extra should be set to android.telephony.VisualVoicemailSmsFilterSettings#packageName
while performing filtering. Since the default dialer might change between the filter sending
it and telephony binding to the service, this ensures the service will not receive SMS
filtered by the previous app.
@hide /**
     * Extra in {@link #ACTION_VOICEMAIL_SMS_RECEIVED} indicating the target package to bind {@link
     * android.telephony.VisualVoicemailService}.
     *
     * <p>This extra should be set to android.telephony.VisualVoicemailSmsFilterSettings#packageName
     * while performing filtering. Since the default dialer might change between the filter sending
     * it and telephony binding to the service, this ensures the service will not receive SMS
     * filtered by the previous app.
     *
     * @hide
     */
    public static final String EXTRA_TARGET_PACKAGE = "android.provider.extra.TARGET_PACAKGE";

    Extra included in Intent.ACTION_PROVIDER_CHANGED broadcast intents to indicate if the receiving package made this change. /**
     * Extra included in {@link Intent#ACTION_PROVIDER_CHANGED} broadcast intents to indicate if the
     * receiving package made this change.
     */
    public static final String EXTRA_SELF_CHANGE = "com.android.voicemail.extra.SELF_CHANGE";

    Extra included in ACTION_SYNC_VOICEMAIL broadcast intents to indicate which PhoneAccountHandle to sync. /**
     * Extra included in {@link #ACTION_SYNC_VOICEMAIL} broadcast intents to indicate which {@link
     * PhoneAccountHandle} to sync.
     */
    public static final String EXTRA_PHONE_ACCOUNT_HANDLE =
            "android.provider.extra.PHONE_ACCOUNT_HANDLE";

    Name of the source package field, which must be same across all voicemail related tables.
This is an internal field.
@hide /**
     * Name of the source package field, which must be same across all voicemail related tables.
     * This is an internal field.
     * @hide
     */
    public static final String SOURCE_PACKAGE_FIELD = "source_package";

    Defines fields exposed through the /voicemail path of this content provider. /** Defines fields exposed through the /voicemail path of this content provider. */
    public static final class Voicemails implements BaseColumns, OpenableColumns {
        Not instantiable. /** Not instantiable. */
        private Voicemails() {
        }

        URI to insert/retrieve voicemails. /** URI to insert/retrieve voicemails. */
        public static final Uri CONTENT_URI =
            Uri.parse("content://" + AUTHORITY + "/voicemail");

        The MIME type for a collection of voicemails. /** The MIME type for a collection of voicemails. */
        public static final String DIR_TYPE = "vnd.android.cursor.dir/voicemails";

        The MIME type for a single voicemail. /** The MIME type for a single voicemail. */
        public static final String ITEM_TYPE = "vnd.android.cursor.item/voicemail";

        Phone number of the voicemail sender.
Type: TEXT
/**
         * Phone number of the voicemail sender.
         * <P>Type: TEXT</P>
         */
        public static final String NUMBER = Calls.NUMBER;
        The date the voicemail was sent, in milliseconds since the epoch
Type: INTEGER (long)
/**
         * The date the voicemail was sent, in milliseconds since the epoch
         * <P>Type: INTEGER (long)</P>
         */
        public static final String DATE = Calls.DATE;
        The duration of the voicemail in seconds.
Type: INTEGER (long)
/**
         * The duration of the voicemail in seconds.
         * <P>Type: INTEGER (long)</P>
         */
        public static final String DURATION = Calls.DURATION;
        Whether or not the voicemail has been acknowledged (notification sent to the user).
Type: INTEGER (boolean)
/**
         * Whether or not the voicemail has been acknowledged (notification sent to the user).
         * <P>Type: INTEGER (boolean)</P>
         */
        public static final String NEW = Calls.NEW;
        Whether this item has been read or otherwise consumed by the user.
Type: INTEGER (boolean)
/**
         * Whether this item has been read or otherwise consumed by the user.
         * <P>Type: INTEGER (boolean)</P>
         */
        public static final String IS_READ = Calls.IS_READ;
        The mail box state of the voicemail. This field is currently not used by the system.
 Possible values: STATE_INBOX, STATE_DELETED, STATE_UNDELETED. 
Type: INTEGER
@hide /**
         * The mail box state of the voicemail. This field is currently not used by the system.
         * <P> Possible values: {@link #STATE_INBOX}, {@link #STATE_DELETED},
         * {@link #STATE_UNDELETED}.
         * <P>Type: INTEGER</P>
         * @hide
         */
        public static final String STATE = "state";
        Value of STATE when the voicemail is in inbox. 
@hide /**
         * Value of {@link #STATE} when the voicemail is in inbox.
         * @hide
         */
        public static int STATE_INBOX = 0;
        Value of STATE when the voicemail has been marked as deleted. 
@hide /**
         * Value of {@link #STATE} when the voicemail has been marked as deleted.
         * @hide
         */
        public static int STATE_DELETED = 1;
        Value of STATE when the voicemail has marked as undeleted. 
@hide /**
         * Value of {@link #STATE} when the voicemail has marked as undeleted.
         * @hide
         */
        public static int STATE_UNDELETED = 2;
        Package name of the source application that inserted the voicemail.
Type: TEXT
/**
         * Package name of the source application that inserted the voicemail.
         * <P>Type: TEXT</P>
         */
        public static final String SOURCE_PACKAGE = SOURCE_PACKAGE_FIELD;
        Application-specific data available to the source application that
inserted the voicemail. This is typically used to store the source
specific message id to identify this voicemail on the remote
voicemail server.
Type: TEXT
 Note that this is NOT the voicemail media content data.
/**
         * Application-specific data available to the source application that
         * inserted the voicemail. This is typically used to store the source
         * specific message id to identify this voicemail on the remote
         * voicemail server.
         * <P>Type: TEXT</P>
         * <P> Note that this is NOT the voicemail media content data.
         */
        public static final String SOURCE_DATA = "source_data";
        Whether the media content for this voicemail is available for
consumption.
Type: INTEGER (boolean)
/**
         * Whether the media content for this voicemail is available for
         * consumption.
         * <P>Type: INTEGER (boolean)</P>
         */
        public static final String HAS_CONTENT = "has_content";
        MIME type of the media content for the voicemail.
Type: TEXT
/**
         * MIME type of the media content for the voicemail.
         * <P>Type: TEXT</P>
         */
        public static final String MIME_TYPE = "mime_type";
        The transcription of the voicemail entry. This will only be populated if the voicemail
entry has a valid transcription.
Type: TEXT
/**
         * The transcription of the voicemail entry. This will only be populated if the voicemail
         * entry has a valid transcription.
         * <P>Type: TEXT</P>
         */
        public static final String TRANSCRIPTION = "transcription";
        The state of the voicemail transcription.
 Possible values: TRANSCRIPTION_NOT_STARTED, TRANSCRIPTION_IN_PROGRESS, TRANSCRIPTION_FAILED, TRANSCRIPTION_AVAILABLE. 
Type: INTEGER
@hide /**
         * The state of the voicemail transcription.
         * <P> Possible values: {@link #TRANSCRIPTION_NOT_STARTED},
         * {@link #TRANSCRIPTION_IN_PROGRESS}, {@link #TRANSCRIPTION_FAILED},
         * {@link #TRANSCRIPTION_AVAILABLE}.
         * <P>Type: INTEGER</P>
         * @hide
         */
        public static final String TRANSCRIPTION_STATE = "transcription_state";
        Value of TRANSCRIPTION_STATE when the voicemail transcription has not yet been attempted. 
@hide /**
         * Value of {@link #TRANSCRIPTION_STATE} when the voicemail transcription has not yet
         * been attempted.
         * @hide
         */
        public static final int TRANSCRIPTION_NOT_STARTED = 0;
        Value of TRANSCRIPTION_STATE when the voicemail transcription has begun but is not yet complete. 
@hide /**
         * Value of {@link #TRANSCRIPTION_STATE} when the voicemail transcription has begun
         * but is not yet complete.
         * @hide
         */
        public static final int TRANSCRIPTION_IN_PROGRESS = 1;
        Value of TRANSCRIPTION_STATE when the voicemail transcription has been attempted and failed. 
@hide /**
         * Value of {@link #TRANSCRIPTION_STATE} when the voicemail transcription has
         * been attempted and failed.
         * @hide
         */
        public static final int TRANSCRIPTION_FAILED = 2;
        Value of TRANSCRIPTION_STATE when the voicemail transcription has completed and the result has been stored in the TRANSCRIPTION column. 
@hide /**
         * Value of {@link #TRANSCRIPTION_STATE} when the voicemail transcription has
         * completed and the result has been stored in the {@link #TRANSCRIPTION} column.
         * @hide
         */
        public static final int TRANSCRIPTION_AVAILABLE = 3;
        Path to the media content file. Internal only field.
@hide /**
         * Path to the media content file. Internal only field.
         * @hide
         */
        public static final String _DATA = "_data";

        // Note: PHONE_ACCOUNT_* constant values are "subscription_*" due to a historic naming
        // that was encoded into call log databases.

        The ComponentName of the PhoneAccount in string form. The PhoneAccount of the voicemail is used to differentiate voicemails from different sources. Type: TEXT
/**
         * The {@link ComponentName} of the {@link PhoneAccount} in string form. The
         * {@link PhoneAccount} of the voicemail is used to differentiate voicemails from different
         * sources.
         * <P>Type: TEXT</P>
         */
        public static final String PHONE_ACCOUNT_COMPONENT_NAME = "subscription_component_name";

        The identifier of a PhoneAccount that is unique to a specified ComponentName. The PhoneAccount of the voicemail is used to differentiate voicemails from different sources. Type: TEXT
/**
         * The identifier of a {@link PhoneAccount} that is unique to a specified
         * {@link ComponentName}. The {@link PhoneAccount} of the voicemail is used to differentiate
         * voicemails from different sources.
         * <P>Type: TEXT</P>
         */
        public static final String PHONE_ACCOUNT_ID = "subscription_id";

        Flag used to indicate that local, unsynced changes are present.
Currently, this is used to indicate that the voicemail was read or deleted.
The value will be 1 if dirty is true, 0 if false.
When a caller updates a voicemail row (either with ContentResolver.update or ContentResolver.applyBatch), and if the ContentValues doesn't contain this column, the voicemail provider implicitly sets it to 0 if the calling package is the SOURCE_PACKAGE or to 1 otherwise. To prevent this behavior, explicitly set DIRTY_RETAIN to DIRTY in the ContentValues. 
Type: INTEGER (boolean)
See Also: DIRTY_RETAIN/**
         * Flag used to indicate that local, unsynced changes are present.
         * Currently, this is used to indicate that the voicemail was read or deleted.
         * The value will be 1 if dirty is true, 0 if false.
         *
         * <p>When a caller updates a voicemail row (either with {@link ContentResolver#update} or
         * {@link ContentResolver#applyBatch}), and if the {@link ContentValues} doesn't contain
         * this column, the voicemail provider implicitly sets it to 0 if the calling package is
         * the {@link #SOURCE_PACKAGE} or to 1 otherwise. To prevent this behavior, explicitly set
         * {@link #DIRTY_RETAIN} to DIRTY in the {@link ContentValues}.
         *
         * <P>Type: INTEGER (boolean)</P>
         *
         * @see #DIRTY_RETAIN
         */
        public static final String DIRTY = "dirty";

        Value of DIRTY when updating to indicate that the value should not be updated during this operation. /**
         * Value of {@link #DIRTY} when updating to indicate that the value should not be updated
         * during this operation.
         */
        public static final int DIRTY_RETAIN = -1;

        Flag used to indicate that the voicemail was deleted but not synced to the server.
A deleted row should be ignored.
The value will be 1 if deleted is true, 0 if false.
Type: INTEGER (boolean)
/**
         * Flag used to indicate that the voicemail was deleted but not synced to the server.
         * A deleted row should be ignored.
         * The value will be 1 if deleted is true, 0 if false.
         * <P>Type: INTEGER (boolean)</P>
         */
        public static final String DELETED = "deleted";

        The date the row is last inserted, updated, or marked as deleted, in milliseconds
since the epoch. Read only.
Type: INTEGER (long)
/**
         * The date the row is last inserted, updated, or marked as deleted, in milliseconds
         * since the epoch. Read only.
         * <P>Type: INTEGER (long)</P>
         */
        public static final String LAST_MODIFIED = "last_modified";

        Flag to indicate the voicemail was backed up. The value will be 1 if backed up, 0 if
not.
Type: INTEGER (boolean)
/**
         * Flag to indicate the voicemail was backed up. The value will be 1 if backed up, 0 if
         * not.
         *
         * <P>Type: INTEGER (boolean)</P>
         */
        public static final String BACKED_UP = "backed_up";

        Flag to indicate the voicemail was restored from a backup. The value will be 1 if
restored, 0 if not.
Type: INTEGER (boolean)
/**
         * Flag to indicate the voicemail was restored from a backup. The value will be 1 if
         * restored, 0 if not.
         *
         * <P>Type: INTEGER (boolean)</P>
         */
        public static final String RESTORED = "restored";

        Flag to indicate the voicemail was marked as archived. Archived voicemail should not be
deleted even if it no longer exist on the server. The value will be 1 if archived true, 0
if not.
Type: INTEGER (boolean)
/**
         * Flag to indicate the voicemail was marked as archived. Archived voicemail should not be
         * deleted even if it no longer exist on the server. The value will be 1 if archived true, 0
         * if not.
         *
         * <P>Type: INTEGER (boolean)</P>
         */
        public static final String ARCHIVED = "archived";

        Flag to indicate the voicemail is a OMTP voicemail handled by the VisualVoicemailService. The UI should only show OMTP voicemails from the current visual voicemail package. For example, the selection could be WHERE (IS_OMTP_VOICEMAIL == 0) OR ( IS_OMTP_VOICEMAIL == 1 AND SOURCE_PACKAGE ==
"current.vvm.package") Type: INTEGER (boolean)
See Also: TelephonyManager.getVisualVoicemailPackageName/**
         * Flag to indicate the voicemail is a OMTP voicemail handled by the {@link
         * android.telephony.VisualVoicemailService}. The UI should only show OMTP voicemails from
         * the current visual voicemail package. For example, the selection could be
         * {@code WHERE (IS_OMTP_VOICEMAIL == 0) OR ( IS_OMTP_VOICEMAIL == 1 AND SOURCE_PACKAGE ==
         * "current.vvm.package")}
         *
         * <P>Type: INTEGER (boolean)</P>
         *
         * @see android.telephony.TelephonyManager#getVisualVoicemailPackageName
         */
        public static final String IS_OMTP_VOICEMAIL = "is_omtp_voicemail";

        A convenience method to build voicemail URI specific to a source package by appending VoicemailContract.PARAM_KEY_SOURCE_PACKAGE param to the base URI. /**
         * A convenience method to build voicemail URI specific to a source package by appending
         * {@link VoicemailContract#PARAM_KEY_SOURCE_PACKAGE} param to the base URI.
         */
        public static Uri buildSourceUri(String packageName) {
            return Voicemails.CONTENT_URI.buildUpon()
                    .appendQueryParameter(PARAM_KEY_SOURCE_PACKAGE, packageName)
                    .build();
        }

        Inserts a new voicemail into the voicemail content provider.
Params: context – The context of the app doing the inserting
voicemail – Data to be inserted
Returns: Uri of the newly inserted Voicemail
@hide /**
         * Inserts a new voicemail into the voicemail content provider.
         *
         * @param context The context of the app doing the inserting
         * @param voicemail Data to be inserted
         * @return {@link Uri} of the newly inserted {@link Voicemail}
         *
         * @hide
         */
        public static Uri insert(Context context, Voicemail voicemail) {
            ContentResolver contentResolver = context.getContentResolver();
            ContentValues contentValues = getContentValues(voicemail);
            return contentResolver.insert(buildSourceUri(context.getPackageName()), contentValues);
        }

        Inserts a list of voicemails into the voicemail content provider.
Params: context – The context of the app doing the inserting
voicemails – Data to be inserted
Returns: the number of voicemails inserted
@hide /**
         * Inserts a list of voicemails into the voicemail content provider.
         *
         * @param context The context of the app doing the inserting
         * @param voicemails Data to be inserted
         * @return the number of voicemails inserted
         *
         * @hide
         */
        public static int insert(Context context, List<Voicemail> voicemails) {
            ContentResolver contentResolver = context.getContentResolver();
            int count = voicemails.size();
            for (int i = 0; i < count; i++) {
                ContentValues contentValues = getContentValues(voicemails.get(i));
                contentResolver.insert(buildSourceUri(context.getPackageName()), contentValues);
            }
            return count;
        }

        Clears all voicemails accessible to this voicemail content provider for the calling
package. By default, a package only has permission to delete voicemails it inserted.
Returns: the number of voicemails deleted
@hide /**
         * Clears all voicemails accessible to this voicemail content provider for the calling
         * package. By default, a package only has permission to delete voicemails it inserted.
         *
         * @return the number of voicemails deleted
         *
         * @hide
         */
        public static int deleteAll(Context context) {
            return context.getContentResolver().delete(
                    buildSourceUri(context.getPackageName()), "", new String[0]);
        }

        Maps structured Voicemail to ContentValues in content provider. /**
         * Maps structured {@link Voicemail} to {@link ContentValues} in content provider.
         */
        private static ContentValues getContentValues(Voicemail voicemail) {
            ContentValues contentValues = new ContentValues();
            contentValues.put(Voicemails.DATE, String.valueOf(voicemail.getTimestampMillis()));
            contentValues.put(Voicemails.NUMBER, voicemail.getNumber());
            contentValues.put(Voicemails.DURATION, String.valueOf(voicemail.getDuration()));
            contentValues.put(Voicemails.SOURCE_PACKAGE, voicemail.getSourcePackage());
            contentValues.put(Voicemails.SOURCE_DATA, voicemail.getSourceData());
            contentValues.put(Voicemails.IS_READ, voicemail.isRead() ? 1 : 0);

            PhoneAccountHandle phoneAccount = voicemail.getPhoneAccount();
            if (phoneAccount != null) {
                contentValues.put(Voicemails.PHONE_ACCOUNT_COMPONENT_NAME,
                        phoneAccount.getComponentName().flattenToString());
                contentValues.put(Voicemails.PHONE_ACCOUNT_ID, phoneAccount.getId());
            }

            if (voicemail.getTranscription() != null) {
                contentValues.put(Voicemails.TRANSCRIPTION, voicemail.getTranscription());
            }

            return contentValues;
        }
    }

    Defines fields exposed through the /status path of this content provider. /** Defines fields exposed through the /status path of this content provider. */
    public static final class Status implements BaseColumns {
        URI to insert/retrieve status of voicemail source. /** URI to insert/retrieve status of voicemail source. */
        public static final Uri CONTENT_URI = Uri.parse("content://" + AUTHORITY + "/status");
        The MIME type for a collection of voicemail source statuses. /** The MIME type for a collection of voicemail source statuses. */
        public static final String DIR_TYPE = "vnd.android.cursor.dir/voicemail.source.status";
        The MIME type for a single voicemail source status entry. /** The MIME type for a single voicemail source status entry. */
        public static final String ITEM_TYPE = "vnd.android.cursor.item/voicemail.source.status";

        Not instantiable. /** Not instantiable. */
        private Status() {
        }
        The package name of the voicemail source. There can only be a one entry per account
per source.
Type: TEXT
/**
         * The package name of the voicemail source. There can only be a one entry per account
         * per source.
         * <P>Type: TEXT</P>
         */
        public static final String SOURCE_PACKAGE = SOURCE_PACKAGE_FIELD;

        The type of the source, which determines how to interpret source-specific states. Typically this will be set to the same string as CarrierConfigManager.KEY_VVM_TYPE_STRING. For example, "vvm_type_omtp". Type: TEXT
See Also: CONFIGURATION_STATE
DATA_CHANNEL_STATE
NOTIFICATION_CHANNEL_STATE/**
         * The type of the source, which determines how to interpret source-specific states.
         * Typically this will be set to the same string as
         * {@link android.telephony.CarrierConfigManager#KEY_VVM_TYPE_STRING}. For example,
         * "vvm_type_omtp".
         *
         * <P>Type: TEXT</P>
         *
         * @see #CONFIGURATION_STATE
         * @see #DATA_CHANNEL_STATE
         * @see #NOTIFICATION_CHANNEL_STATE
         */
        public static final String SOURCE_TYPE = "source_type";

        // Note: Multiple entries may exist for a single source if they are differentiated by the
        // PHONE_ACCOUNT_* fields.

        The ComponentName of the PhoneAccount in string form. The PhoneAccount differentiates voicemail sources from the same package. Type: TEXT
/**
         * The {@link ComponentName} of the {@link PhoneAccount} in string form. The
         * {@link PhoneAccount} differentiates voicemail sources from the same package.
         * <P>Type: TEXT</P>
         */
        public static final String PHONE_ACCOUNT_COMPONENT_NAME = "phone_account_component_name";

        The identifier of a PhoneAccount that is unique to a specified component. The PhoneAccount differentiates voicemail sources from the same package. Type: TEXT
/**
         * The identifier of a {@link PhoneAccount} that is unique to a specified component. The
         * {@link PhoneAccount} differentiates voicemail sources from the same package.
         * <P>Type: TEXT</P>
         */
        public static final String PHONE_ACCOUNT_ID = "phone_account_id";

        The URI to call to invoke source specific voicemail settings screen. On a user request
to setup voicemail an intent with action VIEW with this URI will be fired by the system.
Type: TEXT
/**
         * The URI to call to invoke source specific voicemail settings screen. On a user request
         * to setup voicemail an intent with action VIEW with this URI will be fired by the system.
         * <P>Type: TEXT</P>
         */
        public static final String SETTINGS_URI = "settings_uri";
        The URI to call when the user requests to directly access the voicemail from the remote
server. In case of an IVR voicemail system this is typically set to the the voicemail
number specified using a tel:/ URI.
Type: TEXT
/**
         * The URI to call when the user requests to directly access the voicemail from the remote
         * server. In case of an IVR voicemail system this is typically set to the the voicemail
         * number specified using a tel:/ URI.
         * <P>Type: TEXT</P>
         */
        public static final String VOICEMAIL_ACCESS_URI = "voicemail_access_uri";
        The configuration state of the voicemail source.
Negative values are reserved to the source for source-specific states, see SOURCE_TYPE 
 Possible values: CONFIGURATION_STATE_OK, CONFIGURATION_STATE_NOT_CONFIGURED, CONFIGURATION_STATE_CAN_BE_CONFIGURED CONFIGURATION_STATE_CONFIGURING CONFIGURATION_STATE_FAILED CONFIGURATION_STATE_DISABLED 
Type: INTEGER
/**
         * The configuration state of the voicemail source.
         *
         * <P>Negative values are reserved to the source for source-specific states, see
         * {@link #SOURCE_TYPE}
         *
         * <P> Possible values:
         * {@link #CONFIGURATION_STATE_OK},
         * {@link #CONFIGURATION_STATE_NOT_CONFIGURED},
         * {@link #CONFIGURATION_STATE_CAN_BE_CONFIGURED}
         * {@link #CONFIGURATION_STATE_CONFIGURING}
         * {@link #CONFIGURATION_STATE_FAILED}
         * {@link #CONFIGURATION_STATE_DISABLED}
         * <P>Type: INTEGER</P>
         */
        public static final String CONFIGURATION_STATE = "configuration_state";

        Value of CONFIGURATION_STATE to indicate an all OK configuration status. /** Value of {@link #CONFIGURATION_STATE} to indicate an all OK configuration status. */
        public static final int CONFIGURATION_STATE_OK = 0;
        Value of CONFIGURATION_STATE to indicate the visual voicemail is not yet configured on this device. /**
         * Value of {@link #CONFIGURATION_STATE} to indicate the visual voicemail is not
         * yet configured on this device.
         */
        public static final int CONFIGURATION_STATE_NOT_CONFIGURED = 1;
        Value of CONFIGURATION_STATE to indicate the visual voicemail is not yet configured on this device but can be configured by the user.  This state must be used when the source has verified that the current user can be
upgraded to visual voicemail and would like to show a set up invitation message.
/**
         * Value of {@link #CONFIGURATION_STATE} to indicate the visual voicemail is not
         * yet configured on this device but can be configured by the user.
         * <p> This state must be used when the source has verified that the current user can be
         * upgraded to visual voicemail and would like to show a set up invitation message.
         */
        public static final int CONFIGURATION_STATE_CAN_BE_CONFIGURED = 2;
        Value of CONFIGURATION_STATE to indicate that visual voicemail still is being configured. /**
         * Value of {@link #CONFIGURATION_STATE} to indicate that visual voicemail still is being
         * configured.
         */
        public static final int CONFIGURATION_STATE_CONFIGURING = 3;
        Value of CONFIGURATION_STATE to indicate that visual voicemail has failed to be configured. /**
         * Value of {@link #CONFIGURATION_STATE} to indicate that visual voicemail has failed to
         * be configured.
         */
        public static final int CONFIGURATION_STATE_FAILED = 4;
        Value of CONFIGURATION_STATE to indicate that visual voicemail is disabled by the user. /**
         * Value of {@link #CONFIGURATION_STATE} to indicate that visual voicemail is disabled by
         * the user.
         */
        public static final int CONFIGURATION_STATE_DISABLED = 5;
        The data channel state of the voicemail source. This the channel through which the source
pulls voicemail data from a remote server.
Negative values are reserved to the source for source-specific states, see SOURCE_TYPE 
 Possible values: DATA_CHANNEL_STATE_OK, DATA_CHANNEL_STATE_NO_CONNECTION 
Type: INTEGER
/**
         * The data channel state of the voicemail source. This the channel through which the source
         * pulls voicemail data from a remote server.
         *
         * <P>Negative values are reserved to the source for source-specific states, see
         * {@link #SOURCE_TYPE}
         *
         * <P> Possible values:
         * {@link #DATA_CHANNEL_STATE_OK},
         * {@link #DATA_CHANNEL_STATE_NO_CONNECTION}
         * </P>
         * <P>Type: INTEGER</P>
         */
        public static final String DATA_CHANNEL_STATE = "data_channel_state";

         Value of DATA_CHANNEL_STATE to indicate that data channel is working fine. /**
         *  Value of {@link #DATA_CHANNEL_STATE} to indicate that data channel is working fine.
         */
        public static final int DATA_CHANNEL_STATE_OK = 0;
         Value of DATA_CHANNEL_STATE to indicate that data channel failed to find a suitable network to connect to the server. /**
         *  Value of {@link #DATA_CHANNEL_STATE} to indicate that data channel failed to find a
         *  suitable network to connect to the server.
         */
        public static final int DATA_CHANNEL_STATE_NO_CONNECTION = 1;
         Value of DATA_CHANNEL_STATE to indicate that data channel failed to find a suitable network to connect to the server, and the carrier requires using cellular data network to connect to the server. /**
         *  Value of {@link #DATA_CHANNEL_STATE} to indicate that data channel failed to find a
         *  suitable network to connect to the server, and the carrier requires using cellular
         *  data network to connect to the server.
         */
        public static final int DATA_CHANNEL_STATE_NO_CONNECTION_CELLULAR_REQUIRED = 2;
         Value of DATA_CHANNEL_STATE to indicate that data channel received incorrect settings or credentials to connect to the server /**
         *  Value of {@link #DATA_CHANNEL_STATE} to indicate that data channel received incorrect
         *  settings or credentials to connect to the server
         */
        public static final int DATA_CHANNEL_STATE_BAD_CONFIGURATION = 3;
         Value of DATA_CHANNEL_STATE to indicate that a error has occurred in the data channel while communicating with the server /**
         *  Value of {@link #DATA_CHANNEL_STATE} to indicate that a error has occurred in the data
         *  channel while communicating with the server
         */
        public static final int DATA_CHANNEL_STATE_COMMUNICATION_ERROR = 4;
         Value of DATA_CHANNEL_STATE to indicate that the server reported an internal error to the data channel. /**
         *  Value of {@link #DATA_CHANNEL_STATE} to indicate that the server reported an internal
         *  error to the data channel.
         */
        public static final int DATA_CHANNEL_STATE_SERVER_ERROR = 5;
         Value of DATA_CHANNEL_STATE to indicate that while there is a suitable network, the data channel is unable to establish a connection with the server. /**
         *  Value of {@link #DATA_CHANNEL_STATE} to indicate that while there is a suitable network,
         *  the data channel is unable to establish a connection with the server.
         */
        public static final int DATA_CHANNEL_STATE_SERVER_CONNECTION_ERROR = 6;

        The notification channel state of the voicemail source. This is the channel through which
the source gets notified of new voicemails on the remote server.
Negative values are reserved to the source for source-specific states, see SOURCE_TYPE 
 Possible values: NOTIFICATION_CHANNEL_STATE_OK, NOTIFICATION_CHANNEL_STATE_NO_CONNECTION, NOTIFICATION_CHANNEL_STATE_MESSAGE_WAITING 
Type: INTEGER
/**
         * The notification channel state of the voicemail source. This is the channel through which
         * the source gets notified of new voicemails on the remote server.
         *
         * <P>Negative values are reserved to the source for source-specific states, see
         * {@link #SOURCE_TYPE}
         *
         * <P> Possible values:
         * {@link #NOTIFICATION_CHANNEL_STATE_OK},
         * {@link #NOTIFICATION_CHANNEL_STATE_NO_CONNECTION},
         * {@link #NOTIFICATION_CHANNEL_STATE_MESSAGE_WAITING}
         * </P>
         * <P>Type: INTEGER</P>
         */
        public static final String NOTIFICATION_CHANNEL_STATE = "notification_channel_state";

        Value of NOTIFICATION_CHANNEL_STATE to indicate that the notification channel is working fine. /**
         * Value of {@link #NOTIFICATION_CHANNEL_STATE} to indicate that the notification channel is
         * working fine.
         */
        public static final int NOTIFICATION_CHANNEL_STATE_OK = 0;
        Value of NOTIFICATION_CHANNEL_STATE to indicate that the notification channel connection is not working. /**
         * Value of {@link #NOTIFICATION_CHANNEL_STATE} to indicate that the notification channel
         * connection is not working.
         */
        public static final int NOTIFICATION_CHANNEL_STATE_NO_CONNECTION = 1;
        Value of NOTIFICATION_CHANNEL_STATE to indicate that there are messages waiting on the server but the details are not known.  Use this state when the notification can only tell that there are pending messages on
the server but no details of the sender/time etc are known.
/**
         * Value of {@link #NOTIFICATION_CHANNEL_STATE} to indicate that there are messages waiting
         * on the server but the details are not known.
         * <p> Use this state when the notification can only tell that there are pending messages on
         * the server but no details of the sender/time etc are known.
         */
        public static final int NOTIFICATION_CHANNEL_STATE_MESSAGE_WAITING = 2;

        Amount of resource that is used by existing voicemail in the visual voicemail inbox, or QUOTA_UNAVAILABLE if the quota has never been updated before. This value is used to inform the client the situation on the remote server. Unit is not specified. Type: INTEGER
/**
         * Amount of resource that is used by existing voicemail in the visual voicemail inbox,
         * or {@link #QUOTA_UNAVAILABLE} if the quota has never been updated before. This value is
         * used to inform the client the situation on the remote server. Unit is not specified.
         * <P>Type: INTEGER</P>
         */
        public static final String QUOTA_OCCUPIED = "quota_occupied";

        Total resource in the visual voicemail inbox that can be used, or QUOTA_UNAVAILABLE if server either has unlimited quota or does not provide quota information. This value is used to inform the client the situation on the remote server. Unit is not specified. Type: INTEGER
/**
         * Total resource in the visual voicemail inbox that can be used, or
         * {@link #QUOTA_UNAVAILABLE} if server either has unlimited quota or does not provide quota
         * information. This value is used to inform the client the situation on the remote server.
         * Unit is not specified.
         * <P>Type: INTEGER</P>
         */
        public static final String QUOTA_TOTAL = "quota_total";

        Value for QUOTA_OCCUPIED and QUOTA_TOTAL to indicate that no information is available. /**
         * Value for {@link #QUOTA_OCCUPIED} and {@link #QUOTA_TOTAL} to indicate that no
         * information is available.
         */
        public static final int QUOTA_UNAVAILABLE = -1;

        A convenience method to build status URI specific to a source package by appending VoicemailContract.PARAM_KEY_SOURCE_PACKAGE param to the base URI. /**
         * A convenience method to build status URI specific to a source package by appending
         * {@link VoicemailContract#PARAM_KEY_SOURCE_PACKAGE} param to the base URI.
         */
        public static Uri buildSourceUri(String packageName) {
            return Status.CONTENT_URI.buildUpon()
                    .appendQueryParameter(PARAM_KEY_SOURCE_PACKAGE, packageName).build();
        }
    }
}
Params:	context – The context of the app doing the inserting voicemail – Data to be inserted
Returns:	`Uri` of the newly inserted `Voicemail`
@hide
/

android/ android-9.0.0_r35/ android/provider/VoicemailContract.java
