com.netease.nimlib.sdk.avsignalling

接口 SignallingServiceObserver

public interface SignallingServiceObserver

方法概要

限定符和类型	方法和说明
void	observeMemberUpdateNotification(Observer<MemberUpdateEvent> observer, boolean register) 注册/注销 频道成员更新事件观察者
void	observeOfflineNotification(Observer<java.util.ArrayList<ChannelCommonEvent>> observer, boolean register) 注册/注销 离线通知事件观察者，在用户登录后sdk 会去服务器同步用户离线期间发生的各种通知，并以列表的形式返回。
void	observeOnlineNotification(Observer<ChannelCommonEvent> observer, boolean register) 注册/注销 在线通知事件观察者 回调返回参数为RoomCommonEvent的子类对象 ，如果用户想获取相应子类对象中的特殊属性，可以根据事件类型ChannelCommonEvent.getEventType()进行强制类型转换。
void	observeOtherClientInviteAckNotification(Observer<InviteAckEvent> observer, boolean register) 注册/注销 其他端响应（接收/拒绝）邀请事件观察者，当其他端响应了邀请时触发
void	observeSyncChannelListNotification(Observer<java.util.ArrayList<SyncChannelListEvent>> observer, boolean register) 注册/注销 同步未退出频道列表事件观察者 ，在用户登录后sdk会去服务器获取当前还未退出的频道列表 。

方法详细资料

observeOnlineNotification

void observeOnlineNotification(Observer<ChannelCommonEvent> observer,
                               boolean register)

注册/注销 在线通知事件观察者 回调返回参数为RoomCommonEvent的子类对象 ，如果用户想获取相应子类对象中的特殊属性，可以根据事件类型ChannelCommonEvent.getEventType()进行强制类型转换。

事件类型SignallingEventType与 ChannelCommonEvent 子类的对应关系如下：
SignallingEventType.CLOSE 对应于ChannelCloseEvent
SignallingEventType.JOIN 对应于UserJoinEvent
SignallingEventType.INVITE 对应于InvitedEvent
SignallingEventType.CANCEL_INVITE 对应于CanceledInviteEvent
SignallingEventType.REJECT 对应于InviteAckEvent
SignallingEventType.ACCEPT 对应于InviteAckEvent
SignallingEventType.LEAVE 对应于UserLeaveEvent
SignallingEventType.CONTROL 对应于ControlEvent

参数:

observer - 观察者 ，参数为在线通知事件

register - register true为注册，false为注销

observeOfflineNotification

void observeOfflineNotification(Observer<java.util.ArrayList<ChannelCommonEvent>> observer,
                                boolean register)

注册/注销 离线通知事件观察者，在用户登录后sdk 会去服务器同步用户离线期间发生的各种通知，并以列表的形式返回。列表的排序方式为时间递增排序ChannelCommonEvent.getTime()

注意：登录后第一次注册此回调时，如果sdk已经获取到了相应的离线通知列表，会立即回调一次（仅此一次）。

回调返回列表中的元素为ChannelCommonEvent的子类对象 ，如果用户想获取相应子类对象中的特殊属性，可以根据事件类型ChannelCommonEvent.getEventType()进行强制类型转换。

事件类型SignallingEventType与 ChannelCommonEvent 子类的对应关系如下：
SignallingEventType.CLOSE 对应于ChannelCloseEvent
SignallingEventType.JOIN 对应于UserJoinEvent
SignallingEventType.INVITE 对应于InvitedEvent
SignallingEventType.CANCEL_INVITE 对应于CanceledInviteEvent
SignallingEventType.REJECT 对应于InviteAckEvent
SignallingEventType.ACCEPT 对应于InviteAckEvent
SignallingEventType.LEAVE 对应于UserLeaveEvent

参数:

observer - 观察者 ，参数为离线通知事件列表

register - register true为注册，false为注销

observeOtherClientInviteAckNotification

void observeOtherClientInviteAckNotification(Observer<InviteAckEvent> observer,
                                             boolean register)

注册/注销 其他端响应（接收/拒绝）邀请事件观察者，当其他端响应了邀请时触发

参数:

observer - 观察者 ，回调参数为其他端邀请响应事件

register - register true为注册，false为注销

observeSyncChannelListNotification

void observeSyncChannelListNotification(Observer<java.util.ArrayList<SyncChannelListEvent>> observer,
                                        boolean register)

注册/注销 同步未退出频道列表事件观察者 ，在用户登录后sdk会去服务器获取当前还未退出的频道列表 。

注意：登录后第一次注册此回调时，如果sdk已经获取到了相应的频道列表，会立即回调一次（仅此一次）。

参数:

observer - 观察者，回调参数为未退出的频道列表

register - register true为注册，false为注销

observeMemberUpdateNotification

void observeMemberUpdateNotification(Observer<MemberUpdateEvent> observer,
                                     boolean register)

注册/注销 频道成员更新事件观察者

参数:

observer - 观察者，回调参数为成员更新事件，其中包含了最新的频道的完整信息(频道信息+成员列表)

注意：如果是有成员离开或加入频道，正常情况下会优先通过observeOnlineNotification(com.netease.nimlib.sdk.Observer<com.netease.nimlib.sdk.avsignalling.event.ChannelCommonEvent>, boolean) 的回调来通知用户。
此回调的时机如下： 如果有成员信息的变更（而不是成员数量增减）或异常情况（有成员数量变更但是sdk没有回调observeOnlineNotification(com.netease.nimlib.sdk.Observer<com.netease.nimlib.sdk.avsignalling.event.ChannelCommonEvent>, boolean)）

register - register true为注册，false为注销