1 //

2 // CJGuestCall.h

3 // JabberGuest

4 //

5 // Copyright (c) 2013 Cisco Systems, Inc. All Rights Reserved.

6 //

7 

8 #import <Foundation/Foundation.h>

9 #import <UIKit/UIKit.h>

10 

11 #import <JabberGuest/CJGuestMediaStatistics.h>

12 #import <JabberGuest/CJGuestVideoLicense.h>

13 

19 @protocol CJGuestInvalidCertCallback <NSObject>

23 - (void)accept;

27 - (void)reject;

28 @end

29 

35 @protocol CJGuestServerConfiguraionCallDelegate <NSObject>

36 @optional

41 -(void) serverConfiguraionDidRetriveWithScheduledCallInfo:(NSInteger)secs;

42 

46 -(void) scheduledCallDidExecute;

47 

51 - (void)allServerConfigurationDidRetrieve;

52 @end

53 

58 @protocol CJGuestInvalidCertDelegate <NSObject>

59 @optional

71 - (void) onInvalidCert:(NSString*)certFingerprint

72  certSubjectCN:(NSString*)certSubjectCN

73  referenceID:(NSString*)referenceID

74  invalidReason:(NSArray*)invalidReason

75 subjectCertificateData:(NSString*)subjectCertificateData

76 intermediateCACertificateData:(NSArray*)intermediateCACertificateData

77  invalidCertCallback:(id <CJGuestInvalidCertCallback>)invalidCertCallback;

78 @end

79 

80 #pragma mark Notifications

81 

89 extern NSString *const CJGuestCallStateChangeNotification;

95 extern NSString *const CJGuestCallErrorNotification;

100 extern NSString *const CJGuestCallErrorKey;

105 extern NSString *const CJGuestCallSelfVideoResolutionNotification;

110 extern NSString *const CJGuestCallRemoteVideoResolutionNotification;

115 extern NSString *const CJGuestCallRemotePresoVideoResolutionNotification;

120 extern NSString *const CJGuestCallRemotePresoVideoActiveNotification;

125 extern NSString *const CJGuestCallSelfVideoActiveNotification;

130 extern NSString *const CJGuestCallRemotePresoVideoStartedNotification;

135 extern NSString *const CJGuestCallAudioInStateNotification;

140 extern NSString *const CJGuestCallAudioOutStateNotification;

145 extern NSString *const CJGuestCallVideoInStateNotification;

150 extern NSString *const CJGuestCallVideoOutStateNotification;

155 extern NSString *const CJGuestCallOrientationNotification;

160 extern NSString *const CJGuestCallSentDTMFNotification;

164 extern NSString *const CJGuestCallCameraSwitchedNotification;

168 extern NSString *const CJGuestCallServerVersionNotification;

172 extern NSString *const CJGuestCallRemoteDisplayNameChangedNotification;

173 

174 

175 

180 #pragma mark Errors

181 

188 typedef NS_ENUM(NSInteger, CJGuestErrorCode) {

192  CJGuestSipError = 1,

196  CJGuestRoapExceptionError,

200  CJGuestBlankSipUriError,

204  CJGuestBlankSdpError,

208  CJGuestInvalidSipUriError,

212  CJGuestMediaGatewayUndefinedError,

216  CJGuestMediaGatewayAllocationFailedError,

220  CJGuestMediaGatewayIceFailedError,

224  CJGuestSipConfigurationError,

228  CJGuestSipEndpointBusyError,

232  CJGuestInvalidCallStateError,

236  CJGuestTurnCredAcquireFailedError,

240  CJGuestLinkNotFoundError = 50,

244  CJGuestLinkNotValidYetError,

248  CJGuestLinkExpiredError,

252  CJGuestLinkDisabledError,

256  CJGuestHttpError = 1000,

261  CJGuestNetError,

265  CJGuestUnknownError,

266  /*

267  * The version of the API reported by the Jabber Guest server was invalid.

268  */

269  CJGuestInvalidApiVersionError,

270  /*

271  * The version of the API reported by the Jabber Guest server is not supported with this version of the SDK.

272  */

273  CJGuestUnsupportedApiVersionError

274 };

280 @class CJGuestCall;

281 

295 @interface CJGuestCall : NSObject

296 

307 - (id)init;

308 

309 

318 - (id)initWithServerName:(NSString *)serverName toURI:(NSString *)toURI callerName:(NSString*)callerName;

319 

331 @property (nonatomic, readwrite, strong) NSString *serverName;

339 @property (nonatomic, readwrite, strong) NSString *toURI;

343 @property (nonatomic, readwrite, strong) NSString *fullServerUrl;

344 

348 @property (nonatomic, readonly) NSString *remoteDisplayName;

349 

353 @property (nonatomic, readwrite) NSString *callerName;

354 

355 

368 @property (nonatomic, readwrite, strong) IBOutlet UIImageView * selfView;

369 

373 @property (nonatomic, readonly) CGSize selfSize;

374 

378 @property (nonatomic, readwrite, strong) IBOutlet UIImageView * remoteView;

379 

383 @property (nonatomic, readonly) CGSize remoteSize;

384 

388 @property (nonatomic, readwrite, strong) IBOutlet UIImageView * remotePresoView;

389 

393 @property (nonatomic, readonly) CGSize remotePresoSize;

394 

398 @property (nonatomic, readonly) BOOL remotePresoActive;

399 

403 @property (nonatomic, readonly) BOOL selfVideoActive;

404 

408 @property (nonatomic, readonly) BOOL remotePresoStarted;

409 

414 @property (nonatomic, readwrite) UIInterfaceOrientation captureOrientation;

415 

416 #if 0

417 

422 - (BOOL)startSelfView;

423 #endif

424 

430 - (void)startSelfView:(CJGuestVideoLicenseCompletion) completion;

431 

436 - (void)stopSelfView;

437 

441 - (void)switchCamera;

442 

452 #if 0

453 

458 - (BOOL)startCall;

459 #endif

460 

466 - (void)startCall:(CJGuestVideoLicenseCompletion) completion;

467 

473 - (void)endCall;

474 

478 - (void)cancelAutoStartCall;

479 

492 typedef NS_ENUM(NSInteger, CJGuestCallStateType) {

496  GuestCallStateNotInitialized,

497 

502  GuestCallStateDisconnected,

503 

511  GuestCallStateConnecting,

512 

518  GuestCallStateConnected,

519 

526  GuestCallStateDisconnecting

527 };

531 @property (nonatomic, readonly) CJGuestCallStateType callState;

532 

545 typedef NS_ENUM(NSInteger, CJGuestMuteStateType) {

549  GuestMuteStateMuted,

550 

555  GuestMuteStateUnmuting,

556 

560  GuestMuteStateUnmuted,

561 

565  GuestMuteStateMuting

566 };

567 

571 @property (nonatomic, readonly) CJGuestMuteStateType audioOutState;

575 @property (nonatomic, readonly) CJGuestMuteStateType videoOutState;

579 @property (nonatomic, readonly) CJGuestMuteStateType audioInState;

583 @property (nonatomic, readonly) CJGuestMuteStateType videoInState;

584 

585 

590 @property (nonatomic, readonly, getter = isAudioOutMuted) BOOL audioOutMuted;

595 @property (nonatomic, readonly, getter = isAudioOutUnmuted) BOOL audioOutUnmuted;

600 @property (nonatomic, readonly, getter = isAudioInMuted) BOOL audioInMuted;

605 @property (nonatomic, readonly, getter = isAudioInUnmuted) BOOL audioInUnmuted;

610 @property (nonatomic, readonly, getter = isVideoOutMuted) BOOL videoOutMuted;

615 @property (nonatomic, readonly, getter = isVideoOutUnmuted) BOOL videoOutUnmuted;

619 @property (nonatomic, readonly, getter = isVideoControlEnabled) BOOL videoControlEnabled;

624 @property (nonatomic, readonly, getter = isVideoInMuted) BOOL videoInMuted;

629 @property (nonatomic, readonly, getter = isVideoInUnmuted) BOOL videoInUnmuted;

630 

636 - (void)muteAudioOut;

637 

643 - (void)unmuteAudioOut;

644 

650 - (void)muteVideoOut;

651 

657 - (void)unmuteVideoOut;

658 

670 @property (nonatomic, readonly) NSString *sentDTMF;

671 

677 - (void)sendDTMF:(char)dtmf;

678 

686 - (void)sendDTMFString:(NSString *)dtmfString;

687 

701 @property (nonatomic, readwrite, weak) IBOutlet id <CJGuestInvalidCertDelegate> invalidCertDelegate;

702 

708 @property (nonatomic, readwrite, weak) IBOutlet id <CJGuestServerConfiguraionCallDelegate> autoStartCallDelegate;

709 

713 @property (nonatomic, readonly, getter = isReady) BOOL ready DEPRECATED_ATTRIBUTE;

714 

718 @property (nonatomic, readonly, weak) CJGuestAudioStatistics * audioStatistics;

719 

723 @property (nonatomic, readonly, weak) CJGuestVideoStatistics * videoStatistics;

724 

728 @property (nonatomic, readonly, weak) CJGuestVideoStatistics * shareStatistics;

729 

730 

735 @property (nonatomic, readonly, weak) NSString * htmlCallStatistics;

736 

746 - (void)audioSetActive:(BOOL) active;

747 

748 

753 typedef NS_ENUM(NSInteger, CJGuestNetworkStatus) {

754  CJGuestNetworkStatus_Unknown,

755  CJGuestNetworkStatus_Online,

756  CJGuestNetworkStatus_Changed,

757  CJGuestNetworkStatus_Offline

758 };

759 

765 - (void)updateNetworkStatus:(CJGuestNetworkStatus) networkStatus;

766 

775 + (CJGuestCall *)sharedInstance;

776 

783 + (NSDictionary *)parseQueryString:(NSString *)query;

784 

789 + (NSArray * )getAllLogs;

790 

797 + (NSString*)stringFromCallState:(CJGuestCallStateType)state;

798 

805 + (NSString*)stringFromMuteState:(CJGuestMuteStateType)state;

806 

807 

812 + (void)setGlobalLoggingEnabled:(BOOL)enabled;

813 

814 @end