Introduction:

RDK-C  C Mobile application will be used to view the watch live streaming and previous from RPI Camera & Previous recordings from RPI Camera stored in Cloud Servers. In this mobile application we use WebRTC protocol for live streaming of video & audio, HTTP to play or download the previous recordings from cloud servers.

RDK-Camera using WebRTC protocol. This mobile app will support android & iOS* platforms. This page is dedicated to bring up the overall picture of the mobile app and how it works.

About WebRTC:

WebRTC, short for Web Real-Time Communication

...

In this mobile application we are using WebRTC  as communication protocol to get the live streaming content from RDK-Camera.

For previous recordings we are using HTTP protocol to get the respective information from the servers and display the previous recordings in the mobile app.

About WebRTC

As we discussed earlier we are using webRTC communication protocol to display live feed from RDK-Camera. In this section we'll get to know about webRTC. So, WebRTC (Web Real-Time Communication) is a technology which enables applications and sites to capture and optionally stream audio and/or video media, as well as to exchange arbitrary data between devices without requiring an intermediary. The set of standards that comprise WebRTC makes it possible to share data and perform teleconferencing peer-to-peer, without requiring that the user install plug-ins or any other third-party software. WebRTC consists of several interrelated APIs and protocols which work together to achieve this.

Application Flow

, is both an API and a Protocol. The WebRTC protocol is a set of rules for two WebRTC agents to negotiate bi-directional secure real-time communication. A similar relationship would be the one between HTTP and the Fetch API. WebRTC the protocol would be HTTP, and WebRTC the API would be the Fetch API.

To establish WebRTC communication one should involve the below 4 steps:

1. Signalling
2. Connecting
3. Securing
4. Communicating

These four steps happen sequentially. The prior step must be 100% successful for the subsequent one to even begin. Each of these steps has dedicated chapters, but it is helpful to understand them at a high level first. Since they depend on each other, it will help when explaining further the purpose of each of these steps.

• Signalling:

            When a WebRTC Agent starts it has no idea who it is going to communicate with and what they are going to communicate about. Signalling solves this issue! Signalling is used to bootstrap the call so that two WebRTC agents can start communicating. Signaling uses an existing protocol SDP (Session Description Protocol). SDP is a plain-text protocol. Each SDP message is made up of key/value pairs and contains a list of “media sections”.

•  Connecting:    

            The two WebRTC Agents now know enough details to attempt to connect to each other. WebRTC then uses another established technology called ICE. ICE (Interactive Connectivity Establishment) is a protocol that pre-dates WebRTC. ICE allows the establishment of a connection between two Agents. These Agents could be on the same network, or on the other side of the world. ICE is the solution to establishing a direct connection without a central server. The real magic here is ‘NAT Traversal’ and STUN/TURN Servers. These two concepts are all you need to communicate with an ICE Agent in another subnet. Once ICE successfully connects, WebRTC then moves on to establishing an encrypted transport. This transport is used for audio, video, and data.

• Securing:

           Now that we have bi-directional communication (via ICE) we need to establish secure communication. This is done through two protocols that pre-date WebRTC. The first protocol is DTLS (Datagram Transport Layer Security) which is just TLS over UDP. TLS is the cryptographic protocol used to secure communication over HTTPS. The second protocol is SRTP (Secure Real-time Transport Protocol). First, WebRTC connects by doing a DTLS handshake over the connection established by ICE. Unlike HTTPS, WebRTC doesn’t use a central authority for certificates. WebRTC then uses a different protocol for audio/video transmission called RTP. We secure our RTP packets using SRTP. We initialize our SRTP session by extracting the keys from the negotiated DTLS session.

• Communicating:

           We now have two WebRTC Agents with secure bi-directional communication. we use two pre-existing protocols: RTP (Real-time Transport Protocol), and SCTP (Stream Control Transmission Protocol).  Use RTP to exchange media encrypted with SRTP, and use SCTP to send and receive DataChannel messages encrypted with DTLS.

Now we are done! You now have bi-directional and secure communication. If you have a stable connection between your WebRTC Agents, this is all the complexity you may need.

Application Architecture (Live streaming)

Image Added

Application Flow (Live streaming)

Image Added

How to Connect:

To view live streaming video from rpi-camera in your mobile mobile you need to follow the below steps

Step 1: Please download the app-release.apk and install in your android device

Step 2: Please follow the steps from this URL to start R-PI camera client and peer connection server

Step 3: After successful completion of step 2, Navigate to Open_WebRTC/openwebrtc-m72/out/Default and ./peerconnection_server hit Enter to start the server

Step 4: SSH into R-PI and enter "./peerconnection_client" which asks for the server IP & Enter Server IP (Your machine IP where peerconnection_server is running) and port number as 8888.

Step 5: Open your mobile app and click on scan in live-feed page to get the list of cameras in your network.

Step 6: Select the camera you want to watch the live feed.

Note: Make sure your R-PI board and mobile app should be in the same network.Image Removed

Mobile App Features

...

1. Live Feed - To get the live footage from the list of selected cameras.
2. Recordings - To get the list of previously recorded footage from cloud.
   1. Today - List of current date recordings
   2. Last week - List of recordings up to 1 week
   3. Custom - List of recordings in b/w selected date range
3. Settings
   1. Camera - Resolution, IP, Storage
   2. User - Add camera, Permissions, Details
   3. Other - Terms & Conditions, Privacy Policy, About, Rating, Logout

Mobile App Screens

Sign-In: User should enter valid email and password to sign in into the application. Click register to register new user.

Sign-up: User should enter valid details then click sign up to register into the application.

Image Modified

Live Feed:Contains the Populates list of available cameras which are registered under the login user. Camera list contains Camera Nick Name, IP address and Camera running status (Red - Offline, Green - Online, Blue - Powering up).in your network which are connected to server and ready to stream the content

Note: To view the list of available cameras in the network user should configure the Server IP and Port in Settings tab > Server IP option

Image AddedImage Added

LiveFeed:  Lists the available camera connections in your network. Click on any camera name to view the live streaming

Image Added

Live Streaming: Playing live streaming video from rpi camera in the mobile app

Image AddedImage Removed

Recordings: In this user can select the specific option such as today, last week and custom range to view the list of recordings stored in the cloud under logged in user id or user name. For custom user should suppose to select start and end date to get the list of recordings. In the list of recordings user can able to see the recording name, recording date and duration of recording.

Image ModifiedImage Modified

Settings: From settings user can able to edit :

1. camera settings such as video resolution for live feed and recordings and IP address, Storage path which is changing the internal storage path for downloading recordings.
2. User settings such as camera access permissions, Adding new camera to the account, editing user details like password etc.
3. Other settings which are app related settings  like terms and conditions, Privacy Policy, About application, App rating, Logout.

Image ModifiedImage Modified