公共事件开发指导-2

??三，公共事件订阅信息类

??1，功能

??封装公共事件订阅相关信息，比如优先级、线程模式、事件范围等。

??线程模式（ThreadMode）：设置订阅者的开关方法执行的线程模式。

四种线程模式：

??HANDLER：在Ability的主线程上执行。

??POST：在事件分发线程执行。

??ASYNC：在一个新创建的异步线程执行。

??BACKGROUND：在后台线程执行。

??注意：目前只支持HANDLER模式。

??2，主要接口：

CommonEventSubscribeInfo(MatchingSkills matchingSkills)

创建公共事件订阅器指定matchingSkills。

CommonEventSubscribeInfo(CommonEventSubscribeInfo)

拷贝公共事件订阅器对象。

setPriority(int priority)

设置优先级，用于有序公共事件。

setThreadMode(ThreadMode threadMode)

指定订阅者的回调函数运行在哪个线程上。

setPermission(String permission)

设置发布者必须具备的权限。

setDeviceId(String deviceId)

指定订阅哪台设备的公共事件。

四，公共事件订阅者类

??1，功能

??封装公共事件订阅者及相关参数。

??注意：目前只能通过调用公共事件管理者的“订阅公共事件()”进行订阅。

??2，主要接口

CommonEventSubscriber(CommonEventSubscribeInfo subscribeInfo)

构造公共事件订阅者实例。

onReceiveEvent(CommonEventData data)

由开发者实现, 在接收到公共事件时被调用。

AsyncCommonEventResult goAsyncCommonEvent()

设置有序公共事件异步执行。

setCodeAndData(int code, String data)

设置有序公共事件的异步结果。

setData(String data)

设置有序公共事件的异步结果数据。

setCode(int code)

设置有序公共事件的异步结果码。

getData()

获取有序公共事件的异步结果数据。

getCode()

获取有序公共事件的异步结果码。

abortCommonEvent()

取消当前的公共事件，仅对有序公共事件有效，取消后，公共事件不再向下一个订阅者传递。

getAbortCommonEvent()

获取当前有序公共事件是否取消的状态。

clearAbortCommonEvent()

清除当前有序公共事件abort状态。

isOrderedCommonEvent()

查询当前公共事件的是否为有序公共事件。

isStickyCommonEvent()

查询当前公共事件是否为粘性公共事件。

五，公共事件管理者类

??1，功能

??是为应用提供订阅、退订和发布公共事件的静态接口类。

??2，主要接口

publishCommonEvent(CommonEventData eventData)

发布公共事件。

publishCommonEvent(CommonEventData event, CommonEventPublishInfo publishInfo)

发布公共事件指定发布信息。

publishCommonEvent(CommonEventData event, CommonEventPublishInfo publishInfo, CommonEventSubscriber resultSubscriber)

发布有序公共事件，指定发布信息和最后一个接收者。

subscribeCommonEvent(CommonEventSubscriber subscriber)

订阅公共事件。

unsubscribeCommonEvent(CommonEventSubscriber subscriber)

退订公共事件。