XMPPvCardAvatarModule.h
2.57 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
//
// XMPPvCardAvatarModule.h
// XEP-0153 vCard-Based Avatars
//
// Created by Eric Chamberlain on 3/9/11.
// Copyright 2011 RF.com. All rights reserved.
/*
* NOTE: Currently this implementation only supports downloading and caching avatars.
*/
#import <Foundation/Foundation.h>
#if TARGET_OS_IPHONE
#import <UIKit/UIKit.h>
#else
#import <Cocoa/Cocoa.h>
#endif
#import "XMPP.h"
#import "XMPPvCardTempModule.h"
#define _XMPP_VCARD_AVATAR_MODULE_H
@protocol XMPPvCardAvatarStorage;
@interface XMPPvCardAvatarModule : XMPPModule <XMPPvCardTempModuleDelegate>
{
__strong XMPPvCardTempModule *_xmppvCardTempModule;
__strong id <XMPPvCardAvatarStorage> _moduleStorage;
BOOL _autoClearMyvcard;
}
@property(nonatomic, strong, readonly) XMPPvCardTempModule *xmppvCardTempModule;
/*
* XEP-0153 Section 4.2 rule 1
*
* A client MUST NOT advertise an avatar image without first downloading the current vCard.
* Once it has done this, it MAY advertise an image.
*
* Default YES
*/
@property(nonatomic, assign) BOOL autoClearMyvcard;
- (id)initWithvCardTempModule:(XMPPvCardTempModule *)xmppvCardTempModule;
- (id)initWithvCardTempModule:(XMPPvCardTempModule *)xmppvCardTempModule dispatchQueue:(dispatch_queue_t)queue;
- (NSData *)photoDataForJID:(XMPPJID *)jid;
@end
////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
#pragma mark -
////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
@protocol XMPPvCardAvatarDelegate <NSObject>
#if TARGET_OS_IPHONE
- (void)xmppvCardAvatarModule:(XMPPvCardAvatarModule *)vCardTempModule
didReceivePhoto:(UIImage *)photo
forJID:(XMPPJID *)jid;
#else
- (void)xmppvCardAvatarModule:(XMPPvCardAvatarModule *)vCardTempModule
didReceivePhoto:(NSImage *)photo
forJID:(XMPPJID *)jid;
#endif
@end
////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
#pragma mark -
////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
@protocol XMPPvCardAvatarStorage <NSObject>
- (NSData *)photoDataForJID:(XMPPJID *)jid xmppStream:(XMPPStream *)stream;
- (NSString *)photoHashForJID:(XMPPJID *)jid xmppStream:(XMPPStream *)stream;
/**
* Clears the vCardTemp from the store.
* This is used so we can clear any cached vCardTemp's for the JID.
**/
- (void)clearvCardTempForJID:(XMPPJID *)jid xmppStream:(XMPPStream *)stream;
@end