Follow this step-by-step tutorial to implement the Watch Together video chat sample application.
While the client-side application will take care of most of the functionality, in order to make this sample application work, you will need to get an access token from the (CAS).
To better understand the Watch Together architecture have a look at this guide -
Have a look at the
The full code samples can be found here
Requirements
To complete this guide successfully the following prerequisites are required:
A Sceenic account
Authentication
An Access Token is needed in order to allow a client to connect to a Session.
Note: It is important that the client application does not request an Access Token directly from the backend. By doing that you risk exposing the API_TOKEN and API_SECRET.
To simplify the tutorial, in the section below you can see an example of getting an Access Token
Note: Every Streaming Token corresponds to one specific Session only. To allow two different clients to connect to the same Session, the clients need to use the same Access Token.
Going to production
To go to production you will need to implement your own authentication server. Using the server the Access Token will be shared to your various clients (Web, Android, and iOS). With this valid Access Token you will be able to use the service.
For that you will need:
Creating a new project
Open Xcode and create a new project
Choose a Single View application
Configure your product organization, bundle, and team names
Set the application location on your computer and press "create"
Adding Watch Together iOS SDK library to the project
In case you require to use an Objective-c project, please add the WatchTogetherAdapter to your project
Create a folder with the name "WatchTogether" in the root of the project
Copy all files ("WatchTogether.framework","WatchTogether.podspec") to created folder
[When using the Objective-c adapater] - do the following extra steps
Create a folder named "WatchTogetherAdapter" in the root of the project
Copy all the files unpacked from the SDK ("WatchTogetherAdapter.framework","WatchTogetherAdapter.podspec") to "WatchTogetherAdapter" folder
Open folder with your project in Terminal
Print the command "pod init"
Print the command "open Podfile"
In the opened file paste this string pod 'WatchTogether', :path => './WatchTogether'
after "target 'Your project name' do" and save file
[When using the Objective-c adapater] - do the following extra steps
In the opened file paste the following strings
pod 'WatchTogetherAdapter', :path => './WatchTogetherAdapter'
pod 'WatchTogether', :path => './WatchTogether'
In the terminal write the command "pod install"
Disable application Bitcode.
Build Settings → Build Options → Enable Bitcodes → Set to "NO"
To mock a video for the simulator you will need to add an mp4 video file to your main bundle and rename it to simulator_mock.mp4
Granting access to camera and microphone
Go to the info.plist file, add the following properties
Add the property "Privacy - Camera Usage Description" and the value "$(PRODUCT_NAME) uses the camera"
Add the property "Privacy - Microphone Usage Description" and the value "$(PRODUCT_NAME) uses the microphone"
Initialize a Session
Import the library to the view controller
import WatchTogether
@import WatchTogetherAdapter;
Set the minimal log level
Session.setMinLogLevel(.debug)
[SessionAdapter setMinLogLevel:WTALogLevelDebug];
Create a session instance
username - a display name
delegate - an object conforming to SessionDelegate protocol
let session = SessionBuilder()
.withUsername(username)
.withVideoCodec(.H264)
.withVideoRenderer(.Metal)
.withDelegate(self)
.build()