ContactsContract.StreamItems Classe

Definição

[Android.Runtime.Register("android/provider/ContactsContract$StreamItems", DoNotGenerateAcw=true)]
[System.Obsolete("This class is obsoleted in this android platform")]
public sealed class ContactsContract.StreamItems : Java.Lang.Object

[<Android.Runtime.Register("android/provider/ContactsContract$StreamItems", DoNotGenerateAcw=true)>]
[<System.Obsolete("This class is obsoleted in this android platform")>]
type ContactsContract.StreamItems = class
    inherit Object

Herança

Object

JavaObject

Object

ContactsContract.StreamItems

Atributos

RegisterAttribute ObsoleteAttribute

Comentários

Constantes para a tabela stream_items, que contém atualizações de fluxo social da lista de contatos do usuário.

Apenas um determinado número de itens de fluxo será armazenado em um determinado contato bruto. Os usuários dessa API podem consultar ContactsContract.StreamItems#CONTENT_LIMIT_URI para determinar esse limite e devem restringir o número de itens inseridos em uma determinada transação correspondentemente. A inserção de mais itens além do limite levará automaticamente à exclusão dos itens mais antigos por StreamItems#TIMESTAMP.

O acesso ao fluxo social por meio dessas URIs requer permissões adicionais além das permissões de contato de leitura/gravação exigidas pelo provedor. A consulta de dados de fluxo social requer permissão android.permission.READ_SOCIAL_STREAM e inserir ou atualizar itens de fluxo social requer permissão android.permission.WRITE_SOCIAL_STREAM.

<verificação> de conta h3</h3>

As URIs de conteúdo para as operações de inserção, atualização e exclusão são necessárias para que as informações da conta correspondam às do contato bruto proprietário como parâmetros de consulta, ou seja RawContacts#ACCOUNT_TYPE , e RawContacts#ACCOUNT_NAME. RawContacts#DATA_SET não é necessário.

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

As atualizações de fluxo social são sempre associadas a um contato bruto. Há algumas maneiras de inserir essas entradas. <dl><dt>Por meio do RawContacts.StreamItems#CONTENT_DIRECTORY sub-caminho de um contato bruto:</dt><dd>

ContentValues values = new ContentValues();
            values.put(StreamItems.TEXT, "Breakfasted at Tiffanys");
            values.put(StreamItems.TIMESTAMP, timestamp);
            values.put(StreamItems.COMMENTS, "3 people reshared this");
            Uri.Builder builder = RawContacts.CONTENT_URI.buildUpon();
            ContentUris.appendId(builder, rawContactId);
            builder.appendEncodedPath(RawContacts.StreamItems.CONTENT_DIRECTORY);
            builder.appendQueryParameter(RawContacts.ACCOUNT_NAME, accountName);
            builder.appendQueryParameter(RawContacts.ACCOUNT_TYPE, accountType);
            Uri streamItemUri = getContentResolver().insert(builder.build(), values);
            long streamItemId = ContentUris.parseId(streamItemUri);

</dd><dt>Via StreamItems#CONTENT_URI:</dt><dd>

ContentValues values = new ContentValues();
            values.put(StreamItems.RAW_CONTACT_ID, rawContactId);
            values.put(StreamItems.TEXT, "Breakfasted at Tiffanys");
            values.put(StreamItems.TIMESTAMP, timestamp);
            values.put(StreamItems.COMMENTS, "3 people reshared this");
            Uri.Builder builder = StreamItems.CONTENT_URI.buildUpon();
            builder.appendQueryParameter(RawContacts.ACCOUNT_NAME, accountName);
            builder.appendQueryParameter(RawContacts.ACCOUNT_TYPE, accountType);
            Uri streamItemUri = getContentResolver().insert(builder.build(), values);
            long streamItemId = ContentUris.parseId(streamItemUri);

</dd></dl></dd></p>

Depois que uma StreamItems entrada for inserida, as fotos associadas a essa atualização social poderão ser inseridas. Por exemplo, após uma das inserções acima, as fotos podem ser adicionadas ao item de fluxo de uma das seguintes maneiras: <dl><dt>Por meio de um URI, incluindo a ID do item de fluxo:</dt><dd>

values.clear();
            values.put(StreamItemPhotos.SORT_INDEX, 1);
            values.put(StreamItemPhotos.PHOTO, photoData);
            getContentResolver().insert(Uri.withAppendedPath(
                ContentUris.withAppendedId(StreamItems.CONTENT_URI, streamItemId),
                StreamItems.StreamItemPhotos.CONTENT_DIRECTORY), values);

</dd><dt>Via ContactsContract.StreamItems#CONTENT_PHOTO_URI:</dt><dd>

values.clear();
            values.put(StreamItemPhotos.STREAM_ITEM_ID, streamItemId);
            values.put(StreamItemPhotos.SORT_INDEX, 1);
            values.put(StreamItemPhotos.PHOTO, photoData);
            getContentResolver().insert(StreamItems.CONTENT_PHOTO_URI, values);

Observe que este último formulário permite a inserção de um item de fluxo e suas fotos em uma única transação, usando ContentProviderOperation com referências de back para preencher a ID do ContentValuesitem de fluxo no . </dd></dl>

</dd><dt><b>Update</b></dt><dd>Updates can be performed by appending the stream item ID to the StreamItems#CONTENT_URI URI. Somente as entradas de fluxo social que foram criadas pelo pacote de chamada podem ser atualizadas.</dd><dt><b>Delete</b></dt><dd>Deletes pode ser executado acrescentando a ID do item de fluxo ao StreamItems#CONTENT_URI URI. Somente entradas de fluxo social que foram criadas pelo pacote de chamada podem ser excluídas.</dd><dt><b>Query</b></dt><dl dt><>Finding all social stream updates for a given contact</dt><dd>By Contact ID:

Cursor c = getContentResolver().query(Uri.withAppendedPath(
                     ContentUris.withAppendedId(Contacts.CONTENT_URI, contactId),
                     Contacts.StreamItems.CONTENT_DIRECTORY),
                     null, null, null, null);

</dd><dd>Por chave de pesquisa:

Cursor c = getContentResolver().query(Contacts.CONTENT_URI.buildUpon()
                     .appendPath(lookupKey)
                     .appendPath(Contacts.StreamItems.CONTENT_DIRECTORY).build(),
                     null, null, null, null);

</dd><dt>Localizando todas as atualizações de fluxo social para um determinado contato< bruto/dt><dd>

Cursor c = getContentResolver().query(Uri.withAppendedPath(
                     ContentUris.withAppendedId(RawContacts.CONTENT_URI, rawContactId),
                     RawContacts.StreamItems.CONTENT_DIRECTORY)),
                     null, null, null, null);

</dd><dt>Querying for a specific stream item by ID</dt><dd>

Cursor c = getContentResolver().query(ContentUris.withAppendedId(
                     StreamItems.CONTENT_URI, streamItemId),
                     null, null, null, null);

</dd></dl>

Este membro foi preterido. - Não use. Isso não terá suporte no futuro. No futuro, os cursores retornados de consultas relacionadas estarão vazios.

Java documentação para android.provider.ContactsContract.StreamItems.

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.