ContactsContract.StreamItems Clase

Definición

[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

Herencia

Object

JavaObject

Object

ContactsContract.StreamItems

Atributos

RegisterAttribute ObsoleteAttribute

Comentarios

Constantes de la tabla stream_items, que contiene actualizaciones de secuencias sociales de la lista de contactos del usuario.

Solo se almacenará un número determinado de elementos de flujo en un contacto sin procesar determinado. Los usuarios de esta API pueden consultar ContactsContract.StreamItems#CONTENT_LIMIT_URI para determinar este límite y deben restringir el número de elementos insertados en cualquier transacción determinada correspondiente. La inserción de más elementos más allá del límite provocará automáticamente la eliminación de los elementos más antiguos, por StreamItems#TIMESTAMP.

El acceso a la secuencia social a través de estos URI requiere permisos adicionales más allá de los permisos de contacto de lectura y escritura requeridos por el proveedor. La consulta de datos de flujo social requiere android.permission.READ_SOCIAL_STREAM permiso e insertar o actualizar elementos de flujo social requiere android.permission.WRITE_SOCIAL_STREAM permiso.

<h3>Comprobación de cuenta</h3>

Los URI de contenido para las operaciones de inserción, actualización y eliminación deben tener la información de la cuenta que coincida con la del contacto sin procesar propietario como parámetros de consulta, es decir RawContacts#ACCOUNT_TYPE , y RawContacts#ACCOUNT_NAME. RawContacts#DATA_SET no es necesario.

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

Las actualizaciones de secuencias sociales siempre están asociadas a un contacto sin procesar. Hay un par de maneras de insertar estas entradas. <dl><dt>A través de la RawContacts.StreamItems#CONTENT_DIRECTORY subruta de un contacto sin procesar:</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>

Una vez insertada una StreamItems entrada, se pueden insertar fotos asociadas a esa actualización social. Por ejemplo, después de una de las inserciones anteriores, las fotos se podrían agregar al elemento de secuencia de una de las maneras siguientes: <dl><dt>a través de un URI, incluido el identificador de elemento de secuencia:</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);

Tenga en cuenta que este último formulario permite la inserción de un elemento de secuencia y sus fotos en una sola transacción, utilizando ContentProviderOperation con referencias inversas para rellenar el identificador del elemento de secuencia en .ContentValues </dd></dl>

</dd><dt><b>Update</b></dt><dd>Updates se puede realizar anexando el identificador del elemento de secuencia al StreamItems#CONTENT_URI URI. Solo se pueden actualizar las entradas de flujo social creadas por el paquete de llamada.</dd><dt><b>Delete</b></dt><dd>Deletes se puede realizar anexando el identificador del elemento de secuencia al StreamItems#CONTENT_URI URI. Solo se pueden eliminar las entradas de flujo social creadas por el paquete de llamada.</dd><dt><b>Query</b></dt dl dt><><>Buscar todas las actualizaciones de secuencias sociales de un contacto< o dt><dd>determinado por id. de contacto:

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

</dd dd><>Por clave de búsqueda:

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

</dd><dt>Búsqueda de todas las actualizaciones de secuencias sociales para un determinado contacto< sin procesar/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 miembro está en desuso. - No use. Esto no se admitirá en el futuro. En el futuro, los cursores devueltos de las consultas relacionadas estarán vacíos.

Java documentación para android.provider.ContactsContract.StreamItems.

Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el Android y se usan según los términos descritos en creative Creative Commons 2.5 Attribution License.