dropLin ad780f763e first commit		vor 6 Tagen
..
.fleet	ad780f763e first commit	vor 6 Tagen
.idea	ad780f763e first commit	vor 6 Tagen
composeApp	ad780f763e first commit	vor 6 Tagen
docs	ad780f763e first commit	vor 6 Tagen
gradle	ad780f763e first commit	vor 6 Tagen
iosApp	ad780f763e first commit	vor 6 Tagen
protobuf	ad780f763e first commit	vor 6 Tagen
simplifiedApp	ad780f763e first commit	vor 6 Tagen
tools	ad780f763e first commit	vor 6 Tagen
wsdk	ad780f763e first commit	vor 6 Tagen
.gitignore	ad780f763e first commit	vor 6 Tagen
LICENSE	ad780f763e first commit	vor 6 Tagen
README.md	ad780f763e first commit	vor 6 Tagen
build.gradle.kts	ad780f763e first commit	vor 6 Tagen
gradle.properties	ad780f763e first commit	vor 6 Tagen
gradlew	ad780f763e first commit	vor 6 Tagen
gradlew.bat	ad780f763e first commit	vor 6 Tagen
settings.gradle.kts	ad780f763e first commit	vor 6 Tagen
thirdPartyDependencies.csv	ad780f763e first commit	vor 6 Tagen

Open GoPro Kotlin Multiplatform SDK

Overview

Open GoPro Kotlin Multiplatform SDK

The Open GoPro (OGP) Kotlin Multiplatform (KMP) SDK provides a simple Coroutines-powered API to connect to GoPro cameras and exercise the Open GoPro Bluetooth Low Energy and Wi-Fi / USB HTTP APIs.

Currently only Android is fully supported. iOS is mostly untested but there are plans to fully support it soon.

Documentation

Note! This README is only an overview of the library.

Complete Documentation can be found at Open GoPro

Features

High-level GoPro class interface to use BLE and WiFi
Supports all commands, settings, and statuses from the Open GoPro API
Coroutines based
Automatically handles connection maintenance:
- manage camera ready / encoding
- periodically sends keep alive signals
Includes detailed logging for each module
Includes basic demo App to show all contained functionality:
- Capture media
- Inspect / configure settings and statuses
- Basic streaming
- Setting up Camera-on-the-home-network and Livestreaming
- Media Access and display

Setup

NOTE!! The library is not yet available on Maven so this project is currently only intended to be interacted with using the demo app provided in the repo.

This should be resolved soon...

Permissions

The SDK needs permissions relating to Bluetooth, WiFi, and disc writing.

Android

You can find an example in the demo app:

Set the needed permissions in the manifest
Request the needed permissions at run-time

Quick Start (Demo App)

To see a simple demo app that demonstrates most of the SDK, build and load the composeApp project from TODO.

General usage is:

Select an interface to scan for GoPro's (initially only BLE will be available) and select "Scan"
Click on a discovered GoPro to connect to it.
Select "Toggle Shutter" to verify communication
Select "Connect Wifi" if desired
Select a submenu to enter. Note that some require HTTP so you will have needed to Connect Wifi.

SDK Usage

Note! This section contains only an overview. Complete API documentation for the OGP KMP SDK can be found on Open GoPro.

The general procedure is:

Initialize the SDK

// App context is platform-specific context passed from application
val sdk = OgpSdk(Dispatchers.IO, appContext)

Discover and connect to a GoPro Device. A successful connection will store it in the SDK's (runtime) database.

// Discover and take the first device we find
val device = sdk.discover(NetworkType.BLE).first()

// Connect (assume success)
val goproId = sdk.connect(device).getOrThrow()

Now that the device is connected and stored in the SDK, retrieve the GoPro object from the SDK. This can be done any number of times after connection.
```
// Now retrieve the gopro (assume success)
val gopro = sdk.getGoPro(goproId).getOrThrow()
```

Manipulate the retrieved GoPro as desired

// Set the shutter
gopro.commands.setShutter(true)

README.md