88 lines
4.0 KiB
Markdown
88 lines
4.0 KiB
Markdown
|
# Azure Kinect SDK (K4A)
|
||
|
|
|
||
|
|
Welcome to the Azure Kinect Sensor SDK! We hope you can use it to build many great applications and participate in the project. Don't be shy to ask questions, and provide feedback. See [Azure.com/Kinect](https://Azure.com/kinect) for device
|
||
|
|
info and available documentation.
|
||
|
|
|
||
|
|
[?branchName=develop)](https://dev.azure.com/ms/Azure-Kinect-Sensor-SDK/_build/latest?definitionId=133&branchName=develop)
|
||
|
|
[](https://www.nuget.org/packages/Microsoft.Azure.Kinect.Sensor/)
|
||
|
|
|
||
|
|
## Introduction
|
||
|
|
|
||
|
|
**Azure Kinect SDK** is a cross platform (Linux and Windows) user mode SDK to read data from your Azure Kinect device.
|
||
|
|
|
||
|
|
## Why use the Azure Kinect SDK
|
||
|
|
|
||
|
|
The Azure Kinect SDK enables you to get the most out of your Azure Kinect camera. Features include:
|
||
|
|
|
||
|
|
* Depth camera access
|
||
|
|
* RGB camera access and control (e.g. exposure and white balance)
|
||
|
|
* Motion sensor (gyroscope and accelerometer) access
|
||
|
|
* Synchronized Depth-RGB camera streaming with configurable delay between cameras
|
||
|
|
* External device synchronization control with configurable delay offset between devices
|
||
|
|
* Camera frame meta-data access for image resolution, timestamp and temperature
|
||
|
|
* Device calibration data access
|
||
|
|
|
||
|
|
## Installation
|
||
|
|
|
||
|
|
To use the SDK, please refer to the installation instructions in [usage](docs/usage.md)
|
||
|
|
|
||
|
|
## Documentation
|
||
|
|
|
||
|
|
API documentation is avaliable [here](https://microsoft.github.io/Azure-Kinect-Sensor-SDK/).
|
||
|
|
|
||
|
|
## Building
|
||
|
|
|
||
|
|
Azure Kinect SDK uses CMake to build. For instructions on how to build this SDK please see
|
||
|
|
[building](docs/building.md).
|
||
|
|
|
||
|
|
## Versioning
|
||
|
|
|
||
|
|
The Azure Kinect SDK uses semantic versioning, please see [versioning.md](docs/versioning.md) for more information.
|
||
|
|
|
||
|
|
## Testing
|
||
|
|
|
||
|
|
For information on writing or running tests, please see [testing.md](docs/testing.md)
|
||
|
|
|
||
|
|
## Contribute
|
||
|
|
|
||
|
|
We welcome your contributions! Please see the [contribution guidelines](CONTRIBUTING.md).
|
||
|
|
|
||
|
|
## Feedback
|
||
|
|
|
||
|
|
For SDK feedback or to report a bug, please file a [GitHub Issue](https://github.com/Microsoft/Azure-Kinect-Sensor-SDK/issues). For general suggestions or ideas, visit our [feedback forum](https://aka.ms/azurekinectfeedback).
|
||
|
|
|
||
|
|
## Sample Code
|
||
|
|
|
||
|
|
There are several places where the sample code can be found.
|
||
|
|
|
||
|
|
- In this repository: [Azure-Kinect-Sensor-SDK\examples](https://github.com/microsoft/Azure-Kinect-Sensor-SDK/tree/develop/examples)- each example has a readme page that describes it and the steps to set it up.
|
||
|
|
- [Azure-Kinect-Samples](https://github.com/microsoft/Azure-Kinect-Samples) repository. There are multiple examples of how to use both Sensor and Body tracking SDKs.
|
||
|
|
|
||
|
|
## Q&A
|
||
|
|
|
||
|
|
Welcome to the [Q&A](kinect-qa.md) corner!
|
||
|
|
|
||
|
|
## Join Our Developer Program
|
||
|
|
|
||
|
|
Complete your developer profile [here](https://aka.ms/iwantmr) to get connected with our Mixed Reality Developer Program. You will receive the latest on our developer tools, events, and early access offers.
|
||
|
|
|
||
|
|
## Code of Conduct
|
||
|
|
|
||
|
|
This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).
|
||
|
|
For more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/)
|
||
|
|
or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.
|
||
|
|
|
||
|
|
## Reporting Security Issues
|
||
|
|
Security issues and bugs should be reported privately, via email, to the
|
||
|
|
Microsoft Security Response Center (MSRC) at <[secure@microsoft.com](mailto:secure@microsoft.com)>.
|
||
|
|
You should receive a response within 24 hours. If for some reason you do not, please follow up via
|
||
|
|
email to ensure we received your original message. Further information, including the
|
||
|
|
[MSRC PGP](https://technet.microsoft.com/en-us/security/dn606155) key, can be found in the
|
||
|
|
[Security TechCenter](https://technet.microsoft.com/en-us/security/default).
|
||
|
|
|
||
|
|
## License and Microsoft Support for Azure Kinect Sensor SDK
|
||
|
|
|
||
|
|
[MIT License](LICENSE)
|
||
|
|
|
||
|
|
[Microsoft Support for Azure Kinect Sensor SDK](microsoft-support.md)
|