ContactsContract.StreamItems Classe

Définition

[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

Héritage

Object

JavaObject

Object

ContactsContract.StreamItems

Attributs

RegisterAttribute ObsoleteAttribute

Remarques

Constantes de la table stream_items, qui contient des mises à jour de flux sociaux à partir de la liste de contacts de l’utilisateur.

Seul un certain nombre d’éléments de flux ne seront jamais stockés sous un contact brut donné. Les utilisateurs de cette API peuvent interroger ContactsContract.StreamItems#CONTENT_LIMIT_URI pour déterminer cette limite et doivent limiter le nombre d’éléments insérés dans une transaction donnée correspondant. L’insertion de plus d’éléments au-delà de la limite entraîne automatiquement la suppression des éléments les plus anciens, par StreamItems#TIMESTAMP.

L’accès au flux social via ces URI nécessite des autorisations supplémentaires au-delà des autorisations de contact en lecture/écriture requises par le fournisseur. L’interrogation de données de flux social nécessite android.permission.READ_SOCIAL_STREAM autorisation, et l’insertion ou la mise à jour des éléments de flux social nécessite android.permission.WRITE_SOCIAL_STREAM autorisation.

<vérification> du compte h3</h3>

Les URI de contenu pour les opérations d’insertion, de mise à jour et de suppression sont nécessaires pour que les informations de compte correspondent à celles du contact brut propriétaire en tant que paramètres de requête, à savoir RawContacts#ACCOUNT_TYPE et RawContacts#ACCOUNT_NAME. RawContacts#DATA_SET n’est pas obligatoire.

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

Les mises à jour des flux sociaux sont toujours associées à un contact brut. Il existe deux façons d’insérer ces entrées. <dl><dt>Via le RawContacts.StreamItems#CONTENT_DIRECTORY sous-chemin d’un contact brut :</dt 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>

Une fois qu’une StreamItems entrée a été insérée, les photos associées à cette mise à jour sociale peuvent être insérées. Par exemple, après l’une des insertions ci-dessus, les photos peuvent être ajoutées à l’élément de flux de l’une des manières suivantes : <dl><dt>Via un URI incluant l’ID de l’élément de flux :</dt 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);

Notez que ce dernier formulaire permet l’insertion d’un élément de flux et de ses photos dans une seule transaction, à l’aide ContentProviderOperation de références précédents pour remplir l’ID d’élément de flux dans le ContentValues. </dd></dl>

</dd dt>b<Update></b>/dt dt<><dd>Updates peut être effectué en ajoutant l’ID d’élément de flux à l’URI<.>StreamItems#CONTENT_URI Seules les entrées de flux social qui ont été créées par le package appelant peuvent être mises à jour.</dd><dt><b>Delete</b></dt><dd>Deletes peut être effectué en ajoutant l’ID d’élément de flux à l’URI StreamItems#CONTENT_URI . Seules les entrées de flux social qui ont été créées par le package appelant peuvent être supprimées.</dd><dt><b>Query</b></dt><dl dl><dt>Finding all social stream updates for a given contact</dt 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><>par clé de recherche :

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

</dd><dt>Recherche de toutes les mises à jour de flux sociaux pour un contact< brut/dt dd><donné>

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

</dd><dt>Querying pour un élément de flux spécifique par ID</dt dd><>

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

</dd></dl>

Ce membre est déconseillé. - Ne pas utiliser. Cela ne sera pas pris en charge à l’avenir. À l’avenir, les curseurs retournés par les requêtes associées seront vides.

Java documentation pour android.provider.ContactsContract.StreamItems.

Les parties de cette page sont des modifications basées sur le travail créé et partagé par Android Open Source et utilisées en fonction des termes décrits dans la Creative Commons 2.5 Attribution License.