JMSGGroupDelegate.h 2.9 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103
  1. /*
  2. * | | | | \ \ / / | | | | / _______|
  3. * | |____| | \ \/ / | |____| | / /
  4. * | |____| | \ / | |____| | | | _____
  5. * | | | | / \ | | | | | | |____ |
  6. * | | | | / /\ \ | | | | \ \______| |
  7. * | | | | /_/ \_\ | | | | \_________|
  8. *
  9. * Copyright (c) 2011 ~ 2015 Shenzhen HXHG. All rights reserved.
  10. */
  11. #import <Foundation/Foundation.h>
  12. #import <JMessage/JMSGNotificationEvent.h>
  13. @class JMSGGroup;
  14. /*!
  15. * Group 相关变更通知
  16. */
  17. @protocol JMSGGroupDelegate <NSObject>
  18. /*!
  19. * @abstract 群组信息 (GroupInfo) 变更通知
  20. *
  21. * @param group 变更后的群组对象
  22. *
  23. * @discussion 如果想要获取通知, 需要先注册回调. 具体请参考 JMessageDelegate 里的说明.
  24. */
  25. @optional
  26. - (void)onGroupInfoChanged:(JMSGGroup *)group;
  27. /*!
  28. * @abstract 监听申请入群通知
  29. *
  30. * @param event 申请入群事件
  31. *
  32. * @discussion 只有群主和管理员能收到此事件;申请入群事件相关参数请查看 JMSGApplyJoinGroupEvent 类,在群主审批此事件时需要传递事件的相关参数
  33. *
  34. * @since 3.4.0
  35. */
  36. @optional
  37. - (void)onReceiveApplyJoinGroupApprovalEvent:(JMSGApplyJoinGroupEvent *)event;
  38. /*!
  39. * @abstract 监听管理员拒绝入群申请通知
  40. *
  41. * @param event 拒绝入群申请事件
  42. *
  43. * @discussion 只有申请方和被申请方会收到此事件;拒绝的相关描述和原因请查看 JMSGGroupAdminRejectApplicationEvent 类
  44. *
  45. * @since 3.4.0
  46. */
  47. @optional
  48. - (void)onReceiveGroupAdminRejectApplicationEvent:(JMSGGroupAdminRejectApplicationEvent *)event;
  49. /*!
  50. * @abstract 监听管理员审批通知
  51. *
  52. * @param event 管理员审批事件
  53. *
  54. * @discussion 只有管理员才会收到该事件;当管理员同意或拒绝了某个入群申请事件时,其他管理员就会收到该事件,相关属性请查看 JMSGGroupAdminApprovalEvent 类
  55. *
  56. * @since 3.5.0
  57. */
  58. @optional
  59. - (void)onReceiveGroupAdminApprovalEvent:(JMSGGroupAdminApprovalEvent *)event;
  60. /*!
  61. * @abstract 群成员群昵称变更通知
  62. *
  63. * @param events 群成员昵称变更事件列表
  64. *
  65. * @discussion 如果是离线事件,SDK 会将所有的修改记录加入数组上抛。事件具体相关属性请查看 JMSGGroupNicknameChangeEvent 类
  66. *
  67. * @since 3.7.0
  68. */
  69. @optional
  70. - (void)onReceiveGroupNicknameChangeEvents:(NSArray<__kindof JMSGGroupNicknameChangeEvent*>*)events;
  71. /*!
  72. * @abstract 群公告变更通知
  73. *
  74. * @param events 群公告事件列表
  75. *
  76. * @discussion 事件具体相关属性请查看 JMSGGroupAnnouncementEvent 类
  77. *
  78. * @since 3.8.0
  79. */
  80. @optional
  81. - (void)onReceiveGroupAnnouncementEvents:(NSArray<__kindof JMSGGroupAnnouncementEvent*>*)events;
  82. /*!
  83. * @abstract 群组黑名单变更通知
  84. *
  85. * @param events 群组黑名单事件列表
  86. *
  87. * @discussion 事件具体相关属性请查看 JMSGGroupBlacklistChangeEvent 类
  88. *
  89. * @since 3.8.0
  90. */
  91. - (void)onReceiveGroupBlacklistChangeEvents:(NSArray<__kindof JMSGGroupBlacklistChangeEvent*>*)events;
  92. @end