BlockedNumberContract クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
blockednumber プロバイダーとアプリケーションの間のコントラクト。
[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
- 継承
- 属性
注釈
blockednumber プロバイダーとアプリケーションの間のコントラクト。 サポートされている URI と列の定義が含まれています。
<h3> 概要 </h3>
コンテンツ プロバイダーは、ブロックされた番号を含むテーブルを公開します。 このテーブルにアクセスするための列と URI は、 クラスによって BlockedNumbers
定義されます。 メッセージとブロックされた番号からの呼び出しは、プラットフォームによって破棄されます。 プロバイダーの変更に関する通知は、 android.database.ContentObserver
を使用して受信できます。
プラットフォームはメッセージをブロックせず、 で android.telephony.PhoneNumberUtils#isEmergencyNumber(String)
定義されている緊急電話番号からの呼び出しも行いません。 ユーザーが緊急サービスに連絡した場合、 で定義 android.telephony.CarrierConfigManager#KEY_DURATION_BLOCKING_DISABLED_AFTER_EMERGENCY_INT
されている期間、プラットフォームによって番号ブロックが無効になります。
<h3> Permissions </h3>
ブロック番号プロバイダーに対して読み取りと書き込みを行うことができるのは、システム、既定の SMS アプリケーション、および既定の電話アプリ (「」を参照 android.telecom.TelecomManager#getDefaultDialerPackage()
)、および通信事業者アプリ (「」を参照 android.service.carrier.CarrierService
) のみです。 ただし、 #canCurrentUserBlockNumbers(Context)
任意のアプリケーションからアクセスできます。
<h3> データ </h3>
通常の電話番号以外に、ブロックされた番号プロバイダーは、ユーザーがメッセージや通話を受信できるアドレス (電子メールなど) を格納することもできます。 ブロックされた番号は列に BlockedNumbers#COLUMN_ORIGINAL_NUMBER
格納されます。 正規化されたバージョンの電話番号 (正規化が可能な場合) が列に BlockedNumbers#COLUMN_E164_NUMBER
格納されます。 プラットフォームは、 列に存在 BlockedNumbers#COLUMN_ORIGINAL_NUMBER
する場合、または E164 バージョンのアドレスが列と一致する場合は、呼び出しとアドレスからのメッセージを BlockedNumbers#COLUMN_E164_NUMBER
ブロックします。
<h3> 操作 </h3><dl><dt><b>Insert</b></dt><dd>
BlockedNumbers#COLUMN_ORIGINAL_NUMBER
は、入力する必要がある必須の列です。 アプリは、必要に応じて、電話番号の E164 表現である を提供 BlockedNumbers#COLUMN_E164_NUMBER
できます。 この列は、アプリによって提供されない場合、プロバイダーによって自動的に設定されます。 正規化が失敗した場合、またはアドレスが電話番号 (例: 電子メール) ではない場合、この列は設定されないことに注意してください。
既存のブロック番号 (同じ BlockedNumbers#COLUMN_ORIGINAL_NUMBER
列) を挿入しようとすると、既存のブロック番号が置き換えられます。
例 :
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<>
更新はサポートされていません。 代わりに Delete と Insert を使用します。
</dd>dt b Delete/b></dt><dd<>><<>
削除は次のように実行できます。
ContentValues values = new ContentValues();
values.put(BlockedNumbers.COLUMN_ORIGINAL_NUMBER, "1234567890");
Uri uri = getContentResolver().insert(BlockedNumbers.CONTENT_URI, values);
getContentResolver().delete(uri, null, null);
特定の数値がブロックされているかどうかをチェックするには、 メソッド #isBlocked(Context, String)
を使用します。 </p>/dd dt><><b>Query</b></dt><dd<>
ブロックされているすべての番号は、次のように列挙できます。
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>ブロック解除</b></dt<>dd<>
数値のブロックを解除するには、 メソッド #unblock(Context, String)
を使用します。
</Dd>
<h3> マルチユーザー </h3>
アプリは、ブロックされた番号プロバイダーに対して操作を実行する前に、 メソッド #canCurrentUserBlockNumbers(Context)
を使用する必要があります。 が を返すfalse
場合#canCurrentUserBlockNumbers(Context)
、プロバイダーに対するすべての操作は でSecurityException
失敗します。 プラットフォームは、現在のユーザーとは関係なく、プロバイダー内の番号からの呼び出しとメッセージをブロックします。
の Java ドキュメント android.provider.BlockedNumberContract
。
このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。
コンストラクター
BlockedNumberContract(IntPtr, JniHandleOwnership) |
blockednumber プロバイダーとアプリケーションの間のコントラクト。 |
フィールド
Authority |
ブロックされた番号プロバイダーの権限 |
プロパティ
AuthorityUri |
ブロックされた番号プロバイダーの権限に対する content:// スタイル URI |
Class |
この |
Handle |
基になる Android インスタンスへのハンドル。 (継承元 Object) |
JniIdentityHashCode |
blockednumber プロバイダーとアプリケーションの間のコントラクト。 (継承元 Object) |
JniPeerMembers |
blockednumber プロバイダーとアプリケーションの間のコントラクト。 |
PeerReference |
blockednumber プロバイダーとアプリケーションの間のコントラクト。 (継承元 Object) |
ThresholdClass |
blockednumber プロバイダーとアプリケーションの間のコントラクト。 |
ThresholdType |
blockednumber プロバイダーとアプリケーションの間のコントラクト。 |
メソッド
CanCurrentUserBlockNumbers(Context) |
現在のユーザーに対してブロック番号がサポートされているかどうかを確認します。 |
Clone() |
このオブジェクトのコピーを作成して返します。 (継承元 Object) |
Dispose() |
blockednumber プロバイダーとアプリケーションの間のコントラクト。 (継承元 Object) |
Dispose(Boolean) |
blockednumber プロバイダーとアプリケーションの間のコントラクト。 (継承元 Object) |
Equals(Object) |
他のオブジェクトがこのオブジェクトと "等しい" かどうかを示します。 (継承元 Object) |
GetHashCode() |
オブジェクトのハッシュ コード値を返します。 (継承元 Object) |
IsBlocked(Context, String) |
指定した数値がブロックリストに含まれているかどうかを返します。 |
JavaFinalize() |
ガベージ コレクションがオブジェクトへの参照がなくなったと判断したときに、オブジェクトのガベージ コレクターによって呼び出されます。 (継承元 Object) |
Notify() |
このオブジェクトのモニターで待機している 1 つのスレッドをウェイクアップします。 (継承元 Object) |
NotifyAll() |
このオブジェクトのモニターで待機しているすべてのスレッドをウェイクアップします。 (継承元 Object) |
SetHandle(IntPtr, JniHandleOwnership) |
Handle プロパティを設定します。 (継承元 Object) |
ToArray<T>() |
blockednumber プロバイダーとアプリケーションの間のコントラクト。 (継承元 Object) |
ToString() |
オブジェクトの文字列形式を返します。 (継承元 Object) |
Unblock(Context, String) |
ブロックされている場合は、 のブロックを |
UnregisterFromRuntime() |
blockednumber プロバイダーとアプリケーションの間のコントラクト。 (継承元 Object) |
Wait() |
現在のスレッドが起動するまで待機します。通常<>は、通知</em> または <em>割り込み</em によって待機します>。 (継承元 Object) |
Wait(Int64) |
現在のスレッドが起動するまで待機します。通常<>は、通知</em> または>< em 割り込み</em>、または一定のリアルタイムが経過するまで待機します。 (継承元 Object) |
Wait(Int64, Int32) |
現在のスレッドが起動するまで待機します。通常<>は、通知</em> または>< em 割り込み</em>、または一定のリアルタイムが経過するまで待機します。 (継承元 Object) |
明示的なインターフェイスの実装
IJavaPeerable.Disposed() |
blockednumber プロバイダーとアプリケーションの間のコントラクト。 (継承元 Object) |
IJavaPeerable.DisposeUnlessReferenced() |
blockednumber プロバイダーとアプリケーションの間のコントラクト。 (継承元 Object) |
IJavaPeerable.Finalized() |
blockednumber プロバイダーとアプリケーションの間のコントラクト。 (継承元 Object) |
IJavaPeerable.JniManagedPeerState |
blockednumber プロバイダーとアプリケーションの間のコントラクト。 (継承元 Object) |
IJavaPeerable.SetJniIdentityHashCode(Int32) |
blockednumber プロバイダーとアプリケーションの間のコントラクト。 (継承元 Object) |
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
blockednumber プロバイダーとアプリケーションの間のコントラクト。 (継承元 Object) |
IJavaPeerable.SetPeerReference(JniObjectReference) |
blockednumber プロバイダーとアプリケーションの間のコントラクト。 (継承元 Object) |
拡張メソッド
JavaCast<TResult>(IJavaObject) |
Android ランタイムチェック型変換を実行します。 |
JavaCast<TResult>(IJavaObject) |
blockednumber プロバイダーとアプリケーションの間のコントラクト。 |
GetJniTypeName(IJavaPeerable) |
blockednumber プロバイダーとアプリケーションの間のコントラクト。 |