Gruveo SDK for iOS

The Gruveo SDK for iOS and a sample project.

Pod Installation

To add the Gruveo SDK for iOS to your app, you will need CocoaPods, which is a dependency manager for Objective-C. You can install CocoaPods with the following command:

$ gem install cocoapods

Podfile

To integrate the Gruveo SDK into your Xcode project using CocoaPods, add the GruveoSDK pod to your Podfile:

source 'https://github.com/CocoaPods/Specs.git'
platform :ios, '9.0'

target 'TargetName' do
pod 'GruveoSDK'
end

Then, run the following command:

$ pod install

Application Setup and Usage

1. Add NSCameraUsageDescription and NSMicrophoneUsageDescription to your application's Info.plist
2. Set “Enable Bitcode” to NO in Target -> Build Settings -> Enable Bitcode
3. Check the "Audio, AirPlay, and Picture in Picture" checkbox under Capabilities -> Background Modes
4. Import GruveoSDK to the AppDelegate and your ViewController class:

   @import GruveoSDK;

5. Register your сlient ID after application startup:

   [GruveoCallManager setClientId:@"demo”]

6. Set delegate for GruveoCallManager in the viewDidLoad function:

   [GruveoCallManager setDelegate:self]

7. Implement creation of the Gruveo call screen:

   [GruveoCallManager callCode:@"hello" videoCall:YES onViewController:self callCreationCompletion:^(CallInitError creationError) {
   if (creationError != CallInitErrorNone) {
       // Show error here
   }
   }];

8. Implement the delegate function for token signing. Warning: The sample implementation below uses a signing endpoint provided by Gruveo and will only work for the demo client ID:

   - (void)requestToSignApiAuthToken:(NSString *)token {
   NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:[NSURL URLWithString:@"https://api-demo.gruveo.com/signer"]];
   [request setHTTPMethod:@"POST"];
   [request setValue:@"text/plain" forHTTPHeaderField:@"Content-Type"];
   [request setHTTPBody:[token dataUsingEncoding:NSUTF8StringEncoding]];
   
   NSURLSessionConfiguration *configuration = [NSURLSessionConfiguration defaultSessionConfiguration];
   NSURLSession *session = [NSURLSession sessionWithConfiguration:configuration delegate:nil delegateQueue:nil];
   
   [[session dataTaskWithRequest:request completionHandler:^(NSData *data, NSURLResponse *response, NSError *error) {
       if ([data isKindOfClass:[NSData class]]) {
           NSString *signedToken = [[NSString alloc] initWithData:data encoding:NSUTF8StringEncoding];
           [GruveoCallManager authorize:signedToken];
       } else {
           [GruveoCallManager authorize:nil];
       }
   }] resume];
   }

9. Implement the other useful delegate functions:

   - (void)callEstablished {}
   - (void)callEnd:(GruveoCallEndReason)reason {}
   - (void)recordingStateChanged {}

10. Build and run your application.