BMXRosterService Class Reference#
Inherits from NSObject
Declared in floo_proxy.h
Overview#
@interface Roster Service
Properties#
swigCMemOwn#
@property (nonatomic) BOOL swigCMemOwn
swigCPtr#
@property (nonatomic) void *swigCPtr
Instance Methods#
acceptWithRosterId:#
Accept a friend request
- (BMXErrorCode)acceptWithRosterId:(long long)rosterId
Parameters#
rosterId
Friend user ID
Return Value#
Declared In#
floo_proxy.h
{% lanying_code_snippet repo="lanying-im-ios",class="BMXRosterService",function="acceptWithRosterId:" %}{% endlanying_code_snippet %}
acceptWithRosterId:completion:#
Accept a friend request
- (void)acceptWithRosterId:(long long)rosterId completion:(void ( ^ ) ( BMXError error ))aCompletionBlock*
Parameters#
rosterId
Friend user ID
Return Value#
Declared In#
floo_proxy.h
{% lanying_code_snippet repo="lanying-im-ios",class="BMXRosterService",function="acceptWithRosterId:completion:" %}{% endlanying_code_snippet %}
addDelegate:#
Add a roster sevice listener
- (void)addDelegate:(id<BMXRosterServiceProtocol>)aDelegate
Parameters#
listener
Friend change listener
Declared In#
floo_proxy.h
{% lanying_code_snippet repo="lanying-im-ios",class="BMXRosterService",function="addDelegate:" %}{% endlanying_code_snippet %}
addDelegate:delegateQueue:#
- (void)addDelegate:(id<BMXRosterServiceProtocol>)aDelegate delegateQueue:(dispatch_queue_t)aQueue
{% lanying_code_snippet repo="lanying-im-ios",class="BMXRosterService",function="addDelegate:delegateQueue:" %}{% endlanying_code_snippet %}
addRosterListener:#
Add a roster sevice listener
- (void)addRosterListener:(id<BMXRosterServiceProtocol>)listener
Parameters#
listener
Friend change listener
Declared In#
floo_proxy.h
{% lanying_code_snippet repo="lanying-im-ios",class="BMXRosterService",function="addRosterListener:" %}{% endlanying_code_snippet %}
applyWithRosterId:message:#
- (BMXErrorCode)applyWithRosterId:(long long)rosterId message:(NSString )message*
{% lanying_code_snippet repo="lanying-im-ios",class="BMXRosterService",function="applyWithRosterId:message:" %}{% endlanying_code_snippet %}
applyWithRosterId:message:authAnswer:#
Apply to add a friend
- (BMXErrorCode)applyWithRosterId:(long long)rosterId message:(NSString )message authAnswer:(NSString )authAnswer
Parameters#
rosterId
Friend user ID
message
The message attached
Return Value#
Declared In#
floo_proxy.h
{% lanying_code_snippet repo="lanying-im-ios",class="BMXRosterService",function="applyWithRosterId:message:authAnswer:" %}{% endlanying_code_snippet %}
applyWithRosterId:message:authAnswer:completion:#
Apply to add a friend
- (void)applyWithRosterId:(long long)rosterId message:(NSString )message authAnswer:(NSString )authAnswer completion:(void ( ^ ) ( BMXError error ))aCompletionBlock*
Parameters#
rosterId
Friend user ID
message
The message attached
Return Value#
Declared In#
floo_proxy.h
{% lanying_code_snippet repo="lanying-im-ios",class="BMXRosterService",function="applyWithRosterId:message:authAnswer:completion:" %}{% endlanying_code_snippet %}
applyWithRosterId:message:completion:#
- (void)applyWithRosterId:(long long)rosterId message:(NSString )message completion:(void ( ^ ) ( BMXError error ))aCompletionBlock
{% lanying_code_snippet repo="lanying-im-ios",class="BMXRosterService",function="applyWithRosterId:message:completion:" %}{% endlanying_code_snippet %}
blockWithRosterId:#
Block a user
- (BMXErrorCode)blockWithRosterId:(long long)rosterId
Parameters#
rosterId
User ID
Return Value#
Declared In#
floo_proxy.h
{% lanying_code_snippet repo="lanying-im-ios",class="BMXRosterService",function="blockWithRosterId:" %}{% endlanying_code_snippet %}
blockWithRosterId:completion:#
Block a user
- (void)blockWithRosterId:(long long)rosterId completion:(void ( ^ ) ( BMXError error ))aCompletionBlock*
Parameters#
rosterId
User ID
Return Value#
Declared In#
floo_proxy.h
{% lanying_code_snippet repo="lanying-im-ios",class="BMXRosterService",function="blockWithRosterId:completion:" %}{% endlanying_code_snippet %}
dealloc#
- (void)dealloc
{% lanying_code_snippet repo="lanying-im-ios",class="BMXRosterService",function="dealloc" %}{% endlanying_code_snippet %}
declineWithRosterId:reason:#
Decline a friend request
- (BMXErrorCode)declineWithRosterId:(long long)rosterId reason:(NSString )reason*
Parameters#
rosterId
User ID
reason
Reason for rejection
Return Value#
Declared In#
floo_proxy.h
{% lanying_code_snippet repo="lanying-im-ios",class="BMXRosterService",function="declineWithRosterId:reason:" %}{% endlanying_code_snippet %}
declineWithRosterId:reason:completion:#
Decline a friend request
- (void)declineWithRosterId:(long long)rosterId reason:(NSString )reason completion:(void ( ^ ) ( BMXError error ))aCompletionBlock
Parameters#
rosterId
User ID
reason
Reason for rejection
Return Value#
Declared In#
floo_proxy.h
{% lanying_code_snippet repo="lanying-im-ios",class="BMXRosterService",function="declineWithRosterId:reason:completion:" %}{% endlanying_code_snippet %}
downloadAvatarWithItem:thumbnail:callback:#
Download friend's avatar
- (BMXErrorCode)downloadAvatarWithItem:(BMXRosterItem )item thumbnail:(BOOL)thumbnail callback:(void ( ^ ) ( int progress ))callback*
Parameters#
item
User information
thumbnail
Is it a thumbnail
callback
Download callback
Return Value#
Declared In#
floo_proxy.h
{% lanying_code_snippet repo="lanying-im-ios",class="BMXRosterService",function="downloadAvatarWithItem:thumbnail:callback:" %}{% endlanying_code_snippet %}
downloadAvatarWithItem:thumbnail:callback:completion:#
Download friend's avatar
- (void)downloadAvatarWithItem:(BMXRosterItem )item thumbnail:(BOOL)thumbnail callback:(void ( ^ ) ( int progress ))callback completion:(void ( ^ ) ( BMXError error ))aCompletionBlock
Parameters#
item
User information
thumbnail
Is it a thumbnail
callback
Download callback
Return Value#
Declared In#
floo_proxy.h
{% lanying_code_snippet repo="lanying-im-ios",class="BMXRosterService",function="downloadAvatarWithItem:thumbnail:callback:completion:" %}{% endlanying_code_snippet %}
fetchRosterByIdWithRosterId:forceRefresh:completion:#
Get a roster item
- (void)fetchRosterByIdWithRosterId:(long long)rosterId forceRefresh:(BOOL)forceRefresh completion:(void ( ^ ) ( BMXRosterItem item , BMXError error ))aCompletionBlock
Parameters#
rosterId
User ID
forceRefresh
From server
item
User returned by the query. Pass an empty shared_ptr; the method assigns the result to it.
Return Value#
Declared In#
floo_proxy.h
{% lanying_code_snippet repo="lanying-im-ios",class="BMXRosterService",function="fetchRosterByIdWithRosterId:forceRefresh:completion:" %}{% endlanying_code_snippet %}
fetchRosterByIdWithRosterId:forceRefresh:item:#
Get a roster item
- (BMXErrorCode)fetchRosterByIdWithRosterId:(long long)rosterId forceRefresh:(BOOL)forceRefresh item:(BMXRosterItem )item*
Parameters#
rosterId
User ID
forceRefresh
From server
item
User returned by the query. Pass an empty shared_ptr; the method assigns the result to it.
Return Value#
Declared In#
floo_proxy.h
{% lanying_code_snippet repo="lanying-im-ios",class="BMXRosterService",function="fetchRosterByIdWithRosterId:forceRefresh:item:" %}{% endlanying_code_snippet %}
fetchRosterByNameWithName:forceRefresh:completion:#
Get a roster item
- (void)fetchRosterByNameWithName:(NSString )name forceRefresh:(BOOL)forceRefresh completion:(void ( ^ ) ( BMXRosterItem item , BMXError error ))aCompletionBlock*
Parameters#
name
Username
forceRefresh
From server
item
User returned by the query. Pass an empty shared_ptr; the method assigns the result to it.
Return Value#
Declared In#
floo_proxy.h
{% lanying_code_snippet repo="lanying-im-ios",class="BMXRosterService",function="fetchRosterByNameWithName:forceRefresh:completion:" %}{% endlanying_code_snippet %}
fetchRosterByNameWithName:forceRefresh:item:#
Get a roster item
- (BMXErrorCode)fetchRosterByNameWithName:(NSString )name forceRefresh:(BOOL)forceRefresh item:(BMXRosterItem )item
Parameters#
name
Username
forceRefresh
From server
item
User returned by the query. Pass an empty shared_ptr; the method assigns the result to it.
Return Value#
Declared In#
floo_proxy.h
{% lanying_code_snippet repo="lanying-im-ios",class="BMXRosterService",function="fetchRosterByNameWithName:forceRefresh:item:" %}{% endlanying_code_snippet %}
fetchRostersByIdListWithRosterIdList:forceRefresh:completion:#
Get roster items
- (void)fetchRostersByIdListWithRosterIdList:(ListOfLongLong )rosterIdList forceRefresh:(BOOL)forceRefresh completion:(void ( ^ ) ( BMXRosterItemList list , BMXError error ))aCompletionBlock*
Parameters#
rosterIdList
User ID list of roster items
forceRefresh
From server
list
Contact details returned by the operation. Pass an empty list; the method populates it.
Return Value#
Declared In#
floo_proxy.h
{% lanying_code_snippet repo="lanying-im-ios",class="BMXRosterService",function="fetchRostersByIdListWithRosterIdList:forceRefresh:completion:" %}{% endlanying_code_snippet %}
fetchRostersByIdListWithRosterIdList:list:forceRefresh:#
Get roster items
- (BMXErrorCode)fetchRostersByIdListWithRosterIdList:(ListOfLongLong )rosterIdList list:(BMXRosterItemList )list forceRefresh:(BOOL)forceRefresh
Parameters#
rosterIdList
User ID list of roster items
list
Contact details returned by the operation. Pass an empty list; the method populates it.
forceRefresh
From server
Return Value#
Declared In#
floo_proxy.h
{% lanying_code_snippet repo="lanying-im-ios",class="BMXRosterService",function="fetchRostersByIdListWithRosterIdList:list:forceRefresh:" %}{% endlanying_code_snippet %}
get:completion:#
Get all roster items
- (void)get:(BOOL)forceRefresh completion:(void ( ^ ) ( ListOfLongLong list , BMXError error ))aCompletionBlock
Parameters#
forceRefresh
From server
list
Contact IDs returned by the operation. Pass an empty list; the method populates it.
Return Value#
Declared In#
floo_proxy.h
{% lanying_code_snippet repo="lanying-im-ios",class="BMXRosterService",function="get:completion:" %}{% endlanying_code_snippet %}
get:forceRefresh:#
Get all roster items
- (BMXErrorCode)get:(ListOfLongLong )list forceRefresh:(BOOL)forceRefresh*
Parameters#
list
Contact IDs returned by the operation. Pass an empty list; the method populates it.
forceRefresh
From server
Return Value#
Declared In#
floo_proxy.h
{% lanying_code_snippet repo="lanying-im-ios",class="BMXRosterService",function="get:forceRefresh:" %}{% endlanying_code_snippet %}
getApplicationList:completion:#
- (void)getApplicationList:(NSString )cursor completion:(void ( ^ ) ( BMXRosterApplicationResultPage res , BMXError error ))aCompletionBlock*
{% lanying_code_snippet repo="lanying-im-ios",class="BMXRosterService",function="getApplicationList:completion:" %}{% endlanying_code_snippet %}
getApplicationList:cursor:#
- (BMXErrorCode)getApplicationList:(BMXRosterApplicationResultPage )result cursor:(NSString )cursor
{% lanying_code_snippet repo="lanying-im-ios",class="BMXRosterService",function="getApplicationList:cursor:" %}{% endlanying_code_snippet %}
getApplicationList:cursor:pageSize:#
Get friend request list
- (BMXErrorCode)getApplicationList:(BMXRosterApplicationResultPage )result cursor:(NSString )cursor pageSize:(int)pageSize
Parameters#
result
Contact applications returned by the operation. Pass an empty shared_ptr; the method assigns the result to it.
cursor
Cursor at which to start the page. Leave it empty for the first request, then pass the cursor from the previous result.
pageSize
Page size
Return Value#
Declared In#
floo_proxy.h
{% lanying_code_snippet repo="lanying-im-ios",class="BMXRosterService",function="getApplicationList:cursor:pageSize:" %}{% endlanying_code_snippet %}
getApplicationList:pageSize:completion:#
Get friend request list
- (void)getApplicationList:(NSString )cursor pageSize:(int)pageSize completion:(void ( ^ ) ( BMXRosterApplicationResultPage res , BMXError error ))aCompletionBlock*
Parameters#
cursor
Cursor at which to start the page. Leave it empty for the first request, then pass the cursor from the previous result.
pageSize
Page size
result
Contact applications returned by the operation. Pass an empty shared_ptr; the method assigns the result to it.
Return Value#
Declared In#
floo_proxy.h
{% lanying_code_snippet repo="lanying-im-ios",class="BMXRosterService",function="getApplicationList:pageSize:completion:" %}{% endlanying_code_snippet %}
getBlockList:completion:#
Get the ID list of user blocked
- (void)getBlockList:(BOOL)forceRefresh completion:(void ( ^ ) ( ListOfLongLong list , BMXError error ))aCompletionBlock
Parameters#
forceRefresh
From server
list
Blocked contact IDs returned by the operation. Pass an empty list; the method populates it.
Return Value#
Declared In#
floo_proxy.h
{% lanying_code_snippet repo="lanying-im-ios",class="BMXRosterService",function="getBlockList:completion:" %}{% endlanying_code_snippet %}
getBlockList:forceRefresh:#
Get the ID list of user blocked
- (BMXErrorCode)getBlockList:(ListOfLongLong )list forceRefresh:(BOOL)forceRefresh*
Parameters#
list
Blocked contact IDs returned by the operation. Pass an empty list; the method populates it.
forceRefresh
From server
Return Value#
Declared In#
floo_proxy.h
{% lanying_code_snippet repo="lanying-im-ios",class="BMXRosterService",function="getBlockList:forceRefresh:" %}{% endlanying_code_snippet %}
initWithCptr:swigOwnCObject:#
- (id)initWithCptr:(void )cptr swigOwnCObject:(BOOL)ownCObject*
{% lanying_code_snippet repo="lanying-im-ios",class="BMXRosterService",function="initWithCptr:swigOwnCObject:" %}{% endlanying_code_snippet %}
removeDelegate:#
Remove a roster sevice listener
- (void)removeDelegate:(id<BMXRosterServiceProtocol>)aDelegate
Parameters#
listener
Friend change listener
Declared In#
floo_proxy.h
{% lanying_code_snippet repo="lanying-im-ios",class="BMXRosterService",function="removeDelegate:" %}{% endlanying_code_snippet %}
removeRosterListener:#
Remove a roster sevice listener
- (void)removeRosterListener:(id<BMXRosterServiceProtocol>)listener
Parameters#
listener
Friend change listener
Declared In#
floo_proxy.h
{% lanying_code_snippet repo="lanying-im-ios",class="BMXRosterService",function="removeRosterListener:" %}{% endlanying_code_snippet %}
removeWithRosterId:#
Remove a roster item
- (BMXErrorCode)removeWithRosterId:(long long)rosterId
Parameters#
rosterId
User ID
Return Value#
Declared In#
floo_proxy.h
{% lanying_code_snippet repo="lanying-im-ios",class="BMXRosterService",function="removeWithRosterId:" %}{% endlanying_code_snippet %}
removeWithRosterId:completion:#
Remove a roster item
- (void)removeWithRosterId:(long long)rosterId completion:(void ( ^ ) ( BMXError error ))aCompletionBlock*
Parameters#
rosterId
User ID
Return Value#
Declared In#
floo_proxy.h
{% lanying_code_snippet repo="lanying-im-ios",class="BMXRosterService",function="removeWithRosterId:completion:" %}{% endlanying_code_snippet %}
searchWithName:forceRefresh:completion:#
- (void)searchWithName:(NSString )name forceRefresh:(BOOL)forceRefresh completion:(void ( ^ ) ( BMXRosterItem item , BMXError error ))aCompletionBlock*
{% lanying_code_snippet repo="lanying-im-ios",class="BMXRosterService",function="searchWithName:forceRefresh:completion:" %}{% endlanying_code_snippet %}
searchWithName:forceRefresh:item:#
- (BMXErrorCode)searchWithName:(NSString )name forceRefresh:(BOOL)forceRefresh item:(BMXRosterItem )item
{% lanying_code_snippet repo="lanying-im-ios",class="BMXRosterService",function="searchWithName:forceRefresh:item:" %}{% endlanying_code_snippet %}
searchWithRosterId:forceRefresh:completion:#
Search a roster item
- (void)searchWithRosterId:(long long)rosterId forceRefresh:(BOOL)forceRefresh completion:(void ( ^ ) ( BMXRosterItem item , BMXError error ))aCompletionBlock
Parameters#
rosterId
User ID
forceRefresh
From server
item
User returned by the query. Pass an empty shared_ptr; the method assigns the result to it.
Return Value#
Discussion#
Deprecated. use fetchRosterById instead.
Declared In#
floo_proxy.h
{% lanying_code_snippet repo="lanying-im-ios",class="BMXRosterService",function="searchWithRosterId:forceRefresh:completion:" %}{% endlanying_code_snippet %}
searchWithRosterId:forceRefresh:item:#
Search a roster item
- (BMXErrorCode)searchWithRosterId:(long long)rosterId forceRefresh:(BOOL)forceRefresh item:(BMXRosterItem )item*
Parameters#
rosterId
User ID
forceRefresh
From server
item
User returned by the query. Pass an empty shared_ptr; the method assigns the result to it.
Return Value#
Discussion#
Deprecated. use fetchRosterById instead.
Declared In#
floo_proxy.h
{% lanying_code_snippet repo="lanying-im-ios",class="BMXRosterService",function="searchWithRosterId:forceRefresh:item:" %}{% endlanying_code_snippet %}
searchWithRosterIdList:forceRefresh:completion:#
- (void)searchWithRosterIdList:(ListOfLongLong )rosterIdList forceRefresh:(BOOL)forceRefresh completion:(void ( ^ ) ( BMXRosterItemList list , BMXError error ))aCompletionBlock*
{% lanying_code_snippet repo="lanying-im-ios",class="BMXRosterService",function="searchWithRosterIdList:forceRefresh:completion:" %}{% endlanying_code_snippet %}
searchWithRosterIdList:list:forceRefresh:#
- (BMXErrorCode)searchWithRosterIdList:(ListOfLongLong )rosterIdList list:(BMXRosterItemList )list forceRefresh:(BOOL)forceRefresh
{% lanying_code_snippet repo="lanying-im-ios",class="BMXRosterService",function="searchWithRosterIdList:list:forceRefresh:" %}{% endlanying_code_snippet %}
setItemAlias:alias:#
Set friend’s alias
- (BMXErrorCode)setItemAlias:(BMXRosterItem )item alias:(NSString )alias
Parameters#
item
User information
alias
Contact alias
Return Value#
Declared In#
floo_proxy.h
{% lanying_code_snippet repo="lanying-im-ios",class="BMXRosterService",function="setItemAlias:alias:" %}{% endlanying_code_snippet %}
setItemAlias:alias:completion:#
Set friend’s alias
- (void)setItemAlias:(BMXRosterItem )item alias:(NSString )alias completion:(void ( ^ ) ( BMXError error ))aCompletionBlock*
Parameters#
item
User information
alias
Contact alias
Return Value#
Declared In#
floo_proxy.h
{% lanying_code_snippet repo="lanying-im-ios",class="BMXRosterService",function="setItemAlias:alias:completion:" %}{% endlanying_code_snippet %}
setItemExtension:extension:#
Set extension information for the roster item(on server)
- (BMXErrorCode)setItemExtension:(BMXRosterItem )item extension:(NSString )extension
Parameters#
item
User information
extension
Server-side extension data
Return Value#
Declared In#
floo_proxy.h
{% lanying_code_snippet repo="lanying-im-ios",class="BMXRosterService",function="setItemExtension:extension:" %}{% endlanying_code_snippet %}
setItemExtension:extension:completion:#
Set extension information for the roster item(on server)
- (void)setItemExtension:(BMXRosterItem )item extension:(NSString )extension completion:(void ( ^ ) ( BMXError error ))aCompletionBlock*
Parameters#
item
User information
extension
Server-side extension data
Return Value#
Declared In#
floo_proxy.h
{% lanying_code_snippet repo="lanying-im-ios",class="BMXRosterService",function="setItemExtension:extension:completion:" %}{% endlanying_code_snippet %}
setItemLocalExtension:extension:#
Set extension information for the roster item(on local db)
- (BMXErrorCode)setItemLocalExtension:(BMXRosterItem )item extension:(NSString )extension
Parameters#
item
User information
extension
Local extension data
Return Value#
Declared In#
floo_proxy.h
{% lanying_code_snippet repo="lanying-im-ios",class="BMXRosterService",function="setItemLocalExtension:extension:" %}{% endlanying_code_snippet %}
setItemLocalExtension:extension:completion:#
Set extension information for the roster item(on local db)
- (void)setItemLocalExtension:(BMXRosterItem )item extension:(NSString )extension completion:(void ( ^ ) ( BMXError error ))aCompletionBlock*
Parameters#
item
User information
extension
Local extension data
Return Value#
Declared In#
floo_proxy.h
{% lanying_code_snippet repo="lanying-im-ios",class="BMXRosterService",function="setItemLocalExtension:extension:completion:" %}{% endlanying_code_snippet %}
setItemMuteNotification:status:#
Set whether to mute user messages notification
- (BMXErrorCode)setItemMuteNotification:(BMXRosterItem )item status:(BOOL)status*
Parameters#
item
User information
status
true for mute
Return Value#
Declared In#
floo_proxy.h
{% lanying_code_snippet repo="lanying-im-ios",class="BMXRosterService",function="setItemMuteNotification:status:" %}{% endlanying_code_snippet %}
setItemMuteNotification:status:completion:#
Set whether to mute user messages notification
- (void)setItemMuteNotification:(BMXRosterItem )item status:(BOOL)status completion:(void ( ^ ) ( BMXError error ))aCompletionBlock
Parameters#
item
User information
status
true for mute
Return Value#
Declared In#
floo_proxy.h
{% lanying_code_snippet repo="lanying-im-ios",class="BMXRosterService",function="setItemMuteNotification:status:completion:" %}{% endlanying_code_snippet %}
unblockWithRosterId:#
Unblock a roster item
- (BMXErrorCode)unblockWithRosterId:(long long)rosterId
Parameters#
rosterId
ID of the user removed from the block list
Return Value#
Declared In#
floo_proxy.h
{% lanying_code_snippet repo="lanying-im-ios",class="BMXRosterService",function="unblockWithRosterId:" %}{% endlanying_code_snippet %}
unblockWithRosterId:completion:#
Unblock a roster item
- (void)unblockWithRosterId:(long long)rosterId completion:(void ( ^ ) ( BMXError error ))aCompletionBlock*
Parameters#
rosterId
ID of the user removed from the block list
Return Value#
Declared In#
floo_proxy.h
Example:
{% lanying_code_snippet repo="lanying-im-ios",class="BMXRosterService",function="unblockWithRosterId:completion:" %}{% endlanying_code_snippet %}