You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+10
Original file line number
Diff line number
Diff line change
@@ -1,4 +1,9 @@
1
1
### Amazon Kinesis Video Streams Producer SDK C/C++
2
+
----
3
+
### Attention
4
+
----
5
+
If you are updating from any release before 1.7.0, you need to specify a track id for each Frame as shown in [sample](https://github.com/awslabs/amazon-kinesis-video-streams-producer-sdk-cpp/blob/master/kinesis-video-gst-demo/kinesis_video_gstreamer_sample_app.cpp#L312), otherwise you will get a 0x32000026 which means track not found.
6
+
2
7
----
3
8
### Introduction
4
9
----
@@ -45,6 +50,10 @@ This library is licensed under the Amazon Software License.
45
50
----
46
51
### Release notes
47
52
53
+
#### Release 1.7.8 (6th Mar 2019)
54
+
* Updated CMakeLists.txt and install scripts to be able to link against libraries in default system path.
55
+
* Optimization and bug fixes.
56
+
48
57
#### Release 1.7.7 (22th Feb 2019)
49
58
* Stability and bug fixes.
50
59
@@ -68,6 +77,7 @@ This library is licensed under the Amazon Software License.
68
77
* stability fixes.
69
78
70
79
#### Release 1.7.0 (14th Dec 2018)
80
+
* Applications need to specify a trackId for every Frame as shown in create_kinesis_video_frame function in the samples
71
81
* Added support for uploading files(offline mode) to Kinesis Video Stream
Copy file name to clipboardExpand all lines: install-instructions-linux.md
+27-76
Original file line number
Diff line number
Diff line change
@@ -34,6 +34,8 @@ Many platforms come with a cert file with a lot of the well-known public certs i
34
34
----
35
35
### Build the Kinesis Video Producer SDK and sample applications:
36
36
37
+
##### Build the SDK and sample applications using open source library dependencies built from source
38
+
37
39
The **install-script** will download and build the dependent open source components (from the source) into the **downloads** directory within `kinesis-video-native-build` directory (e.g. `/home/<myuser>/downloads/amazon-kinesis-video-streams-producer-sdk-cpp/kinesis-video-native-build/downloads`) and link against it.
38
40
39
41
**After you've downloaded the code from GitHub, you can build it on Linux by running `./install-script` (which is inside the `kinesis-video-native-build` directory)**.
@@ -44,73 +46,32 @@ The **install-script** will download and build the dependent open source compone
44
46
45
47
Note that the install-script also builds the Kinesis Video Streams producer SDK as a **GStreamer plugin** (**kvssink**).
46
48
47
-
----
48
49
##### Alternate option to build the SDK and sample applications using system versions of open source library dependencies
49
50
50
-
The bulk of the **install-script** is building the open source dependencies. The project is based on **CMake**. So the open source components building can be skipped if the system versions of the open source dependencies are already installed that can be used for linking. See the section **Install Steps for Ubuntu 17.x using apt-get** for detailed instructions on how to install using `apt-get install` on **Ubuntu** .
51
+
The bulk of the **install-script** is building the open source dependencies. The project is based on **CMake**. So the open source components building can be skipped if the system versions of the open source dependencies are already installed that can be used for linking. See the section **Install Steps for Ubuntu 17.x and Raspbian Stretch using apt-get** for detailed instructions on how to install using `apt-get install` on **Ubuntu** .
51
52
52
-
Running
53
-
54
-
```
55
-
$ cmake .
56
-
$ make
57
-
```
58
-
from the `kinesis-video-native-build` directory will build and link the SDK.
59
-
60
-
The `./min-install-script` inside the `kinesis-video-native-build` captures these steps for installing the Kinesis Video Streams Producer SDK with the system versions for linking.
53
+
The `./min-install-script` inside the `kinesis-video-native-build` captures these steps for building the Kinesis Video Streams Producer SDK with the system versions for linking.
61
54
62
55
##### Optionally build the native library (KinesisVideoProducerJNI) to run Java demo streaming application
63
56
64
57
The `./java-install-script` inside `kinesis-video-native-build` will build the KinesisVideoProducerJNI native library to be used by [Java Producer SDK](https://github.com/awslabs/amazon-kinesis-video-streams-producer-sdk-java/blob/master/README.md).
65
58
66
59
----
67
60
68
-
### Install Steps for Ubuntu 17.x using apt-get
69
-
70
-
The following section provides guidance for installing the build tools and open source dependencies using `apt-get` in **Ubuntu Linux**.
61
+
### Install Steps for Ubuntu 17.x and Raspbian Stretch using apt-get
71
62
72
-
The following are the steps to install the build-time prerequisites for Ubuntu 17.x
63
+
The following section provides guidance for installing the build tools and open source dependencies using `apt-get` and has been tested in **Ubuntu Linux** and **Raspbian Stretch**.
73
64
74
65
Install **git**:
75
66
76
67
```
68
+
$ sudo apt-get update
77
69
$ sudo apt-get install git
78
-
$ git --version
79
-
git version 2.14.1
80
70
```
81
71
Install **cmake**:
82
72
```
73
+
sudo apt-get update
83
74
$ sudo apt-get install cmake
84
-
$ cmake --version
85
-
cmake version 3.9.1
86
-
```
87
-
88
-
CMake suite maintained and supported by Kitware (kitware.com/cmake).
89
-
90
-
Install **libtool**: (some images come preinstalled) amd **libtool-bin**
91
-
```
92
-
$ sudo apt-get install libtool
93
-
$ sudo apt-get install libtool-bin
94
-
$ libtool --version
95
-
libtool (GNU libtool) 2.4.6
96
-
Written by Gordon Matzigkeit, 1996
97
-
98
-
Copyright (C) 2014 Free Software Foundation, Inc.
99
-
This is free software; see the source for copying conditions. There is NO
100
-
warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
101
-
```
102
-
Install **automake**:
103
-
```
104
-
$ sudo apt-get install automake
105
-
$ automake --version
106
-
automake (GNU automake) 1.15
107
-
Copyright (C) 2014 Free Software Foundation, Inc.
108
-
License GPLv2+: GNU GPL version 2 or later <http://gnu.org/licenses/gpl-2.0.html>
109
-
This is free software: you are free to change and redistribute it.
110
-
There is NO WARRANTY, to the extent permitted by law.
* The `gst-launch-1.0` and `gst-inspect-1.0` binaries are built inside the folder `<YourSdkFolderPath>/kinesis-video-native-build/downloads/local/bin`. You can either run the following commands from that folder using `./gst-launch-1.0` or you can include that in your **PATH** environment variable using the following export command and run `gst-launch-1.0`
144
+
*(Skip this if you installed gstreamer using apt-get) The `gst-launch-1.0` and `gst-inspect-1.0` binaries are built inside the folder `<YourSdkFolderPath>/kinesis-video-native-build/downloads/local/bin`. You can either run the following commands from that folder using `./gst-launch-1.0` or you can include that in your **PATH** environment variable using the following export command and run `gst-launch-1.0`
Copy file name to clipboardExpand all lines: install-instructions-macos.md
+10-14
Original file line number
Diff line number
Diff line change
@@ -29,14 +29,6 @@ In order to build the Producer SDK and download open source dependencies the fol
29
29
_**Note:**_ If you have installed these build tools using `brew` you need to set the PATH environment variable to include the installed location.
30
30
e.g. To incldue the latest `bison` you can run `export PATH=/usr/local/Cellar/bison/3.0.4_1/bin/:$PATH`
31
31
32
-
##### Install the certificate in the operating system certificate store
33
-
Kinesis Video Streams Producer 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.
34
-
35
-
Please download the PEM file from [SFSRootCAG2.pem](https://www.amazontrust.com/repository/SFSRootCAG2.pem)
36
-
to `/etc/ssl/cert.pem`. If the file already exists `/etc/ssl/cert.pem` then you can append it by running `sudo cat SFSRootCAG2.pem >> /etc/ssl/cert.pem`.
37
-
38
-
Many platforms come with a cert file with a lot of the well-known public certs in them.
39
-
40
32
----
41
33
### Build the Kinesis Video Producer SDK and sample applications:
42
34
The **install-script** will download and build the dependent open source components (from the source) into the **downloads** directory within `kinesis-video-native-build` directory (e.g. `/Users/<myuser>/downloads/amazon-kinesis-video-streams-producer-sdk-cpp/kinesis-video-native-build/downloads`) and link against it.
@@ -50,15 +42,19 @@ The **install-script** will download and build the dependent open source compone
50
42
Note that the install-script also builds the Kinesis Video Streams producer SDK as a **GStreamer plugin** (**kvssink**).
51
43
52
44
----
53
-
#####Alternate option to build the SDK and sample applications using system versions of open source library dependencies
45
+
### Alternate option to build the SDK and sample applications using libraries installed by Homebrew
54
46
55
47
The bulk of the **install script** is building the open source dependencies. The project is based on **CMake**. So the open source components building can be skipped if the system versions of the open source dependencies are already installed that can be used for linking.
56
48
57
-
Running
49
+
First make sure that the following libraries have been installed using Homebrew
Copy file name to clipboardExpand all lines: install-instructions-windows-msys2.md
+4-4
Original file line number
Diff line number
Diff line change
@@ -45,8 +45,8 @@ Now the MingW shell prompt will look similar to the one below.
45
45
$
46
46
```
47
47
48
-
###### Step 6: Build the Kinesis Video Streams Producer SDK using msys2-install-script.
49
-
Build the SDK by running the command `./msys2-install-script -a`
48
+
###### Step 6: Build the Kinesis Video Streams Producer SDK using min-install-script.
49
+
Build the SDK by running the command `./min-install-script`
50
50
Press Enter to all prompts that show up during the install the process. When the install script finishes, the demo executables and libraries will be in the kinesis-video-native-build directory. Please note that this step could take about **25 mins**.
0 commit comments