Amazon Kinesis Video iOS WebRTC Sample

[//]: # (Todo: re-enable this once code cov is setup)
[//]: # (())

This sample demonstrates the Amazon Kinesis Video Streams and Kinesis Video Signaling framework found in the AWS Mobile SDK for iOS with Google WebRTC.

For more information, see What Is Amazon Kinesis Video Streams with WebRTC and WebRTC SDK for iOS. You can learn more about Google WebRTC’s native API’s here.

Requirements

• See ci.yml for supported iOS and XCode versions.

Download the WebRTC SDK in iOS

To download the WebRTC SDK in iOS, run the following command:

git clone https://github.com/awslabs/amazon-kinesis-video-streams-webrtc-sdk-ios.git

Using XCode to build the project

1. Install XCode. You can install XCode from https://developer.apple.com/download/all/

2. The AWS Mobile SDK for iOS is available through CocoaPods. If CocoaPods is not installed, install it using the following command. Note that Ruby will also be installed, as it is a dependency of Cocoapods.

   brew install cocoapods
   pod setup

3. The following cocoa pod dependencies are included in the Podfile and need to be pod install‘ed:

   • Starscream
   • Common Crytpo
   • WebRTC.framework: this is the GoogleWebRTC module framework package (bit code disabled).
   • AWSMobileClient
   • AWSCognito
   • AWSKinesisVideo
   • AWSKinesisVideoSignaling

   Change directories to the directory containing the Podfile and run the install command:

   cd amazon-kinesis-video-streams-webrtc-sdk-ios/Swift
   pod cache clean --all
   pod install --repo-update

4. Create an Amazon Cognito User Pool. Follow steps 2-3 in the AWS KVS Android WebRTC Repo.

5. To open the project, you can choose between these two methods:

   1. Open XCode, select “Open a project or file”, and choose AWSKinesisVideoWebRTCDemoApp.xcworkspace, OR
   2. Run the following command from the Swift folder.

      xed .

6. Open KvsiOSApp/Constants.swift. Set CognitoIdentityUserPoolRegion, CognitoIdentityUserPoolId, CognitoIdentityUserPoolAppClientId, CognitoIdentityUserPoolAppClientSecret and CognitoIdentityPoolId to the values obtained in step 3.

   
   

   Example Constants.swift

   
   
   swift let cognitoIdentityUserPoolRegion = AWSRegionType.USWest2 let cognitoIdentityUserPoolId = "us-west-2_qRsTuVwXy" let cognitoIdentityUserPoolAppClientId = "0123456789abcdefghijklmnop" let cognitoIdentityUserPoolAppClientSecret = "abcdefghijklmnopqrstuvwxyz0123456789abcdefghijklmno" let cognitoIdentityPoolId = "us-west-2:01234567-89ab-cdef-0123-456789abcdef"
   
   

   Open KvsiOSApp/awsconfiguration.json and replace the “REPLACEME” values with the values obtained earlier.

   
   

   Example awsconfiguration.json

   
   
   json { "Version": "1.0", "CredentialsProvider": { "CognitoIdentity": { "Default": { "PoolId": "us-west-2:01234567-89ab-cdef-0123-456789abcdef", "Region": "us-west-2" } } }, "IdentityManager": { "Default": {} }, "CognitoUserPool": { "Default": { "AppClientSecret": "abcdefghijklmnopqrstuvwxyz0123456789abcdefghijklmno", "AppClientId": "0123456789abcdefghijklmnop", "PoolId": "us-west-2_qRsTuVwXy", "Region": "us-west-2" } } }
   
   

7. To build and run, click the play button at the top of the XCode UI.

Run the iOS Sample Application

Building the iOS sample application installs the AWSKinesisVideoWebRTCDemoApp on your iOS device. Using this app, you can verify live audio/video streaming between mobile, web and IoT device clients (camera). The procedure below describes some of these scenarios.

Complete the following steps:

1. On your iOS device, open AWSKinesisVideoWebRTCDemoApp and login using the AWS user credentials from Set Up an AWS Account and Create an Administrator. (Note: Cognito settings can be tuned through your Cognito User Pool in the AWS management Console)
2. On successful sign-in, the channel configuration view is displayed where the channel-name, client-id (optional) and region-name have to be configured.

Run the Integration Tests

1. To run the integration tests, the test user has to be created with the appropriate test password as in the AWSKinesisVideoWebRTCDemoAppUITests/TestConstants.swift file.

Note

• Ensure that in all the cases described below, both the client applications use the same signaling channel name, region, viewer-id/client-id and the AWS account id.
• Please note that a master should be started first before the viewer connects to it.

Peer to Peer Streaming between two iOS devices: master and viewer:

• Start one iOS device in master mode for starting a new session using a channel name (e.g. demo). Remote peer will be joining as viewer to this master.
• Currently, there can be only one master for a channel at any given time.
• Use another iOS device to connect to the same channel name (started up in the above step set up as a master) in viewer mode. This will connect to an existing session (channel) where a master was connected previously.

Peer to Peer Streaming between Embedded SDK master and iOS device:

• Run KVS WebRTC embedded SDK (in C) in master mode on a camera device.
• Start the iOS device in viewer mode – you should be able to see the local video preview in the lower right side of the screen and also the larger part of the screen should stream the remote video view.

Peer to Peer Streaming between iOS device as master and Web browser as viewer:

• Start one iOS device in master mode for starting a new session using a channel name (e.g. demo)
• Start the Web Browser using the Javascript SDK (JS with audio selected) and start it as viewer.
• Verify media showing up from the iOS device and also from the browser.

Note

• This sample application has been tested in iPhone XS and iPhone 6.

Troubleshooting

License

This library is licensed under the Apache 2.0 License.