Skip to content

Commit d668eaf

Browse files
committed
Initial commit of the Kinesis Video Producer SDK C++
1 parent eb2f1b4 commit d668eaf

File tree

227 files changed

+52818
-0
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

227 files changed

+52818
-0
lines changed

.gitignore

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
.DS_Store

README.md

Lines changed: 39 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3,3 +3,42 @@ Amazon Kinesis Video Streams Producer SDK Cpp
33
## License
44

55
This library is licensed under the Amazon Software License.
6+
7+
## Introduction
8+
Amazon Kinesis Video Streams Producer SDK for C/C++ enables native code developers to create or easily integrate application with Amazon Kinesis Video.
9+
It contains the following sub-directories/projects:
10+
* 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.
11+
* kinesis-video-producer - The C++ Producer SDK with unit test.
12+
* kinesis-video-producer-jni - The C++ wrapper for JNI to expose the functionality to Java/Android.
13+
* kinesis-video-gst-demo - C++ GStreamer sample application.
14+
* kinesis-video-native-build - Native build directory with a build script for Mac OS. This is the directory that will contain the artifacts after the build.
15+
16+
## Building from Source
17+
After you've downloaded the code from GitHub, you can build it on Mac OS using /kinesis-video-native-build/install-script-mac 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.
18+
19+
### Dependencies
20+
The build depends on
21+
* Autoconf
22+
* Cmake 3.7
23+
* Bison 2.4
24+
* Automake
25+
* xCode (Mac OS) / clang / gcc
26+
27+
## Open Source Dependencies
28+
The projects depend on a number of open source components. Running install-script-mac will download and build the necessary components automatically.
29+
30+
### Launching the sample application / unit test
31+
Define AWS_ACCESS_KEY_ID and AWS_SECRET_KEY_ID environment variables with the AWS access key id and secret key:
32+
`export AWS_ACCESS_KEY_ID={AccessKeyId}`
33+
`export AWS_SECRET_KEY_ID={SecretKeyId}`
34+
35+
### Enabling verbose logs
36+
Define HEAP_DEBUG and LOG_STREAMING C-defines by uncommenting the appropriate lines in CMakeList.txt
37+
38+
## Release Notes
39+
### Release 1.0.0 (November 2017)
40+
* First release of the Amazon Kinesis Video Producer SDK for Cpp.
41+
* Known issues:
42+
* Missing build scripts for Linux-based and Windows-based systems.
43+
* Missing cross-compile option.
44+
* Sample application/unit tests can't handle buffer pressures properly - simple print in debug log.

kinesis-video-gst-demo/README.md

Lines changed: 52 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,52 @@
1+
# Kinesis GStreamer Sample Application which is part of the samples published in GitHub!
2+
3+
This is an sample GStreamer Application with Kinesis Video integration.
4+
5+
## Set up
6+
* Install cmake
7+
8+
```
9+
brew install cmake
10+
```
11+
12+
OR from source, if cmake in brew is not 3.7 (Not sure why we need 3.7): https://cmake.org/install/
13+
14+
* Install GStreamer
15+
16+
```
17+
brew install gstreamer gst-plugins-base gst-plugins-bad gst-plugins-good gst-plugins-ugly
18+
```
19+
20+
* Download dependency repositories
21+
22+
Download the following repositories from GitHub to the same level as kinesis-video-gstreamer-sample-app:
23+
24+
```
25+
git clone https://git-codecommit.us-west-2.amazonaws.com/v1/repos/kinesis-video-producer
26+
git clone https://git-codecommit.us-west-2.amazonaws.com/v1/repos/kinesis-video-pic
27+
git clone https://git-codecommit.us-west-2.amazonaws.com/v1/repos/kinesis-video-native-build
28+
```
29+
30+
The directory structure should look like:
31+
32+
```
33+
$ tree -L 1
34+
.
35+
├── kinesis-video-gstreamer-sample-app
36+
├── kinesis-video-native-build
37+
├── kinesis-video-pic
38+
└── kinesis-video-producer
39+
```
40+
41+
## Build the application
42+
43+
```
44+
cd kinesis-video-native-build
45+
./install-script-mac
46+
```
47+
48+
## Run the application
49+
50+
```
51+
AWS_ACCESS_KEY_ID=AKIASAMPLEKEYID AWS_SECRET_KEY_ID=MYSECRETKEYKID ./gst_demo my-stream-name
52+
```

0 commit comments

Comments
 (0)