BlockedNumberContract Classe

Definizione

[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

Ereditarietà

Object

JavaObject

Object

BlockedNumberContract

Attributi

RegisterAttribute

Commenti

Contratto tra il provider blockednumber e le applicazioni. Contiene definizioni per gli URI e le colonne supportati.

<h3 Panoramica >/h3<>

Il provider di contenuto espone una tabella contenente numeri bloccati. Le colonne e gli URI per l'accesso a questa tabella sono definiti dalla BlockedNumbers classe . I messaggi e le chiamate dai numeri bloccati vengono ignorati dalla piattaforma. Le notifiche relative alle modifiche del provider possono essere ricevute usando un oggetto android.database.ContentObserver.

La piattaforma non bloccherà i messaggi e le chiamate dai numeri di emergenza, come definito da android.telephony.PhoneNumberUtils#isEmergencyNumber(String). Se l'utente contatta i servizi di emergenza, il blocco dei numeri viene disabilitato dalla piattaforma per una durata definita da android.telephony.CarrierConfigManager#KEY_DURATION_BLOCKING_DISABLED_AFTER_EMERGENCY_INT.

<h3> Autorizzazioni </h3>

Solo il sistema, l'applicazione SMS predefinita e l'app per telefoni predefinita (vedere android.telecom.TelecomManager#getDefaultDialerPackage()) e le app del gestore telefonico (vedere android.service.carrier.CarrierService) possono leggere e scrivere nel provider blockednumber. È tuttavia #canCurrentUserBlockNumbers(Context) possibile accedere a qualsiasi applicazione.

<h3> Data </h3>

Oltre ai normali numeri di telefono, il provider di numeri bloccati può anche archiviare gli indirizzi (ad esempio e-mail) da cui un utente può ricevere messaggi e chiamate. I numeri bloccati vengono archiviati nella BlockedNumbers#COLUMN_ORIGINAL_NUMBER colonna . Una versione normalizzata dei numeri di telefono ,se possibile, viene archiviata nella BlockedNumbers#COLUMN_E164_NUMBER colonna . La piattaforma blocca le chiamate e i messaggi provenienti da un indirizzo se presente nella BlockedNumbers#COLUMN_ORIGINAL_NUMBER colonna o se la versione E164 dell'indirizzo corrisponde alla BlockedNumbers#COLUMN_E164_NUMBER colonna.

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

BlockedNumbers#COLUMN_ORIGINAL_NUMBER è una colonna obbligatoria che deve essere popolata. Le app possono facoltativamente fornire la BlockedNumbers#COLUMN_E164_NUMBER rappresentazione E164 del numero di telefono. Il provider popola automaticamente questa colonna se l'app non la fornisce. Si noti che questa colonna non viene popolata se la normalizzazione ha esito negativo o se l'indirizzo non è un numero di telefono (ad esempio: posta elettronica).

Il tentativo di inserire un numero bloccato esistente (stessa BlockedNumbers#COLUMN_ORIGINAL_NUMBER colonna) comporterà la sostituzione del numero bloccato esistente.

Esempi:

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 dt><dd>

Gli aggiornamenti non sono supportati. In alternativa, usare Elimina e Inserisci.

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

Le eliminazioni possono essere eseguite nel modo seguente:

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

Per verificare se un determinato numero è bloccato, usare il metodo #isBlocked(Context, String). </p></dd><dt><b>Query</b></dt dd><>

Tutti i numeri bloccati possono essere enumerati come segue:

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><>

Usare il metodo #unblock(Context, String) per sbloccare i numeri.

</Dd>

<h3> Multiutente </h3>

Le app devono usare il metodo #canCurrentUserBlockNumbers(Context) prima di eseguire qualsiasi operazione sul provider di numeri bloccati. Se #canCurrentUserBlockNumbers(Context) restituisce false, tutte le operazioni sul provider avranno esito negativo con .SecurityException La piattaforma bloccherà le chiamate e i messaggi provenienti dai numeri nel provider indipendentemente dall'utente corrente.

per android.provider.BlockedNumberContract.

Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dalla e usati in base ai termini descritti in Creative License 2.5 Attribution License.