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.
- See ci.yml for supported iOS and XCode versions.
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-
Install XCode. You can install XCode from https://developer.apple.com/download/all/
-
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
-
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
installcommand:cd amazon-kinesis-video-streams-webrtc-sdk-ios/Swift pod cache clean --all pod install --repo-update -
Create an Amazon Cognito User Pool. Follow steps 2-3 in the AWS KVS Android WebRTC Repo.
-
To open the project, you can choose between these two methods:
- Open XCode, select "Open a project or file", and choose AWSKinesisVideoWebRTCDemoApp.xcworkspace, OR
- Run the following command from the Swift folder.
xed . -
Open KvsiOSApp/Constants.swift. Set
CognitoIdentityUserPoolRegion,CognitoIdentityUserPoolId,CognitoIdentityUserPoolAppClientId,CognitoIdentityUserPoolAppClientSecretandCognitoIdentityPoolIdto the values obtained in step 3.Example Constants.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
{ "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" } } } -
To build and run, click the play button at the top of the XCode UI.
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:
- 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)
- On successful sign-in, the channel configuration view is displayed where the channel-name, client-id (optional) and region-name have to be configured.
- To run the integration tests, the test user has to be created with the appropriate test password as in the AWSKinesisVideoWebRTCDemoAppUITests/TestConstants.swift file.
- 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.
- 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.
- 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.
- This sample application has been tested in iPhone XS and iPhone 6.
Scripting Bridge could not launch application /Applications/Xcode.app
Check that XCode.app is in your Applications folder.
No such module 'AWSCognitoIdentityProvider'
Open the project by selecting the .xcworkspace file or using the xed . command, not the .xcodeproj file.
Could not build module 'UIKit'
Try reinstalling XCode, restarting your MAC, and reinstalling the Pods. Run the following commands from the same directory containing the Podfile.
rm -rf ~/Library/Caches/CocoaPods
rm -rf Pods
rm -rf ~/Library/Developer/Xcode/DerivedData
pod deintegrate
rm -f Podfile.lock
pod setup
pod install --repo-update
Then, run a clean build in XCode by going to Product > Clean Build Folder (or using ⌘+⇧+K) before clicking the play button.
Could not find module 'AWSMobileClient' for target 'arm64-apple-ios-simulator'; found: x86_64-apple-ios-simulator
Open Build settings.
- In XCode, switch to the file viewer, scroll down and double-click on the Pods with the XCode symbol next to it. At the top, switch the tab to
Build settings, and check thatAllandCombinedare selected.
In the Architectures > Architectures setting, add x86_64.
Alternatively, you can try enabling Rosetta: Finder > Applications > XCode > Get Info > ✓ Enable Rosetta
Terminating app due to uncaught exception 'NSInternalInconsistencyException', reason: 'Invalid region type.'
Double check that Constants.swift contains a valid region. See AWSRegionType for more info.
Unable to create channel. Please validate all the input fields
Check that the values in Constants.swift and awsconfiguration.json are set correctly. See the examples above to ensure your values match the same format.
Additionally, check that the IAM role has the appropriate kinesisvideo permissions.
This library is licensed under the Apache 2.0 License.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent