IOS

Code samples

Learn how to enable Push Notifications, create a Chat room, authenticate users via Facebook, show users' locations and POIs, store and retrieve files from the cloud - these code samples are really simple so that even beginner developers can understand:

Title	APIs used	Description
Simple iOS VideoChat (video calling) code sample	Chat,	The VideoChat code sample allows to easily add video calling feature in your iOS app. Enable video calls functionality similar to FaceTime or Skype using this code sample as a basis.
Simple iOS Chat code sample	Chat, Users	The Chat sample connects and socializes your users with the chat module. Features include: Peer to Peer Chat; Group chat; Location based chat; Push notification for offline users.
Simple iOS Custom Objects (key value data store) code sample	Сustom Objects	This Custom Objects sample allows to create any server side data structure, use it as you want, create any logic and a lot of others custom features.
Simple iOS Location code sample	Location, Users	The Location sample connects app users with each other and their environment. Using GPS locations, map integrations and local data, end users can literally 'see' each other on the map and engage with other users
Simple iOS Push Notifications (Messages) code sample	Messages	Push notifications to your user base — even when your app is not running! This sample enables you to send notifications and alerts to users at any time through an API or easy-to-use admin panel. You can filter who you send messages to through additional parameters.
Simple iOS Users authentication (Facebook, Twitter, OAuth integration) code sample	Users	The Users sample helps you manage and retain your user base across all platforms. It includes a simple authentication process with Single Sign-On and integration across all popular platforms, social integration with Twitter/Facebook
Simple iOS leaderboard / high scores / star ratings code sample	Ratings	High scores, leaderboards and star ratings — all made easy with Ratings sample. Create an interactive ranking element to your app with this sample, highlight users results, show nearest competitors.
Simple iOS content storage and update code sample	Content	The Content sample allows send, stream, store, share and save content, update your app's content without having to republish.

How to: add SDK to Xcode and connect to the cloud

Please see tutorial.

Read on: iOS SDK documentation

Full reference on classes and protocols used in QuickBlox iOS SDK:
Quickblox iOS SDK framework documentation

Download iOS SDK

Quickblox iOS SDK, version 1.5.2

Framework changelog:

v1.5.2 — May 11, 2013

• removed internal access to UDID
• Users: added method to QBUsers usersWithPhoneNumbers: - allows to retrieve users by phone numbers
• fixed 12h datetime format issue

v1.5.1 — March 12, 2013

• Chat: added method to QBChat requestRoomOnlineUsers: – allows to retrieve room online users
• Chat: added isJoined property to QBChatRoom
• Chat: Unsupported symbols now will be removed from room name. You can validate room name using [QBChat roomNameToValidRoomName:roomName]
• Chat: added method to QBChat destroyRoom: – allows to delete room
• VideoChat: added muteVideoChat property to QBChat - allows to mute microphone during video conference.
• Users: added method to QBUsers usersWithLogins: - allows to retrieve users by logins
• Users: added method to QBUsers usersWithEmails: - allows to retrieve users by emails
• Now you can manage timeout for queries [QBSettings setTimeOutSeconds:10]

v1.5 — February 20, 2013

• Added VideoChat API
• QBChat: replaced method – (void)chatRoomDidEnter:(NSString *)room with – (void)chatRoomDidEnter:(QBChatRoom *)room
• QBChatDelegate: Now you dont need to use – (void)chatRoomDidCreate:(QBChatRoom*)room. In all cases (create or join room) chatRoomDidEnter method will be called
• QBChat: Added new method for room creation: – (void)createOrJoinRoomWithName:(NSString *)name membersOnly:(BOOL)isMembersOnly persistent:(BOOL)isPersistent. Old methods marked as deprecated.

v1.4.1 — January 9, 2013

• Added notification when social login dialog was closed – QuickbloxSocialDialogDidCloseNotification
• QBChatDelegate now is retained
• Added [QBSettings useProductionEnvironmentForPushNotifications:YES] to manage Push Notifications environment

v1.4 — December 11, 2012

• CustomObjects: added method 'objectWithClassName:ID:' to QBCustomObjects class – allows to retrieve single object
• CustomObjects: added Array type
• CustomObjects: added special update operators
• CustomObjects: added relations API
• Social API: added 'scope' param: replaced QBUsers’s method 'logInWithSocialProvider:delegate:' with 'logInWithSocialProvider:scope:delegate:'
• Social API: now you can auth using Social provider access token
• Chat: added method to QBChatDelegate 'chatRoomDidChangeOnlineUsers:room:'
• Chat: added method to QBChat 'requestRoomUsers' – allows to retrieve room members
• Users: added to QBUsers method 'usersWithIDs' – allows to retrieve users by ids
• Users: QBUUser.tags – property type changed from NSArray to NSMutableArray
• Messages: added methods to send push notification without environment
• Messages: added method to class QBMessages 'TSendPushWithText' – simple way to send push – juts write text & send
• Auth: Create session with device parameters is deprecated. Now you don’t need to create session with device parameters in order to use Push Notifications

v1.3.1 — October 26, 2012

• Now delegate is retained
• Allow to pass any object (not only NSString) to custom object’s fields
• New great design for the Facebook login dialog
• Added a new method ‘createPrivateRoomWithName:(NSString *)name’ to QBChat class. It allows to create only members rooms.

v1.3.0 — October 2, 2012

• New Chat JID format (without user's login) (http://quickblox.com/developers/Chat)
• NSCopying, NSCoding protocols for all models are implemented
• isEqual method for all models is implemented
• Added a convenient constructor to class Request and all inherited classes ([Request request])
• Added a method to Messages API for stop receive Push Notifications - [QBMessages TUnregisterSubscriptionWithDelegate:self];
• Added a method to Messages API for sending Push Notifications to users with tags - [QBMessages TSendPush:message toUsersWithAnyOfTheseTags:@"man, car" isDevelopmentEnvironment:YES delegate:self];
• Added a property 'enableSessionExpirationAutoHandler' to QBSettings class for enable auto handling session expiration
• C2DM enum was renamed to GCM
• QBMPushEvent class was renamed to QBMApplePushEvent
• Chat API was refactored
• SBJSON was hidden
• Updated Content Tags API
• iOS 6 compatibility

v1.2.0 — August 27, 2012

• Added Custom Objects API
• Added Content tags API
• Social API now returns social provider's access token & token's expiration date. No you can work with FB/Twitter API without fb/twitter sdk!

v1.1.0 — August 09, 2012

• Added Social API. Now you can authenticate through QuickBlox Users module using your Facebook/Twitter account.
• Added 'lastRequestAt' field to QBUUser
• Added 'blob' field to QBCFileDownloadTaskResult
• Added Chat module snippets

v1.0.0 — July 24, 2012

• SDK stable version
• All API calls are covered

Comments

Feel free to comment on this page using the form below.

blog comments powered by Disqus