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
+29-27Lines changed: 29 additions & 27 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -36,19 +36,19 @@ Please install the following additional build tools before proceeding with `./in
36
36
After you've downloaded the code from GitHub, you can build it on Mac OS or Ubuntu using `./install-script` (which is inside the `kinesis-video-native-build` directory).
37
37
38
38
**Important** Change *current working directory* to the `kinesis-video-native-build` directory first. Then run the `./install-script` from that directory.
39
-
39
+
40
40
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 (within `kinesis-video-native-build` directory)and link against it.
41
-
41
+
42
42
#### Build the binaries using system versions
43
-
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 can be used for linking.
43
+
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 can be used for linking.
44
44
45
-
Running
45
+
Running
46
46
47
47
```
48
-
$ cmake .
48
+
$ cmake .
49
49
$ make
50
50
```
51
-
from the `kinesis-video-native-build` directory will build and link the SDK.
51
+
from the `kinesis-video-native-build` directory will build and link the SDK.
52
52
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
53
54
54
#### Build the binaries using the dependent libraries from source
@@ -98,14 +98,14 @@ Many platforms come with a cert file with a lot of the well-known public certs i
98
98
## Install Steps for Ubuntu 17.x using apt-get
99
99
The following are the steps to install the build-time prerequisites for Ubuntu 17.x
***A.** If resolution is provided then the sample will try to check if the camera supports that resolution. If it does detect that the camera can supprt the resolution supplied in command line, then streaming starts; else, it will fail with an error msg `Resolution not supported`
220
-
220
+
221
221
***B.** If no resolution is specified, the demo will try to use these three resolutions **1920x1080, 1280x720 and 640x480** in that order (highest resolution first) and will **start streaming** once the camera supported resolution is detected.
222
222
223
223
#### GStreamer RTSP demo application
@@ -244,7 +244,7 @@ Define `HEAP_DEBUG` and `LOG_STREAMING` C-defines by uncommenting the appropriat
244
244
245
245
#### Additional Examples
246
246
247
-
For additional examples on using Kinesis Video Streams Java SDK and Kinesis Video Streams Parsing Library refer:
247
+
For additional examples on using Kinesis Video Streams Java SDK and Kinesis Video Streams Parsing Library refer:
248
248
249
249
##### [Kinesis Video Streams Producer Java SDK](https://github.com/awslabs/amazon-kinesis-video-streams-producer-sdk-java/blob/master/README.md)
250
250
##### [Kinesis Video Streams Parser Library](https://github.com/aws/amazon-kinesis-video-streams-parser-library/blob/master/README.md)
@@ -257,15 +257,15 @@ For additional examples on using Kinesis Video Streams Java SDK and Kinesis Vid
257
257
### Troubleshooting
258
258
259
259
##### Ubuntu builds link issues
260
-
Ubuntu bulds link against the system versions of the open source component libraries or missing .so files (./start in the kinesis-video-native-build directory shows linkage against system versions of the open source libraries).We are working on providing fix but the immediate steps to remedy is to run
260
+
Ubuntu bulds link against the system versions of the open source component libraries or missing .so files (./start in the kinesis-video-native-build directory shows linkage against system versions of the open source libraries).We are working on providing fix but the immediate steps to remedy is to run
##### Library not found error when running the demo application
@@ -291,7 +291,7 @@ $ls /dev/video*
291
291
{not found}
292
292
```
293
293
```
294
-
$vcgencmd get_camera
294
+
$vcgencmd get_camera
295
295
```
296
296
Example output:
297
297
```
@@ -305,7 +305,7 @@ if the driver does not detect the camera then
305
305
$sudo modprobe bcm2835-v4l2
306
306
```
307
307
```
308
-
$ls /dev/video*
308
+
$ls /dev/video*
309
309
{lists the device}
310
310
```
311
311
@@ -320,7 +320,7 @@ $ sudo reboot
320
320
* Raspberry PI GStreamer assertion on gst_value_set_fraction_range_full: assertion 'gst_util_fraction_compare (numerator_start, denominator_start, numerator_end, denominator_end) < 0' failed. The uv4l service running in the background. Kill the service and restart the sample app.
321
321
322
322
323
-
##### Raspberry PI seg fauls after some time running on `libx264.so`.
323
+
##### Raspberry PI seg fauls after some time running on `libx264.so`.
324
324
Rebuilding the `libx264.so` library and **re-linking the demo application** fixes the issue.
325
325
326
326
##### Curl SSL issue - "unable to get local issuer certificate"
@@ -341,13 +341,15 @@ make install
341
341
342
342
343
343
## Release Notes
344
+
#### Release 1.4.1 (8th May 2018)
345
+
* Update log4cplus download link in install-script
344
346
#### Release 1.4.0 (25th April 2018)
345
347
* Fix for crash caused by latest Mac tool chain issue
346
348
* Fix for callbacks returning incorrect custom data in gstreamer sample app
347
349
* Support for custom logger
348
350
* Fix for multiple callbacks when triggering connection staleness
349
351
#### Release 1.3.1 (5th April 2018)
350
-
* Fixed video source negotiation error caused by camera with fractional fps
352
+
* Fixed video source negotiation error caused by camera with fractional fps
351
353
* Docker suport for RTSP streaming
352
354
#### Release 1.3.0 (15th March 2018)
353
355
* Fixed producer intermittent termination issue for some edge cases involving re-streaming on error.
0 commit comments