班级 MCDUserActivityChannel

@interface MCDUserActivityChannel : NSObject

此类处理应用程序的用户活动的添加和查询。

属性

syncScope

@property(class, readonly, nonnull) MCDUserDataFeedSyncScope* syncScope;

获取用户活动的用户数据同步作用域值。

appDisplayName

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

适用于所有活动的应用程序的显示名称。

构造函数

channelWithUserDataFeed

+ (nullable instancetype)channelWithUserDataFeed:(nonnull MCDUserDataFeed*)userDataFeed;

使用用户数据馈送创建此类的实例。

parameters

  • userDataFeed 与此通道上的活动关联的用户数据。

返回

返回此类的新实例。

方法

getOrCreateUserActivityAsync

- (void)getOrCreateUserActivityAsync:(nonnull NSString*)activityId completion:(nonnull void (^)(MCDUserActivity* _Nonnull, NSError* _Nullable))completionBlock;

创建指定的用户活动,或获取对它的引用(如果已存在)。

parameters

  • activityId 此活动的 ID。
  • completionBlock 完成时要执行的代码块。 这将提供对检索到的活动的访问。

deleteActivityAsync

- (void)deleteActivityAsync:(nonnull NSString*)activityId completion:(nonnull void (^)(NSError* _Nullable))completionBlock;

删除给定的用户活动。

parameters

  • activityId 要删除的活动的 ID。
  • completionBlock 完成时要执行的代码块。

deleteAllActivitiesAsync

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

删除所有用户活动。

parameters

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

getRecentUserActivitiesAsync

- (void)getRecentUserActivitiesAsync:(NSInteger)maxUniqueActivities completion:(void (^_Nonnull)(NSArray<MCDUserActivitySessionHistoryItem*>* _Nonnull, NSError* _Nullable))completionBlock;

获取最近的用户活动的历史记录。

parameters

  • maxUniqueActivities 要检索的最大用户活动数。
  • completionBlock 完成时要执行的代码块。 这将提供对活动历史记录的访问权限。

getSessionHistoryItemsForUserActivityAsync

- (void)getSessionHistoryItemsForUserActivityAsync:(nonnull NSString*)activityId withStartTime:(nonnull NSDate*)startTime completion:(void (^_Nonnull)(NSArray<MCDUserActivitySessionHistoryItem*>* _Nonnull, NSError* _Nullable))completionBlock;

获取给定活动的会话历史记录项。

parameters

  • activityId 要获取其历史记录的活动的 ID。
  • startTime 考虑会话历史记录的时间。
  • completionBlock 完成时要执行的代码块。 这将提供对活动历史记录的访问权限。

getRecentSessionHistoryItemsForTimeRangeAsync

- (void)getRecentSessionHistoryItemsForTimeRangeAsync:(nonnull NSDate*)startTime endTime:(nonnull NSDate*)endTime maxActivities:(NSInteger)maxActivities completion:(void (^_Nonnull)(NSArray<MCDUserActivitySessionHistoryItem*>* _Nonnull, NSError* _Nullable))completionBlock;

获取给定活动的会话历史记录项。

parameters

  • startTime 开始考虑会话历史记录的时间。
  • endTime 结束考虑会话历史记录的时间。
  • maxActivities 要检索的最大用户活动数。
  • completion 完成时要执行的代码块。
  • completionBlock 完成时要执行的代码块。 这将提供对活动历史记录的访问权限。