BlockedNumberContract Clase

Definición

[Android.Runtime.Register("android/provider/BlockedNumberContract", ApiSince=24, DoNotGenerateAcw=true)]
public class BlockedNumberContract : Java.Lang.Object

[<Android.Runtime.Register("android/provider/BlockedNumberContract", ApiSince=24, DoNotGenerateAcw=true)>]
type BlockedNumberContract = class
    inherit Object

Herencia

Object

JavaObject

Object

BlockedNumberContract

Atributos

RegisterAttribute

Comentarios

Contrato entre el proveedor de número bloqueado y las aplicaciones. Contiene definiciones para los URI y columnas admitidos.

<h3> Información general </h3>

El proveedor de contenido expone una tabla que contiene números bloqueados. Las columnas y los URI para acceder a esta tabla se definen mediante la BlockedNumbers clase . La plataforma descarta los mensajes y las llamadas de números bloqueados. Las notificaciones tras los cambios del proveedor se pueden recibir mediante .android.database.ContentObserver

La plataforma no bloqueará los mensajes y las llamadas de números de emergencia, tal como se define en android.telephony.PhoneNumberUtils#isEmergencyNumber(String). Si el usuario se pone en contacto con los servicios de emergencia, la plataforma deshabilita el bloqueo de números durante una duración definida por android.telephony.CarrierConfigManager#KEY_DURATION_BLOCKING_DISABLED_AFTER_EMERGENCY_INT.

<h3> Permisos </h3>

Solo el sistema, la aplicación SMS predeterminada y la aplicación de teléfono predeterminada (consulte android.telecom.TelecomManager#getDefaultDialerPackage()) y las aplicaciones de operador (consulte android.service.carrier.CarrierService) pueden leer y escribir en el proveedor de números bloqueados. Sin embargo, #canCurrentUserBlockNumbers(Context) cualquier aplicación puede acceder a ella.

<h3> Data </h3>

Aparte de los números de teléfono normales, el proveedor de números bloqueados también puede almacenar direcciones (por ejemplo, correo electrónico) desde las que un usuario puede recibir mensajes y llamadas. Los números bloqueados se almacenan en la BlockedNumbers#COLUMN_ORIGINAL_NUMBER columna. Una versión normalizada de números de teléfono (si es posible la normalización) se almacena en BlockedNumbers#COLUMN_E164_NUMBER la columna . La plataforma bloquea las llamadas y los mensajes de una dirección si están presentes en la BlockedNumbers#COLUMN_ORIGINAL_NUMBER columna o si la versión E164 de la dirección coincide con la BlockedNumbers#COLUMN_E164_NUMBER columna.

<h3> Operations </h3><dl><dt><b>Insert</b></dt><dd>

BlockedNumbers#COLUMN_ORIGINAL_NUMBER es una columna necesaria que debe rellenarse. Las aplicaciones pueden proporcionar opcionalmente el BlockedNumbers#COLUMN_E164_NUMBER que es la representación E164 del número de teléfono. El proveedor rellena automáticamente esta columna si la aplicación no la proporciona. Tenga en cuenta que esta columna no se rellena si se produce un error en la normalización o si la dirección no es un número de teléfono (por ejemplo, correo electrónico).

Si se intenta insertar un número bloqueado existente (misma BlockedNumbers#COLUMN_ORIGINAL_NUMBER columna), se reemplazará el número bloqueado existente.

Ejemplos:

ContentValues values = new ContentValues();
            values.put(BlockedNumbers.COLUMN_ORIGINAL_NUMBER, "1234567890");
            Uri uri = getContentResolver().insert(BlockedNumbers.CONTENT_URI, values);

ContentValues values = new ContentValues();
            values.put(BlockedNumbers.COLUMN_ORIGINAL_NUMBER, "1234567890");
            values.put(BlockedNumbers.COLUMN_E164_NUMBER, "+11234567890");
            Uri uri = getContentResolver().insert(BlockedNumbers.CONTENT_URI, values);

ContentValues values = new ContentValues();
            values.put(BlockedNumbers.COLUMN_ORIGINAL_NUMBER, "12345@abdcde.com");
            Uri uri = getContentResolver().insert(BlockedNumbers.CONTENT_URI, values);

</p></dd><dt><b>Update</b></dt><dd>

No se admiten actualizaciones. Use Delete e Insert en su lugar.

</dd><dt><b>Delete</b></dt><dd>

Las eliminaciones se pueden realizar de la siguiente manera:

ContentValues values = new ContentValues();
            values.put(BlockedNumbers.COLUMN_ORIGINAL_NUMBER, "1234567890");
            Uri uri = getContentResolver().insert(BlockedNumbers.CONTENT_URI, values);
            getContentResolver().delete(uri, null, null);

Para comprobar si un número determinado está bloqueado, use el método #isBlocked(Context, String). </p></dd><dt><b>Query</b></dt><dd>

Todos los números bloqueados se pueden enumerar de la siguiente manera:

Cursor c = getContentResolver().query(BlockedNumbers.CONTENT_URI,
                     new String[]{BlockedNumbers.COLUMN_ID, BlockedNumbers.COLUMN_ORIGINAL_NUMBER,
                     BlockedNumbers.COLUMN_E164_NUMBER}, null, null, null);

</p></dd><dt><b>Unblock</b></dt><dd>

Use el método #unblock(Context, String) para desbloquear números.

</Dd>

<h3> Multi-user </h3>

Las aplicaciones deben usar el método #canCurrentUserBlockNumbers(Context) antes de realizar cualquier operación en el proveedor de números bloqueados. Si #canCurrentUserBlockNumbers(Context) devuelve false, se producirá un error en todas las operaciones del proveedor con .SecurityException La plataforma bloqueará las llamadas y los mensajes de los números del proveedor independientemente del usuario actual.

Java documentación para android.provider.BlockedNumberContract.

Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el Android y se usan según los términos descritos en creative Creative Commons 2.5 Attribution License.