EMContactManagerDelegate.h 5.0 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180
  1. /*!
  2. * \~chinese
  3. * @header EMContactManagerDelegate.h
  4. * @abstract 此协议定义了好友相关的回调
  5. * @author Hyphenate
  6. * @version 3.00
  7. *
  8. * \~english
  9. * @header EMContactManagerDelegate.h
  10. * @abstract The protocol of contact callbacks definitions
  11. * @author Hyphenate
  12. * @version 3.00
  13. */
  14. #import <Foundation/Foundation.h>
  15. @class EMError;
  16. /*!
  17. * \~chinese
  18. * 好友相关的回调
  19. *
  20. * \~english
  21. * Contact related callbacks
  22. */
  23. @protocol EMContactManagerDelegate <NSObject>
  24. @optional
  25. /*!
  26. * \~chinese
  27. * 用户B同意用户A的加好友请求后,用户A会收到这个回调
  28. *
  29. * @param aUsername 用户B
  30. *
  31. * \~english
  32. * Delegate method will be invoked if a friend request is approved
  33. *
  34. * User A will receive this callback after user B approved user A's friend request
  35. *
  36. * @param aUsername User who approves a friend's request
  37. */
  38. - (void)friendRequestDidApproveByUser:(NSString *)aUsername;
  39. /*!
  40. * \~chinese
  41. * 用户B拒绝用户A的加好友请求后,用户A会收到这个回调
  42. *
  43. * @param aUsername 用户B
  44. *
  45. * \~english
  46. * Delegate method will be invoked if a friend request is declined.
  47. *
  48. * User A will receive this callback after user B declined user A's friend request
  49. *
  50. * @param aUsername User who declined a friend's request
  51. */
  52. - (void)friendRequestDidDeclineByUser:(NSString *)aUsername;
  53. /*!
  54. * \~chinese
  55. * 用户B删除与用户A的好友关系后,用户A,B会收到这个回调
  56. *
  57. * @param aUsername 用户B
  58. *
  59. * \~english
  60. * Delegate method will be invoked if user is removed as a contact by another user
  61. *
  62. * User A and B both will receive this callback after User B unfriended user A
  63. *
  64. * @param aUsername User who unfriended the current user
  65. */
  66. - (void)friendshipDidRemoveByUser:(NSString *)aUsername;
  67. /*!
  68. * \~chinese
  69. * 用户B同意用户A的好友申请后,用户A和用户B都会收到这个回调
  70. *
  71. * @param aUsername 用户好友关系的另一方
  72. *
  73. * \~english
  74. * Delegate method will be invoked id the user is added as a contact by another user.
  75. *
  76. * Both user A and B will receive this callback after User B agreed user A's add-friend invitation
  77. *
  78. * @param aUsername Another user of user‘s friend relationship
  79. */
  80. - (void)friendshipDidAddByUser:(NSString *)aUsername;
  81. /*!
  82. * \~chinese
  83. * 用户B申请加A为好友后,用户A会收到这个回调
  84. *
  85. * @param aUsername 用户B
  86. * @param aMessage 好友邀请信息
  87. *
  88. * \~english
  89. * Delegate method will be invoked when a user received a friend request
  90. *
  91. * User A will receive this callback when received a friend request from user B
  92. *
  93. * @param aUsername Friend request sender
  94. * @param aMessage Friend request message
  95. */
  96. - (void)friendRequestDidReceiveFromUser:(NSString *)aUsername
  97. message:(NSString *)aMessage;
  98. #pragma mark - Deprecated methods
  99. /*!
  100. * \~chinese
  101. * 用户B同意用户A的加好友请求后,用户A会收到这个回调
  102. *
  103. * @param aUsername 用户B
  104. *
  105. * \~english
  106. * User A will receive this callback after user B accepted user A's friend request
  107. *
  108. * @param aUsername User B
  109. */
  110. - (void)didReceiveAgreedFromUsername:(NSString *)aUsername __deprecated_msg("Use -friendRequestDidApproveByUser:");
  111. /*!
  112. * \~chinese
  113. * 用户B拒绝用户A的加好友请求后,用户A会收到这个回调
  114. *
  115. * @param aUsername 用户B
  116. *
  117. * \~english
  118. * User A will receive this callback after user B declined user A's add-friend invitation
  119. *
  120. * @param aUsername User B
  121. */
  122. - (void)didReceiveDeclinedFromUsername:(NSString *)aUsername __deprecated_msg("Use -friendRequestDidDeclineByUser:");
  123. /*!
  124. * \~chinese
  125. * 用户B删除与用户A的好友关系后,用户A会收到这个回调
  126. *
  127. * @param aUsername 用户B
  128. *
  129. * \~english
  130. * User A will receive this callback after User B delete the friend relationship between user A
  131. *
  132. * @param aUsername User B
  133. */
  134. - (void)didReceiveDeletedFromUsername:(NSString *)aUsername __deprecated_msg("Use -friendshipDidRemoveByUser:");
  135. /*!
  136. * \~chinese
  137. * 用户B同意用户A的好友申请后,用户A和用户B都会收到这个回调
  138. *
  139. * @param aUsername 用户好友关系的另一方
  140. *
  141. * \~english
  142. * Both user A and B will receive this callback after User B agreed user A's add-friend invitation
  143. *
  144. * @param aUsername Another user of user‘s friend relationship
  145. */
  146. - (void)didReceiveAddedFromUsername:(NSString *)aUsername __deprecated_msg("Use -friendshipDidAddByUser:");
  147. /*!
  148. * \~chinese
  149. * 用户B申请加A为好友后,用户A会收到这个回调
  150. *
  151. * @param aUsername 用户B
  152. * @param aMessage 好友邀请信息
  153. *
  154. * \~english
  155. * User A will receive this callback after user B requested to add user A as a friend
  156. *
  157. * @param aUsername User B
  158. * @param aMessage Friend invitation message
  159. */
  160. - (void)didReceiveFriendInvitationFromUsername:(NSString *)aUsername
  161. message:(NSString *)aMessage __deprecated_msg("Use -friendRequestDidReceiveFromUser:message:");
  162. @end