Article

Creating a User Activity Object ユーザアクティビティオブジェクトを作成する

Identify key user interactions and include the information to restore them later.

Overview 概要

Create NSUserActivity objects at key moments that the user might want to continue later or on another device, and register them with the system. For example, you might create a user activity object when the user opens a web page, plays a song, or performs a significant task in your app. You can also use them to provide better Spotlight search results. あなたはまた、それらを使ってより良いSpotlight検索結果を提供できます。 User activity objects, however, aren’t intended as a way to track every task in your app, or for small edits or minor changes.

When you create an NSUserActivity object, you specify a string that identifies the type of the activity. Activity type strings are typically in reverse-DNS format. For example, when the user opens a web page, you might specify an activity string such as com.myCompany.myApp.OpenWebPage. あなたがNSUserActivityオブジェクトを作成する場合、あなたはアクティビティの型を識別する文字列を指定します。アクティビティ型文字列は、概して逆DNS形式になります。例えば、ユーザがあるウェブページを開く場合、あなたはcom.myCompany.myApp.OpenWebPageのようなアクティビティ文字列を指定するかもしれません。 Declare the activity types that your app supports by including the NSUserActivityTypes key in its Information Property List file. The system uses the information in that key to determine whether your app is capable of handling a given user activity object. システムは、そのキーでの情報を使うことによって、あなたのアプリがある与えられたユーザアクティビティオブジェクトを取り扱うのに適するかどうかを決定します。

Define Activities

When defining a user activity object, do the following:

  1. Create and initialize the user activity object with an appropriate activity type. (You define the activity types your app supports.) ユーザアクティビティオブジェクトを適切なアクティビティ型で作成して初期化してください。(あなたがあなたのアプリがサポートするアクティビティ型を定義します。)

  2. Set the title of the user activity object. ユーザアクティビティオブジェクトのtitleを設定してください。

  3. Configure the tasks for which the object is eligible by enabling one or more of the following properties: isEligibleForHandoff, isEligibleForSearch, and isEligibleForPublicIndexing.

  4. Configure the properties of this object that relate to the user’s current activity. このオブジェクトのこれらプロパティを構成設定してください、それらはユーザの現在のアクティビティに関係します。

  5. For user activity objects configured for search or public indexing, configure the contentAttributeSet, keywords, or webpageURL properties so that Spotlight can index the object. 検索(search)またはパブリック索引作成(public indexing)に対して構成設定されるユーザアクティビティオブジェクトに対して、contentAttributeSetkeywords、またはwebpageURLを構成設定してください、そうすることでSpotlightはそのオブジェクトを索引作成できます。

  6. Call the becomeCurrent() method to register the user activity object with the system. becomeCurrent()メソッドを呼び出して、ユーザアクティビティオブジェクトをシステムに登録してください。

Associate Activity Identifiers with Your Apps

The system associates user activity objects from your app with your developer Team ID. When continuing an activity, the system looks for an app that supports the given activity type and has the same developer Team ID as the activity’s source app. あるアクティビティを続ける場合、システムは、その与えられたアクティビティ型をサポートするそしてそのアクティビティの出典のアプリと同じ開発者Team IDを持つアプリを捜します。 Tying activity objects to your developer Team ID ensures that a competitor’s app can’t intercept the activities you create. To associate your Team ID with your apps, distribute your apps through the App Store or sign them with your developer ID.

See Also 参照

Creating a User Activity Object ユーザアクティビティオブジェクトを作成する