added alternative pipeline for x264 enabled devices. added verification for supported streaming resolution

Author: chehefen

README.md

@@ -5,9 +5,9 @@ Amazon Kinesis Video Streams Producer SDK Cpp
 This library is licensed under the Amazon Software License.
 
 ## Introduction
-Amazon Kinesis Video Streams makes it easy to securely stream video from connected devices to AWS for analytics, machine learning (ML), and other processing. 
+Amazon Kinesis Video Streams makes it easy to securely stream video from connected devices to AWS for analytics, machine learning (ML), and other processing.
 
-Amazon Kinesis Video Streams Producer SDK for C/C++ makes it easy to build an on-device application that securely connects to a video stream, and reliably publishes video and other media data to Kinesis Video Streams. It takes care of all the underlying tasks required to package the frames and fragments generated by the device's media pipeline. The SDK also handles stream creation, token rotation for secure and uninterrupted streaming, processing acknowledgements returned by Kinesis Video Streams, and other tasks.  
+Amazon Kinesis Video Streams Producer SDK for C/C++ makes it easy to build an on-device application that securely connects to a video stream, and reliably publishes video and other media data to Kinesis Video Streams. It takes care of all the underlying tasks required to package the frames and fragments generated by the device's media pipeline. The SDK also handles stream creation, token rotation for secure and uninterrupted streaming, processing acknowledgements returned by Kinesis Video Streams, and other tasks.
 
 Amazon Kinesis Video Streams Producer SDK for C/C++ contains the following sub-directories/projects:
 * kinesis-video-pic - The Platform Independent Codebase which is the basic building block for the C++/Java producer SDK. The project includes multiple sub-projects for each sub-component with unit tests.
@@ -19,7 +19,7 @@ Amazon Kinesis Video Streams Producer SDK for C/C++ contains the following sub-d
 ## Building from Source
 There are few build-time tools/dependencies which need to be installed in order to build the core SDK libraries and the samples.
 
-### Build Dependencies 
+### Build Dependencies
 Please install the following additional build tools before proceeding (the example below is for Mac Os X).
 * autoconf 2.69 (License GPLv3+/Autoconf: GNU GPL version 3 or later) http://www.gnu.org/software/autoconf/autoconf.html
 * cmake 3.7/3.8 https://cmake.org/
@@ -30,7 +30,7 @@ Please install the following additional build tools before proceeding (the examp
 * xCode (Mac OS) / clang / gcc (xcode-select version 2347)
 * Java jdk (for Java JNI compilation)
 
-After you've downloaded the code from GitHub, you can build it on Mac OS or Ubuntu using ./kinesis-video-native-build/install-script script. This will produce the core library, the JNI library, unit tests executable and the sample GStreamer application. The script will download and build the dependent open source components in the 'downloads' directory and link against it. 
+After you've downloaded the code from GitHub, you can build it on Mac OS or Ubuntu using ./kinesis-video-native-build/install-script script. This will produce the core library, the JNI library, unit tests executable and the sample GStreamer application. The script will download and build the dependent open source components in the 'downloads' directory and link against it.
 
 **Important:** Set the JAVA_HOME environment variable to your version of the JDK `export JAVA_HOME=<your java home directory>` in order to build and link JNI component.
 
@@ -52,18 +52,18 @@ The projects depend on the following open source components. Running `install-sc
 
 #### GStreamer Demo App
 * gstreamer - https://gstreamer.freedesktop.org/documentation/licensing.html
-* gst-plugins-base 
-* gst-plugins-good 
-* gst-plugins-bad 
+* gst-plugins-base
+* gst-plugins-good
+* gst-plugins-bad
 * gst-plugins-ugly
 * x264 - https://www.videolan.org/developers/x264.html
 
 ## Certificate store integration
-Kinesis Video Streams Produicer SDK for C++ needs to establish trust with the backend service through TLS. This is done through validating the CAs in the public certificate store. On Linux-based models, this store is located in /etc/ssl/ directory by default. 
+Kinesis Video Streams Produicer SDK for C++ needs to establish trust with the backend service through TLS. This is done through validating the CAs in the public certificate store. On Linux-based models, this store is located in /etc/ssl/ directory by default.
 
-Please download the PEM file from 
+Please download the PEM file from
 https://www.amazontrust.com/repository/SFSRootCAG2.pem
- 
+
 to `/etc/ssl/cert.pem`. Append to the end of the file if it exists.
 
 Many platforms come with a cert file with a lot of the well-known public certs in them.
@@ -79,7 +79,12 @@ optionally, set `AWS_SESSION_TOKEN` if integrating with temporary token and `AWS
 * The executable will be built in ./kinesis-video-native-build/start. Launch it and it will run the unit test and kick off dummy frame streaming.
 
 #### GStreamer demo app
-* The GStreamer demo app will be built in kinesis-video-native-build/kinesis_video_gstreamer_sample_app. Launch it with a stream name and it will start streaming from the camera.
+* The GStreamer demo app will be built in kinesis-video-native-build/kinesis_video_gstreamer_sample_app. Launch it with a stream name and it will start streaming from the camera. The user can also supply a streaming resolution through command line arguments.
+ A. If resolution is provided then the sample will try to check if the camera supports that resolution. If it does then streaming starts; else, it will fail
+  with an error msg "Resolution not supported"
+
+ B. If no resolution is specified, the demo will try to use resolutions 1920x1080, 1280x720 and 640x480 in that order (highest resolution first)
+ and will start streaming once the camera supported resolution is detected.
 
 ### Enabling verbose logs
 Define `HEAP_DEBUG` and `LOG_STREAMING` C-defines by uncommenting the appropriate lines in ./kinesis-video-native-build/CMakeList.txt
@@ -172,7 +177,7 @@ warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
 $ curl --version
 curl 7.55.1 (x86_64-pc-linux-gnu) libcurl/7.55.1 OpenSSL/1.0.2g zlib/1.2.11 libidn2/2.0.2 libpsl/0.18.0 (+libidn2/2.0.2) librtmp/2.3
 Release-Date: 2017-08-14
-Protocols: dict file ftp ftps gopher http https imap imaps ldap ldaps pop3 pop3s rtmp rtsp smb smbs smtp smtps telnet tftp 
+Protocols: dict file ftp ftps gopher http https imap imaps ldap ldaps pop3 pop3s rtmp rtsp smb smbs smtp smtps telnet tftp
 Features: AsynchDNS IDN IPv6 Largefile GSS-API Kerberos SPNEGO NTLM NTLM_WB SSL libz TLS-SRP UnixSockets HTTPS-proxy PSL
 
 
@@ -223,7 +228,7 @@ $ls /dev/video* {not found}
 
 $vcgencmd get_camera {output is similar to supported=1 detected=1}
 
-if the driver does not detect the camera then 
+if the driver does not detect the camera then
 
 * Check for the camera setup and whether it's connected properly
 * Run firmware update `$ sudo rpi-update` and restart
@@ -235,7 +240,7 @@ $ls /dev/video* {lists the device}
 
 * Raspberry PI timestamp/range assertion at runtime. Update the Raspberry PI firmware.
 
-$ sudo rpi-update 
+$ sudo rpi-update
 
 $ sudo reboot
 
@@ -246,13 +251,14 @@ $ sudo reboot
 * Raspberry PI seg fauls after some time running on libx264.so. Rebuilding the libx264.so library and re-linking the demo application fixes the issue.
 
 
-* If an USB webcam is used with a Raspberry PI and the webcam does not support 720p. The following error can occur. Reduce the resolution to 480p at line 336 and 356 should fix the problem. (change the number from 1280 and 720 to 640 and 480)
-
-Error received from element source: Internal data stream error.
-Debugging information: gstbasesrc.c(2939): gst_base_src_loop (): /GstPipeline:test-pipeline/GstV4l2Src:source:
-streaming stopped, reason not-negotiated (-4)
-
 ## Release Notes
+### Release 1.1.2 (January 2018)
+* Allowed devices to output h.264 streams directly
+* The user can also supply a streaming resolution through command line arguments.
+	* If resolution is provided then the sample will try to check if the camera supports that resolution. If it does then streaming starts; else, it will fail with an error msg "Resolution not supported"
+	* If no resolution is specified, the demo will try to use resolutions 1920x1080, 1280x720 and 640x480 in that order (highest resolution first)and will start streaming once the camera supported resolution is detected.
+* Known issues:
+	* When streaming on raspberry pi. Some green artifacts might be observed on the preview screen. Reducing the resolution can fix the issue.
 ### Release 1.1.1 (December 2017)
 * Fix USB webcam support
 * Known issues: