类 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;
使用用户数据馈送创建此类的实例。
参数
userDataFeed
与此通道上的活动关联的用户数据。
返回
返回此类的新实例。
方法
getOrCreateUserActivityAsync
- (void)getOrCreateUserActivityAsync:(nonnull NSString*)activityId completion:(nonnull void (^)(MCDUserActivity* _Nonnull, NSError* _Nullable))completionBlock;
创建指定的用户活动,或获取对它的引用(如果已存在)。
参数
activityId
此活动的 ID。completionBlock
完成后要执行的代码块。 这提供对检索到的活动的访问权限。
deleteActivityAsync
- (void)deleteActivityAsync:(nonnull NSString*)activityId completion:(nonnull void (^)(NSError* _Nullable))completionBlock;
删除给定的用户活动。
参数
activityId
要删除的活动的 ID。completionBlock
完成后要执行的代码块。
deleteAllActivitiesAsync
- (void)deleteAllActivitiesAsync:(nonnull void (^)(NSError* _Nullable))completionBlock;
删除所有用户活动。
参数
completionBlock
完成后要执行的代码块。
getRecentUserActivitiesAsync
- (void)getRecentUserActivitiesAsync:(NSInteger)maxUniqueActivities completion:(void (^_Nonnull)(NSArray<MCDUserActivitySessionHistoryItem*>* _Nonnull, NSError* _Nullable))completionBlock;
获取最近用户活动的历史记录。
参数
maxUniqueActivities
要检索的最大用户活动数。completionBlock
完成后要执行的代码块。 这提供对活动历史记录的访问。
getSessionHistoryItemsForUserActivityAsync
- (void)getSessionHistoryItemsForUserActivityAsync:(nonnull NSString*)activityId withStartTime:(nonnull NSDate*)startTime completion:(void (^_Nonnull)(NSArray<MCDUserActivitySessionHistoryItem*>* _Nonnull, NSError* _Nullable))completionBlock;
获取给定活动的会话历史记录条目。
参数
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;
获取给定活动的会话历史记录条目。
参数
startTime
开始考虑会话历史记录的时间。endTime
考虑会话历史记录的结束时间。maxActivities
要检索的最大用户活动数。completion
完成后要执行的代码块。completionBlock
完成后要执行的代码块。 这提供对活动历史记录的访问。
反馈
https://aka.ms/ContentUserFeedback。
即将推出:在整个 2024 年,我们将逐步取消以“GitHub 问题”作为内容的反馈机制,并将其替换为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈