BlockedNumberContract Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Der Vertrag zwischen dem anbieter blockednumber und den Anwendungen.
[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
- Attribute
Hinweise
Der Vertrag zwischen dem anbieter blockednumber und den 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 mithilfe von android.database.ContentObserver
empfangen werden.
Die Plattform blockiert keine Nachrichten und Anrufe von Notrufnummern, wie durch android.telephony.PhoneNumberUtils#isEmergencyNumber(String)
definiert. Wenn sich der Benutzer an den Notdienst wendet, wird die Nummernblockierung von der Plattform für einen durch definierten android.telephony.CarrierConfigManager#KEY_DURATION_BLOCKING_DISABLED_AFTER_EMERGENCY_INT
Zeitraum 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 den anbieter blockednumber lesen und schreiben. Auf #canCurrentUserBlockNumbers(Context)
kann jedoch von jeder Anwendung zugegriffen werden.
<h3> Data </h3>
Abgesehen von regulären Telefonnummern kann der Anbieter für blockierte Nummern auch Adressen (z. B. E-Mails) 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 eine Normalisierung möglich ist) wird in der BlockedNumbers#COLUMN_E164_NUMBER
Spalte gespeichert. Die Plattform blockiert Aufrufe und Nachrichten von einer Adresse, wenn sie in der BlockedNumbers#COLUMN_ORIGINAL_NUMBER
Spalte vorhanden ist oder wenn die E164-Version der Adresse mit der BlockedNumbers#COLUMN_E164_NUMBER
Spalte übereinstimmt.
<h3-Vorgänge></h3<>dl><dt><b>Insert</b></dt><dd>
BlockedNumbers#COLUMN_ORIGINAL_NUMBER
ist eine erforderliche Spalte, die aufgefüllt werden muss. Apps können optional die BlockedNumbers#COLUMN_E164_NUMBER
E164-Darstellung der Telefonnummer bereitstellen. Der Anbieter füllt diese Spalte automatisch auf, wenn die App sie nicht bereitstellt. Beachten Sie, dass diese Spalte nicht aufgefüllt wird, wenn die Normalisierung fehlschlägt oder wenn die Adresse keine Telefonnummer ist (z. B. E-Mail).
Der Versuch, eine vorhandene blockierte Nummer (dieselbe BlockedNumbers#COLUMN_ORIGINAL_NUMBER
Spalte) einzufügen, führt dazu, dass die vorhandene blockierte Nummer ersetzt wird.
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 Delete und Insert.
</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);
Um zu überprüfen, ob eine bestimmte Zahl blockiert ist, verwenden Sie die -Methode #isBlocked(Context, String)
. </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 ein Vorgang für den blockierten Nummernanbieter ausgeführt wird. Wenn #canCurrentUserBlockNumbers(Context)
zurückgibt false
, schlagen alle Vorgänge für den Anbieter mit einem fehl SecurityException
. 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, die auf Arbeiten basieren, die vom Android Open Source Project erstellt und freigegeben wurden und gemäß den In Attribution License beschriebenen Begriffen verwendet werden.
Konstruktoren
BlockedNumberContract(IntPtr, JniHandleOwnership) |
Der Vertrag zwischen dem anbieter blockednumber und den Anwendungen. |
Felder
Authority |
Die Autorität für den blockierten Nummernanbieter |
Eigenschaften
AuthorityUri |
Ein content:// Stil-URI für die Autorität für den blockierten Nummernanbieter |
Class |
Gibt die Laufzeitklasse dieses |
Handle |
Das Handle für die zugrunde liegende Android-instance. (Geerbt von Object) |
JniIdentityHashCode |
Der Vertrag zwischen dem anbieter blockednumber und den Anwendungen. (Geerbt von Object) |
JniPeerMembers |
Der Vertrag zwischen dem anbieter blockednumber und den Anwendungen. |
PeerReference |
Der Vertrag zwischen dem anbieter blockednumber und den Anwendungen. (Geerbt von Object) |
ThresholdClass |
Der Vertrag zwischen dem anbieter blockednumber und den Anwendungen. |
ThresholdType |
Der Vertrag zwischen dem anbieter blockednumber und den Anwendungen. |
Methoden
CanCurrentUserBlockNumbers(Context) |
Überprüft, ob das Blockieren von Nummern für den aktuellen Benutzer unterstützt wird. |
Clone() |
Erstellt und gibt eine Kopie dieses Objekts zurück. (Geerbt von Object) |
Dispose() |
Der Vertrag zwischen dem anbieter blockednumber und den Anwendungen. (Geerbt von Object) |
Dispose(Boolean) |
Der Vertrag zwischen dem anbieter blockednumber und den Anwendungen. (Geerbt von Object) |
Equals(Object) |
Gibt an, ob ein anderes Objekt "gleich" diesem objekt ist. (Geerbt von Object) |
GetHashCode() |
Gibt einen Hashcodewert für das Objekt zurück. (Geerbt von Object) |
IsBlocked(Context, String) |
Gibt zurück, ob eine angegebene Zahl in der Sperrliste enthalten ist. |
JavaFinalize() |
Wird vom Garbage Collector für ein Objekt aufgerufen, wenn die Garbage Collection feststellt, dass keine Verweise mehr auf das Objekt vorhanden sind. (Geerbt von Object) |
Notify() |
Aktiviert einen einzelnen Thread, der auf den Monitor dieses Objekts wartet. (Geerbt von Object) |
NotifyAll() |
Aktiviert alle Threads, die auf den Monitor dieses Objekts warten. (Geerbt von Object) |
SetHandle(IntPtr, JniHandleOwnership) |
Legt die Handle-Eigenschaft fest. (Geerbt von Object) |
ToArray<T>() |
Der Vertrag zwischen dem anbieter blockednumber und den Anwendungen. (Geerbt von Object) |
ToString() |
Gibt eine Zeichenfolgendarstellung des Objekts zurück. (Geerbt von Object) |
Unblock(Context, String) |
Hebt die Blockierung auf |
UnregisterFromRuntime() |
Der Vertrag zwischen dem anbieter blockednumber und den Anwendungen. (Geerbt von Object) |
Wait() |
Bewirkt, dass der aktuelle Thread wartet, bis er aktiviert ist, in der Regel durch <>Benachrichtigung</em> oder <em>interrupted</em>. (Geerbt von Object) |
Wait(Int64) |
Bewirkt, dass der aktuelle Thread wartet, bis er aktiviert ist, in der Regel durch>< Benachrichtigung</em> oder <em>interrupted</em>, oder bis eine bestimmte Menge an Echtzeit verstrichen ist. (Geerbt von Object) |
Wait(Int64, Int32) |
Bewirkt, dass der aktuelle Thread wartet, bis er aktiviert ist, in der Regel durch>< Benachrichtigung</em> oder <em>interrupted</em>, oder bis eine bestimmte Menge an Echtzeit verstrichen ist. (Geerbt von Object) |
Explizite Schnittstellenimplementierungen
IJavaPeerable.Disposed() |
Der Vertrag zwischen dem anbieter blockednumber und den Anwendungen. (Geerbt von Object) |
IJavaPeerable.DisposeUnlessReferenced() |
Der Vertrag zwischen dem anbieter blockednumber und den Anwendungen. (Geerbt von Object) |
IJavaPeerable.Finalized() |
Der Vertrag zwischen dem anbieter blockednumber und den Anwendungen. (Geerbt von Object) |
IJavaPeerable.JniManagedPeerState |
Der Vertrag zwischen dem anbieter blockednumber und den Anwendungen. (Geerbt von Object) |
IJavaPeerable.SetJniIdentityHashCode(Int32) |
Der Vertrag zwischen dem anbieter blockednumber und den Anwendungen. (Geerbt von Object) |
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
Der Vertrag zwischen dem anbieter blockednumber und den Anwendungen. (Geerbt von Object) |
IJavaPeerable.SetPeerReference(JniObjectReference) |
Der Vertrag zwischen dem anbieter blockednumber und den Anwendungen. (Geerbt von Object) |
Erweiterungsmethoden
JavaCast<TResult>(IJavaObject) |
Führt eine Typkonvertierung mit Überprüfung der Android-Laufzeit aus. |
JavaCast<TResult>(IJavaObject) |
Der Vertrag zwischen dem anbieter blockednumber und den Anwendungen. |
GetJniTypeName(IJavaPeerable) |
Der Vertrag zwischen dem anbieter blockednumber und den Anwendungen. |