BlockedNumberContract Classe

Definição

[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

Herança

Object

JavaObject

Object

BlockedNumberContract

Atributos

RegisterAttribute

Comentários

O contrato entre o provedor de número bloqueado e os aplicativos. Contém definições para as URIs e colunas com suporte.

<Visão geral >do h3< /h3>

O provedor de conteúdo expõe uma tabela que contém números bloqueados. As colunas e URIs para acessar essa tabela são definidas pela BlockedNumbers classe. Mensagens e chamadas de números bloqueados são descartadas pela plataforma. As notificações sobre alterações de provedor podem ser recebidas usando um android.database.ContentObserver.

A plataforma não bloqueará mensagens e chamadas de números de emergência, conforme definido por android.telephony.PhoneNumberUtils#isEmergencyNumber(String). Se o usuário entrar em contato com os serviços de emergência, o bloqueio de números será desabilitado pela plataforma por uma duração definida por android.telephony.CarrierConfigManager#KEY_DURATION_BLOCKING_DISABLED_AFTER_EMERGENCY_INT.

<Permissões >h3< /h3>

Somente o sistema, o aplicativo SMS padrão e o aplicativo de telefone padrão (Consulte android.telecom.TelecomManager#getDefaultDialerPackage()) e os aplicativos de operadora (Veja android.service.carrier.CarrierService) podem ler e gravar no provedor de números bloqueados. No entanto, #canCurrentUserBlockNumbers(Context) pode ser acessado por qualquer aplicativo.

<Dados >h3< /h3>

Além dos números de telefone regulares, o provedor de números bloqueados também pode armazenar endereços (como email) dos quais um usuário pode receber mensagens e chamadas. Os números bloqueados são armazenados na BlockedNumbers#COLUMN_ORIGINAL_NUMBER coluna. Uma versão normalizada dos números de telefone (se a normalização for possível) é armazenada na BlockedNumbers#COLUMN_E164_NUMBER coluna. A plataforma bloqueia chamadas e mensagens de um endereço se ele estiver presente na BlockedNumbers#COLUMN_ORIGINAL_NUMBER coluna ou se a versão E164 do endereço corresponder à BlockedNumbers#COLUMN_E164_NUMBER coluna.

<h3> Operações </h3><dl><dt><b>Insert</b></dt><dd>

BlockedNumbers#COLUMN_ORIGINAL_NUMBER é uma coluna necessária que precisa ser preenchida. Opcionalmente, os aplicativos podem fornecer a BlockedNumbers#COLUMN_E164_NUMBER representação E164 do número de telefone. O provedor preencherá automaticamente essa coluna se o aplicativo não for fornecido. Observe que essa coluna não será preenchida se a normalização falhar ou se o endereço não for um número de telefone (por exemplo: email).

A tentativa de inserir um número bloqueado existente (mesma BlockedNumbers#COLUMN_ORIGINAL_NUMBER coluna) resultará na substituição do número bloqueado existente.

Exemplos:

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>

Não há suporte para atualizações. Use Delete e Insert.

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

As exclusões podem ser executadas da seguinte maneira:

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 verificar se um determinado número está bloqueado, use o método #isBlocked(Context, String). </p></dd><dt><b>Query</b></dt><dd>

Todos os números bloqueados podem ser enumerados da seguinte maneira:

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>Desbloquear</b></dt><dd>

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

</dd>

<h3> Multiusuário </h3>

Os aplicativos devem usar o método #canCurrentUserBlockNumbers(Context) antes de executar qualquer operação no provedor de número bloqueado. Se #canCurrentUserBlockNumbers(Context) retornar false, todas as operações no provedor falharão com um SecurityException. A plataforma bloqueará chamadas e mensagens de números no provedor independentemente do usuário atual.

Java documentação para android.provider.BlockedNumberContract.

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Project Open Source do Open Source e usadas de acordo com os termos descritos na Creative Commons 2.5.