ContactsContract.StreamItems 類別

定義

[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

繼承

Object

JavaObject

Object

ContactsContract.StreamItems

屬性

RegisterAttribute ObsoleteAttribute

備註

stream_items表的常數，該表包含來自使用者聯絡人列表的社交串流更新。

在給定的原始接觸下，只有一定數量的串流項目會被儲存。 此 API 的使用者可以查詢 ContactsContract.StreamItems#CONTENT_LIMIT_URI 此限制，並應相應限制插入任何交易中的項目數量。 超過限制的新增項目將自動刪除最舊的項目，為 StreamItems#TIMESTAMP。

透過這些 URI 存取社交串流需要額外權限，超出提供者所需的讀寫聯絡權限。 查詢社群串流資料需要android.permission.READ_SOCIAL_STREAM權限，插入或更新社群串流項目則需要android.permission.WRITE_SOCIAL_STREAM權限。

<h3>帳戶檢查</h3>

插入、更新及刪除操作的內容 URI 必須具備擁有原始聯絡人帳戶資訊的查詢參數，即 RawContacts#ACCOUNT_TYPE 和 RawContacts#ACCOUNT_NAME。 RawContacts#DATA_SET 不是必須的。

<h3 操作/h3><dl><dt>b<插入></b>/dt<><dd><>

社群直播更新總是與原始聯絡人綁定。 有幾種方式可以插入這些條目。 <dl>dt 透過原始接觸的子路徑 ：</dt>RawContacts.StreamItems#CONTENT_DIRECTORYdd <><>

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 ：/dt<>dd StreamItems#CONTENT_URI<><>

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>

一旦 StreamItems 插入了一篇文章，就可以插入與該社群更新相關的照片。 例如，在上述插入後，可以透過以下方式<將照片加入串流項目：dl><dt>透過包含串流項目 ID：</dt><dd 的 URI 加入>

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 ：/dt<>dd ContactsContract.StreamItems#CONTENT_PHOTO_URI<><>

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);

請注意，後者允許在單一交易中插入串流項目及其照片，方法是使用 ContentProviderOperation 回溯參考來填充串流項目 ID ContentValues。 </dd></dl>

</dd>dt b 更新/b</dt><>dd<更新可以透過將串流項目 ID 附加到 >< URI 來執行。><>StreamItems#CONTENT_URI 只有由呼叫套件建立的社交串流條目才能被更新。</dd>dt b 刪除/b</dt><>dd<刪除可以透過在 URI 中附加串流項目 ID >< 來執行。><>StreamItems#CONTENT_URI 只有由呼叫套件建立的社交串流條目才能被刪除。</dd>dt b 查詢/b</dt><>dl<><dt>查找特定聯絡人/dt<>dd<依聯絡人ID查詢該社群>串流的所有更新：<><>

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

</dd><dd>透過查詢鍵：

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

</dd>dt 查找特定原始聯絡人<的所有社群直播更新/dt><dd><>

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

</dd><dt>以 ID<>< 查詢特定串流項目>

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

</dd></dl>

此會員已被棄用。 - 不要用。 未來將不再支援此功能。 未來，相關查詢回傳的游標將為空。

Java 文件 android.provider.ContactsContract.StreamItems。

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。