班级 MCDUserActivity

@interface MCDUserActivity : NSObject

此类表示单一用户活动实例。 用户活动在其执行期间由应用创建,用于通知系统用户工作流可以在另一台设备上或在同一设备上的其他时间继续。 它提供有关用户参与的任务的信息。

注意: MCDUserActivity 实例的大小限制为100KB,超过此大小限制无法发布。

属性

activityId

@property(nonatomic, readonly, nonnull) NSString* activityId;

此活动的唯一 ID。

state

@property(nonatomic, readonly) MCDUserActivityState state;

此活动的状态。

activationUri

@property(nonatomic, copy, nonnull) NSString* activationUri;

激活此用户活动时要遵循的 URI。

fallbackUri

@property(nonatomic, copy, nullable) NSString* fallbackUri;

此活动所包含的 web 友好 URI,在主 URI 失败时使用。

contentUri

@property(nonatomic, copy, nullable) NSString* contentUri;

此活动的内容 URI (将用于表示另一设备) 上的活动的图像的 URI。

contentType

@property(nonatomic, copy, nullable) NSString* contentType;

MIME (多用途 Internet 邮件扩展) 存储在 contentUri中的内容的类型。 例如,"text/普通"。

contentInfoJson

@property(nonatomic, copy, nullable) NSString* contentInfoJson;

此活动的基本内容信息。 例如,如果活动正在读取 RSS 源,则内容字符串可能包括项目的名称及其作者。

appDisplayName

@property(nonatomic, readonly, nullable) NSString* appDisplayName;

此活动的应用程序显示名称。

Visualelements>

@property(nonatomic, retain, nonnull) MCDUserActivityVisualElements* visualElements

此活动的可视元素 (可用于活动) 的 "详细信息" 磁贴的信息。

roamable

@property(nonatomic, assign, getter = isRoamable) BOOL roamable;

获取或设置此活动是否向其他终结点漫游。

构造函数

activityWithActivityId

+ (nullable instancetype)activityWithActivityId:(nonnull NSString*)activityId;

使用给定的 ID 创建此类的实例。

parameters

  • activityId

此活动 (的标识符应为) 的唯一字符串。

返回

返回此类的实例。

initWithActivityId

- (nullable instancetype)initWithActivityId:(nonnull NSString*)activityId;

使用给定的 ID 创建此类的实例。

parameters

  • activityId

此活动 (的标识符应为) 的唯一字符串。

返回

返回此类的实例。

方法

createSession

- (nonnull MCDUserActivitySession*)createSession;

创建此 MCDUserActivity 将与之关联的用户活动会话。 关联的 MCDUserActivitySession 指示用户当前参与了活动。

返回

创建的会话。

saveAsync

- (void)saveAsync:(nonnull void (^)(NSError* _Nullable))completionBlock;

发布用户活动。 在调用此方法之前,MCDUserActivity 必须有一个具有设置显示文本的激活 URI 和 Visualelements> 成员。 每当应用修改 MCDUserActivity (的属性以便发布更新) 时,都应调用此方法。

parameters

  • completionBlock 完成时要执行的代码块。