在 XMPP 中,好友的上下線狀態是透過 presence 節點廣播的。本文說明如何封裝一個 refreshRosterPresence:offline: 介面,用兩個 Block 分別處理「上線」與「離線」事件。至於「忙碌」「暫離」等其他狀態,可以依同樣模式自行擴充判斷與回呼。
先定義兩個 Block 型別,語意清楚、也方便後續重用:
/*! * @Author Dylan. * * Presence */ typedef void (^userGoOnline) (NSString *); typedef void (^userGoOffline) (NSString *); - (void)refreshRosterPresence:(userGoOnline)online offline:(userGoOffline)offline;
回呼必須存成 copy 屬性,才能從 stack 複製到 heap 並跳脫當前作用域:
/*! * call back block */ @property (nonatomic, copy) userGoOnline rosterOnline; @property (nonatomic, copy) userGoOffline rosterOffline;
#pragma mark presence
- (void)refreshRosterPresence:(userGoOnline)online offline:(userGoOffline)offline
{
self.rosterOnline = online;
self.rosterOffline = offline;
}
- (void)xmppStream:(XMPPStream *)sender
didReceivePresence:(XMPPPresence *)presence
{
// 取得 presence 型別
NSString *presenceType = [presence type];
NSString *userID = [[sender myJID] user];
NSString *presenceFromUser = [[presence from] user];
// 忽略自己發出的 presence,只處理好友的
if (![presenceFromUser isEqualToString:userID]) {
if ([presenceType isEqualToString:@"available"]) {
self.rosterOnline(presenceFromUser);
} else if ([presenceType isEqualToString:@"unavailable"]) {
self.rosterOffline(presenceFromUser);
}
}
}
refreshRosterPresence:offline: 本身並不主動發送任何請求,它只是把兩個 Block 存起來,作為後續 delegate 事件的「接線端子」。真正的判定邏輯寫在 xmppStream:didReceivePresence: 這個 XMPPStream 的 delegate 方法裡。
在該方法中,先取出 presence 的 type:available 代表上線,unavailable 代表離線。接著比對 from 的 user 部分與自己的 JID,若是自己發出的就跳過,避免把自身的狀態變更誤判為好友事件。最後依型別呼叫對應的 Block,把好友的 JID 回傳給外層。
第一,Block 記得做 nil 檢查。 如果呼叫方沒有傳入 offline,直接呼叫 self.rosterOffline(...) 會 crash。改成 if (self.rosterOffline) self.rosterOffline(...); 更保險。
第二,presence 的 type 還有更多值。 除了 available 與 unavailable,XMPP 標準還定義了 subscribe、subscribed、unsubscribe、probe、error 等,分別對應好友邀請與訂閱流程。若要支援完整的 Roster 同步,這些都應該納入處理。
第三,狀態可以更細緻。 presence 的 show 元素能表達 away、xa、dnd、chat 等狀態,而 status 元素則承載使用者自訂的狀態文字。若 UI 需要顯示「忙碌」或「離開」,可以從這兩個元素取值,再擴充回呼簽名為 (NSString *userID, NSString *show, NSString *status)。
第四,記得保存最新狀態。 目前設計是「事件驅動」的純通知模式,每次上線/離線都只回報變化。若後續 UI 需要一次顯示全部好友狀態,建議在內部維護一份 userID → status 的字典,並在取得 Roster 列表後主動發送 presence probe 補齊初始狀態。