Note: If building with the SDK source code, the
developmentbranch contains bleeding-edge changes that may not build with the publically available Chime media library or may not be as stable as public releases.
The Amazon Chime SDK for iOS makes it easy to add collaborative audio calling, video calling, and screen share viewing features to iOS applications by using the same infrastructure services that power meetings on the Amazon Chime service.
This Amazon Chime SDK for iOS works by connecting to meeting session resources that you have created in your AWS account. The SDK has everything you need to build custom calling and collaboration experiences in your iOS application, including methods to: configure meeting sessions, list and select audio devices, switch video devices, start and stop screen share viewing, receive callbacks when media events occur such as volume changes, and manage meeting features such as audio mute and video tile bindings.
To get started, see the following resources:
And review the following guides:
To include the SDK binaries in your own project, follow these steps.
For the purpose of setup, your project's root folder (where you can find your .xcodeproj file) will be referred to as root
Download the following zips:
- if you need bitcode support:
- if you do NOT need bitcode support:
Unzip and copy the .frameworks to root
Open your .xcodeproj file in Xcode and click on your build target. Under Build Settings tab, add $(PROJECT_DIR) to Framework Search Path
Under Build Settings tab, add @executable_path/Frameworks to Runpath Search Paths
Under General tab, look for Frameworks, Libraries, and Embedded Content section. Click on +, then Add Others, then Add Files. Specify the location of AmazonChimeSDK.framework and AmazonChimeSDKMedia.framework from Step 1
After adding the two frameworks, verify that Embed & Sign is selected under the Embed option.
In Build Settings tab, under Linking section, add the following two flags in Other Linker Flags:
-lc++-ObjC
To run the demo application, follow these steps.
git clone git@github.com:aws/amazon-chime-sdk-ios.git
Download the following zip:
Unzip and copy the .framework to AmazonChimeSDK folder
Deploy the serverless demo from amazon-chime-sdk-js
Update AppConfiguration.swift with the URL and region of the serverless demo
On the joining screen, choose to join the meeting without CallKit or join via CallKit incoming/outgoing call. Since the demo app does not have Push Notification, it delays joining via incoming call by 10 seconds to give user enough time to background the app or lock the screen to mimic the behavior.
If you discover a potential security issue in this project we ask that you notify AWS/Amazon Security via our vulnerability reporting page. Please do not create a public GitHub issue.
Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.