ContactsContract.StreamItems Klasse

Definition

[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

Vererbung

Object

JavaObject

Object

ContactsContract.StreamItems

Attribute

RegisterAttribute ObsoleteAttribute

Hinweise

Konstanten für die tabelle stream_items, die Aktualisierungen des sozialen Datenstroms aus der Kontaktliste des Benutzers enthält.

Nur eine bestimmte Anzahl von Datenstromelementen wird jemals unter einem bestimmten rohen Kontakt gespeichert. Benutzer dieser API können ContactsContract.StreamItems#CONTENT_LIMIT_URI diese Grenze ermitteln und die Anzahl der elemente einschränken, die in einer bestimmten Transaktion eingefügt wurden. Das Einfügen weiterer Elemente über den Grenzwert hinaus führt automatisch zum Löschen der ältesten Elemente nach StreamItems#TIMESTAMP.

Der Zugriff auf den sozialen Datenstrom über diese URIs erfordert zusätzliche Berechtigungen, die über die vom Anbieter erforderlichen Lese-/Schreibzugriffskontaktberechtigungen hinausgehen. Das Abfragen nach Daten für soziale Netzwerke erfordert android.permission.READ_SOCIAL_STREAM Berechtigung, und das Einfügen oder Aktualisieren von Elementen für soziale Datenströme erfordert android.permission.WRITE_SOCIAL_STREAM Berechtigung.

<h3>Kontoüberprüfung</h3>

Die Inhalts-URIs für die Einfüge-, Aktualisierungs- und Löschvorgänge sind erforderlich, damit die Kontoinformationen dem besitzernden rohen Kontakt als Abfrageparameter entsprechen, nämlich RawContacts#ACCOUNT_TYPE und RawContacts#ACCOUNT_NAME. RawContacts#DATA_SET ist nicht erforderlich.

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

Datenstromaktualisierungen für soziale Netzwerke sind immer einem unformatierten Kontakt zugeordnet. Es gibt eine Reihe von Möglichkeiten, diese Einträge einzufügen. <dl><dt>Über den RawContacts.StreamItems#CONTENT_DIRECTORY Unterpfad eines unformatierten Kontakts:</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>

Nachdem ein StreamItems Eintrag eingefügt wurde, können Fotos eingefügt werden, die diesem sozialen Update zugeordnet sind. Nach einer der obigen Einfügungen können fotos beispielsweise dem Streamelement auf eine der folgenden Arten hinzugefügt werden: <dl><dt>Via a URI einschließlich der Streamelement-ID:</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);

Beachten Sie, dass dieses letztere Formular das Einfügen eines Datenstromelements und seiner Fotos in eine einzelne Transaktion ermöglicht, indem mit ContentProviderOperation Rückverweise die Datenstromelement-ID in der ContentValues. </dd></dl>

</dd><dt><b>Update</b></dt><dd>Updates können durch Anfügen der Datenstromelement-ID an den StreamItems#CONTENT_URI URI ausgeführt werden. Es können nur Einträge für soziale Netzwerke aktualisiert werden, die vom aufrufenden Paket erstellt wurden.</dd><dt><b>Delete</b></dt><dd>Deletes können durch Anfügen der Datenstromelement-ID an den StreamItems#CONTENT_URI URI ausgeführt werden. Nur Einträge für soziale Netzwerke, die durch das aufrufende Paket erstellt wurden, können gelöscht werden.</dd><dt><b>Query</b></dt dl><dt><suchen>alle Updates für soziale Datenströme für einen bestimmten Kontakt</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>Nach Nachschlageschlüssel:

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

</dd><dt>Suchen aller Updates für soziale Datenströme für einen bestimmten rohen Kontakt</dt><dd>

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

</dd><dt>Abfrage für ein bestimmtes Datenstromelement nach ID</dt><dd>

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

</dd></dl>

Dieses Element ist veraltet. - Nicht verwenden. Dies wird in Zukunft nicht unterstützt. In Zukunft werden Cursor, die von verwandten Abfragen zurückgegeben werden, leer sein.

Java Dokumentation für android.provider.ContactsContract.StreamItems.

Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die von der Android Open Source Project erstellt und gemeinsam verwendet und gemäß den in der 2.5 Attribution License beschriebenen Begriffen verwendet werden.