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>Account check</h3>

挿入、更新、および削除操作のコンテンツ URI は、所有する未加工の連絡先のアカウント情報と一致するアカウント情報をクエリ パラメーター (つまり、 RawContacts#ACCOUNT_TYPE と RawContacts#ACCOUNT_NAME) として持っている必要があります。 RawContacts#DATA_SET は必要ありません。

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

ソーシャル ストリームの更新は、常に未加工の連絡先に関連付けられます。 これらのエントリを挿入するには、いくつかの方法があります。 <dl><dt> raw contact:RawContacts.StreamItems#CONTENT_DIRECTORY/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>

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

この後者の形式では、 ContentProviderOperation とバック参照を使用してストリーム項目 ID を ContentValuesに設定することで、ストリーム項目とその写真を 1 つのトランザクションに挿入できます。 </dd></dl>

</dd><dt><b>Update</b></dt><dd>Updates は、ストリーム項目 ID を StreamItems#CONTENT_URI URI に追加することで実行できます。 呼び出し元パッケージによって作成されたソーシャル ストリーム エントリのみを更新できます。</dd><dt><b>Delete</b></dt><dd>Deletes は、ストリーム項目 ID を StreamItems#CONTENT_URI URI に追加することによって実行できます。 削除できるのは、呼び出し元パッケージによって作成されたソーシャル ストリーム エントリだけです</dd><ddt><b>Query</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</dt><dd による特定のストリーム項目のクエリ>

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

</dd></dl>

このメンバーは非推奨です。 - 使用しないでください。 これは今後サポートされません。 今後、関連するクエリから返されるカーソルは空になります。

Javaドキュメント。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。