BlockedNumberContract Klasse

Definition

[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

Vererbung

Object

JavaObject

Object

BlockedNumberContract

Attribute

RegisterAttribute

Hinweise

Der Vertrag zwischen dem Anbieter für blockierte Zahlen und Anwendungen. Enthält Definitionen für die unterstützten URIs und Spalten.

<h3> Übersicht </h3>

Der Inhaltsanbieter macht eine Tabelle verfügbar, die blockierte Zahlen enthält. Die Spalten und URIs für den Zugriff auf diese Tabelle werden von der BlockedNumbers Klasse definiert. Nachrichten und Anrufe von blockierten Nummern werden von der Plattform verworfen. Benachrichtigungen über Anbieteränderungen können mit einer android.database.ContentObserver.

Die Plattform blockiert keine Nachrichten und Anrufe von Notrufnummern wie definiert.android.telephony.PhoneNumberUtils#isEmergencyNumber(String) Wenn der Benutzer Notrufdienste kontaktiert, wird die Nummernsperre für eine von der Plattform definierte android.telephony.CarrierConfigManager#KEY_DURATION_BLOCKING_DISABLED_AFTER_EMERGENCY_INTDauer deaktiviert.

<h3-Berechtigungen></h3>

Nur das System, die Standard-SMS-Anwendung und die Standard-Telefon-App (Siehe android.telecom.TelecomManager#getDefaultDialerPackage()) und Netzbetreiber-Apps (Siehe android.service.carrier.CarrierService) können lesen und in den Anbieter blockierter Zahlen schreiben. #canCurrentUserBlockNumbers(Context) Auf die Anwendung kann jedoch zugegriffen werden.

<h3> Data </h3>

Abgesehen von normalen Telefonnummern kann der Anbieter blockierter Nummern auch Adressen (z. B. E-Mail) speichern, von denen ein Benutzer Nachrichten und Anrufe empfangen kann. Die blockierten Nummern werden in der BlockedNumbers#COLUMN_ORIGINAL_NUMBER Spalte gespeichert. Eine normalisierte Version von Telefonnummern (sofern die Normalisierung möglich ist) wird in BlockedNumbers#COLUMN_E164_NUMBER Spalte gespeichert. Die Plattform blockiert Anrufe und Nachrichten von einer Adresse, wenn sie in der BlockedNumbers#COLUMN_ORIGINAL_NUMBER Spalte vorhanden ist oder die E164-Version der Adresse mit der BlockedNumbers#COLUMN_E164_NUMBER Spalte übereinstimmt.

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

BlockedNumbers#COLUMN_ORIGINAL_NUMBER ist eine erforderliche Spalte, die ausgefüllt werden muss. Apps können optional die BlockedNumbers#COLUMN_E164_NUMBER E164-Darstellung der Telefonnummer angeben. Der Anbieter füllt diese Spalte automatisch auf, wenn die App sie nicht bereitstellt. Beachten Sie, dass diese Spalte nicht ausgefüllt wird, wenn die Normalisierung fehlschlägt oder wenn die Adresse keine Telefonnummer ist (z. B. E-Mail).

Wenn Sie versuchen, eine vorhandene blockierte Zahl (dieselbe BlockedNumbers#COLUMN_ORIGINAL_NUMBER Spalte) einzufügen, wird die vorhandene blockierte Nummer ersetzt.

Beispiele:

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>

Updates werden nicht unterstützt. Verwenden Sie stattdessen "Löschen" und "Einfügen".

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

Löschungen können wie folgt ausgeführt werden:

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

Verwenden Sie die Methode #isBlocked(Context, String), um zu überprüfen, ob eine bestimmte Zahl blockiert ist. </p></dd><dt><b>Query</b></dt><dd>

Alle blockierten Nummern können wie folgt aufgelistet werden:

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>

Verwenden Sie die Methode #unblock(Context, String) , um die Blockierung von Zahlen aufzuheben.

</dd>

<h3> Multi-User </h3>

Apps müssen die Methode #canCurrentUserBlockNumbers(Context) verwenden, bevor Sie einen Vorgang für den Anbieter blockierter Nummern ausführen. Wenn #canCurrentUserBlockNumbers(Context) zurückgegeben falsewird, treten alle Vorgänge des Anbieters mit einem SecurityExceptionFehler auf. Die Plattform blockiert Anrufe und Nachrichten von Nummern im Anbieter unabhängig vom aktuellen Benutzer.

Java Dokumentation für android.provider.BlockedNumberContract.

Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die von der Android Open Source Project erstellt und gemeinsam verwendet und gemäß den in der 2.5 Attribution License beschriebenen Begriffen verwendet werden.