(ref-sdks)=
# Anbox Cloud SDKs

Anbox Cloud provides a series of Software Development Kits (SDKs) to facilitate integrating and extending Anbox Cloud for different use cases:

- Anbox Platform SDK
- AMS SDK
- Anbox Streaming SDK

(sec-platform-sdk)=
## Anbox Platform SDK

The Anbox Platform SDK provides support for developing custom platform plugins, which allows cloud providers to integrate Anbox with their existing infrastructure. The SDK provides several integration points for things like rendering, audio or input processing.

For more details about custom platform plugins, refer to the [Anbox Platform SDK API documentation](https://canonical.github.io/anbox-cloud.github.com/latest/anbox-platform-sdk/).

### Download and installation

The Anbox Platform SDK can be downloaded via Git from GitHub:

    git clone https://github.com/canonical/anbox-platform-sdk.git

You need the following build dependencies:

    sudo apt install -y --no-install-recommends cmake build-essential ninja-build dh-exec cmake-extras libgmock-dev libelf-dev

### Examples

The Anbox Platform SDK provides a collection of example platform plugins to help developers get started with plugin development. The following examples are included:

* `minimal` - A platform plugin that provides a sample implementation of a minimal platform plugin to demonstrate the general plugin layout.
* `audio_streaming` - A platform plugin that provides a more advanced example of how a platform plugin can process audio and input data.

(sec-ams-sdk)=
## AMS SDK

The AMS SDK offers a set of [Go](https://golang.org/) packages and utilities for any external [Go](https://golang.org/) code to be able to connect to the AMS service through the exposed REST API.

See the [AMS SDK documentation](https://github.com/canonical/ams-sdk) on GitHub for more information.

### Download and installation

The AMS SDK can be downloaded via Git from GitHub:

    git clone https://github.com/canonical/ams-sdk.git

To start using the SDK, simply add the content of the provided SDK zip file into your projects `vendor/` directory or your `GOPATH`.

### Examples

The AMS SDK comes with a set of examples demonstrating the capabilities of the SDK. You can find them in the `examples` directory of the AMS source.

### Authentication setup

Clients must authenticate to AMS before communicating with it. For more information, see {ref}`howto-access-ams-remote` and the [AMS SDK documentation](https://github.com/canonical/ams-sdk) on GitHub.

(sec-streaming-sdk)=
## Anbox Cloud Streaming SDK

The Anbox Cloud streaming SDK allows the development of custom streaming clients using JavaScript. This SDK handles all aspects of streaming, from the WebRTC protocol to handling controls, game pads, speakers and screen resolutions.

Under the hood, the SDK is actually comprised of two components:

* The connector that communicates to the stream backend (either the stream gateway or your own middleware) and initiates the WebRTC setup.
* The stream class that displays the video and audio feed, handle controls, life-cycle events and more.

Having these two components makes it easier to plug your own software in the SDK rather than having to re-write everything again.

### Features

| Feature                                          | JavaScript SDK |
|--------------------------------------------------|:--------------:|
| Video streaming                                  |        ✓       |
| Audio streaming                                  |        ✓       |
| Microphone support                               |        ✓       |
| Dynamically change Android foreground activity   |        ✓       |
| Send commands to the Android container           |        ✓       |
| Game pad support                                 |        ✓       |
| Camera support                                   |        ✓       |
| Pointer lock (Experimental)                                     |        ✓       |
| Sensor support                                   |                 |
| Location support                                 |        ✓       |
| Supported platforms                              |       All       |
| Zero Copy rendering and decoding                 |        ✓       |
| Supported video codecs                           | VP8, H.264, AV1 |

### Download and installation

To use the Anbox Cloud streaming SDK, you must have deployed the Anbox Streaming Stack. See {ref}`howto-deploy-anbox-juju` for more information.

You can download the Anbox Cloud streaming SDK via Git from GitHub:

    git clone https://github.com/canonical/anbox-streaming-sdk.git

### Examples

The Anbox Cloud streaming SDK comes bundled with examples to help you get started. They are located in the `examples` directory.