EMContactManagerDelegate.h 2.9 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106
  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. * The contact related callbacks.
  22. */
  23. @protocol EMContactManagerDelegate <NSObject>
  24. @optional
  25. /**
  26. * \~chinese
  27. * 用户 B 同意用户 A 的加好友请求后,用户 A 会收到这个回调
  28. *
  29. * @param aUsername 用户 B 的 user ID
  30. *
  31. * \~english
  32. * Occurs when a friend request is approved, user A will receive this callback after user B approved user A's friend request.
  33. *
  34. * @param aUsername The user ID who approves a friend's request.
  35. */
  36. - (void)friendRequestDidApproveByUser:(NSString * _Nonnull)aUsername;
  37. /**
  38. * \~chinese
  39. * 用户 B 拒绝用户 A 的加好友请求后,用户 A 会收到这个回调。
  40. *
  41. * @param aUsername 用户 B 的 user ID
  42. *
  43. * \~english
  44. * Occurs when a friend request is declined.
  45. *
  46. * User A will receive this callback after user B declined user A's friend request.
  47. *
  48. * @param aUsername The user ID who declined a friend request.
  49. */
  50. - (void)friendRequestDidDeclineByUser:(NSString * _Nonnull)aUsername;
  51. /**
  52. * \~chinese
  53. * 用户 B 删除与用户 A 的好友关系后,用户 A,B 会收到这个回调
  54. *
  55. * @param aUsername 用户 B 的 user ID
  56. *
  57. * \~english
  58. * Occurs when a user is removed as a contact by another user.
  59. *
  60. * User A and B both will receive this callback after User B unfriended user A.
  61. *
  62. * @param aUsername The user who unfriended the current user
  63. */
  64. - (void)friendshipDidRemoveByUser:(NSString * _Nonnull)aUsername;
  65. /**
  66. * \~chinese
  67. * 用户 B 同意用户 A 的好友申请后,用户 A 和用户 B 都会收到这个回调
  68. *
  69. * @param aUsername 用户好友关系的另一方
  70. *
  71. * \~english
  72. * Occurs when the user is added as a contact by another user.
  73. *
  74. * Both user A and B will receive this callback after User B agreed user A's add-friend invitation.
  75. *
  76. * @param aUsername Another user of the user‘s friend relationship.
  77. */
  78. - (void)friendshipDidAddByUser:(NSString *_Nonnull)aUsername;
  79. /**
  80. * \~chinese
  81. * 用户 B 申请加 A 为好友后,用户 A 会收到这个回调。
  82. *
  83. * @param aUsername 用户 B 的 user ID
  84. * @param aMessage 好友邀请信息
  85. *
  86. * \~english
  87. * Occurs when a user received a friend request.
  88. *
  89. * User A will receive this callback when received a friend request from user B.
  90. *
  91. * @param aUsername Friend request sender user ID
  92. * @param aMessage Friend request message
  93. */
  94. - (void)friendRequestDidReceiveFromUser:(NSString *_Nonnull)aUsername
  95. message:(NSString *_Nullable)aMessage;
  96. @end