Skip to content

superpoweredSDK/Low-Latency-Android-iOS-Linux-Windows-tvOS-macOS-Interactive-Audio-Platform

Repository files navigation

Superpowered Inc develops the leading portable C++ Audio SDK, C++ Networking SDK, and C++ Crypto SDK featuring low-power and real-time latency. With builds for Desktop, Mobile, IoT and Embedded Devices, portable and cross-platform on Android, iOS, macOS, tvOS, Linux and Windows as well as processor-specific builds for ARM32, ARM64, x86, and x64.

Technology, SDKs and Code

Superpowered Inc develops the following interactive audio, networking and cryptographics SDKs and infrastructure:

1. Superpowered C++ Audio Library and SDK for Android, iOS, macOS, tvOS, Linux and Windows.

Superpowered C++ Audio Library and SDK is the leading C++ Audio Library featuring low-power, real-time latency and cross-platform audio players, audio decoders, Fx (effects), audio I/O, streaming, music analysis and spatialization.

For the most up-to-date feature list, see: https://superpowered.com/audio-library-sdk For the latest API reference check the docsite: https://docs.superpowered.com/reference/latest?lang=cpp

2. Superpowered C++ Networking Library and SDK for Android, iOS, macOS, tvOS, Linux and Windows.

The Superpowered C++ Networking Library and SDK was designed from the ground-up to provide the easiest cross-platform way for a client to communicate with the back-end. It implements HTTP and HTTPS communication with custom data and header support, progress handling, file uploads/downloads and more. It reduces implementation, debug and maintenance time of typical tasks such as REST API requests, OAuth and bearer token authorization, or digital media streaming. It operates identically on all platforms, removing the pain of writing wrappers and finding quirks around the operating system's networking API, while it's fully self-contained and independent from it. The SDK also has a JSON parser to offer a complete package for your everyday networking and parsing needs.

For the most up-to-date feature list, see: https://superpowered.com/networking-library-sdk

3. Superpowered C++ Cryptographics Library and SDK for Android, iOS, macOS, tvOS, Linux and Windows.

Superpowered Crypto offers the easiest cross-platform way to implement RSA public and private key cryptography, AES encryption and hashing functions (SHA, MD5). Unlike other cryptographics libraries designed for crypto enthusiasts with myriads of options and complex APIs, Superpowered Crypto has direct one-liner calls for signing, verification, encryption and decryption, solving the most common use-cases in the quickest way.

For the most up-to-date feature list, see: https://superpowered.com/crypto-library-sdk

4. Superpowered HLS (HTTP Live Streaming) audio for Android, iOS, macOS, tvOS, Linux and Windows.

  • VOD, live or event streams.
  • AAC-LC or MP3 audio encoding.
  • ADTS AAC, MP3 or MPEG-TS containers.
  • Supports byte range requests and AES-128 encryption.
  • Bandwidth measurement and selectable automatic stream switching.
  • Selectable download strategies.

Background information: https://superpowered.com/http-live-streaming-for-android-superpowered-android-audio-io-and-audio-resampler

5. Superpowered USB Audio and USB MIDI for Android

The Superpowered USB Audio and MIDI features for Android takes over MIDI device handling, providing low latency and low jitter (below 2 ms) access to MIDI devices for 1.4 billion Android devices, that is, 90+% of all Android devices on Google Play. It’s the Android equivalent of iOS Core Audio and Core MIDI for USB devices.

For additional info, please see: https://superpowered.com/android-usb-audio-android-midi

6. Superpowered has developed a system-space solution for Android's 10 ms Problem.

Interested parties should read:

https://superpowered.com/android-audio-low-latency-primer https://superpowered.com/superpowered-android-media-server

Supported Platforms

Superpowered is cross-platform: ALL SUPERPOWERED C++ CODE CAN BE COPY-PASTED between Android, iOS, macOS, tvOS, Linux and Windows.

Folders

  • /Superpowered

    The SDKs (static libraries and headers).

  • /License

    Contains the license document and Superpowered logo assets.

  • /Examples_Android

    Example projects for Android.

  • /Examples_iOS

    Example projects for iOS.

  • /Examples_Linux

    Example projects for Linux.

  • /Examples_tvOS

    Example projects for tvOS.

  • /Examples_Windows

    Example projects for Windows.

  • /Examples_macOS

    Ambisonics (b-format) implementation based on the Superpowered Spatializer.

  • /Examples_Flutter

    Example projects for Flutter.

  • /Examples_ReactNative

    Example projects for React Native.

  • /Examples_VisionOS

    Example projects for visionOS.

Example Projects

/Examples_Windows/SuperpoweredExample.sln

Four simple Universal Windows Platform example projects in a single Visual Studio solution. Shows how to:

  • Set up audio I/O.
  • Use a single player to play an MP3 bundled with an app.
  • Use a single player to play HLS content.
  • Record the microphone input using Superpowered Recorder.
  • Use a single effect (input -> fx -> output).

/Examples_iOS/SuperpoweredCrossExample, /Examples_Android/CrossExample

A fully-functional DJ app project example. Shows how to:

  • Set up audio I/O.
  • Set up two players.
  • Sync them together.
  • Apply some effects on the master mix.
  • Use Objective-C++.

/Examples_iOS/SuperpoweredFrequencyDomain, /Examples_Android/FrequencyDomain

Simple time domain to frequency domain transformation with buffering and windowing. Shows how to:

  • Set up audio I/O.
  • Use the SuperpoweredFrequencyDomain class.
  • Process the magnitudes and phases of the audio input.

/Examples_iOS/uperpoweredHLSExample, /Examples_Linux/src/hls.cpp

HTTP Live Streaming example project.

/Examples_iOS/SuperpoweredOfflineProcessingExample, /Examples_Linux/src/offlineX.cpp

Advanced example. Decodes an audio file, applies an effect or time stretching and saves the result in WAV. Shows how to:

  • Set up the Superpowered Decoder.
  • Apply a simple effect.
  • Use the time stretcher with an efficient dynamic memory pool.
  • Save the result in WAV.
  • Directly read from the iPod music library.
  • Use the offline analyzer to detect bpm and other information.

/Examples_iOS/SuperpoweredFrequencies

Simple 8-band frequency analyzer. Shows how to:

  • Mix Swift and Objective-C++ in a project.
  • Use the Superpowered BandpassFilterbank.

/SuperpoweredPerformance (iOS)

It compares several Superpowered features to Core Audio.

  • Shows the differences between Superpowered and Core Audio.

  • Syncs effects to the player's bpm.

  • Shows how to use Objective-C++ in an Objective-C project.

    Swift note: We have also tried creating this project in Swift, but it's not complete for audio and several features were impossible to implement (such as proper performance measurement). Swift is not designed for real-time audio. Fortunately, Objective-C++ files work great in Swift projects.

/Examples_Android/SuperpoweredEffect

Shows how to use a single effect (input -> fx -> output).

/Examples_Android/SuperpoweredPlayer

Shows how to use a player (for local, progressive download or HLS playback).

/Examples_Android/SuperpoweredRecorder

Shows how to record the microphone input using Superpowered Recorder.

/Examples_macOS/ambi (OSX)

Simple ambisonics implementation based on the Superpowered Spatializer.

/Examples_Android/SuperpoweredUSBExample

This project comes with two example apps, a simple and a complex example app.

Simple USB Example App:

The simple example app demonstrates an easy audio setup, similar to how iOS handles USB audio devices. It also receives and displays MIDI. The audio functionality of the simple example app will cover most mobile audio use cases.

Complex USB Example App:

The complex example app demonstrates full USB audio discovery, for the use case of sophisticated DAW and recording apps. It displays the various input and output options, audio paths and hardware controls of a USB audio device. Hardware controls can be manipulated and advanced thru audio paths can be enabled.

If an audio output is selected without an audio input, the complex example sends a sine wave to every output channel. If both audio output and audio input are selected, then loopback or round-trip latency measurement are available.

This means that the complex example app is also a testing tool to discover a USB audio device’s advanced features, test audio quality, glitches and latency.

/Examples_Flutter/SuperpoweredPlayerWithEffects

Shows how to use a player and apply a single effect.

/Examples_ReactNative/SuperpoweredPlayerWithEffects

Shows how to use a player and apply a single effect.

/Examples_VisionOS/SuperpoweredVisionOSExample

Shows how to generate a sine wave.

Remarks:

Superpowered USB Audio classes for Android are compatible from Android 19 (KitKat 4.4) onwards. That’s the first Android version where proper scheduling priorities were implemented for low latency audio. This covers more than 75% active Android devices today.

Android Studio

Before running any Android example project, please install the Android NDK version 25.1.8937393 (Tools → SDK Manager → SDK Tools → NDK (Side by side)). Furthermore, turn off Instant Run in the settings, because the Instant Run feature of Android Studio is not compatible with native C++ Android projects.

How to create a Superpowered project with Android Studio

Prerequisites: latest Android SDK, Android NDK, Android Studio installed. Steps:

  1. Create a new project in Android Studio.
  2. Create the cpp folder inside the project's folder: app/src/main/jni
  3. Copy the contents of the following files from one of the example projects: gradle/wrapper/gradle-wrapper.properties, build.gradle, app/build.gradle, app/CMakeLists.txt
  4. Open build.gradle (Module: app), and change the applicationId

Support

Superpowered offers multiple support options.

Developer Documentation (C++ and JavaScript): https://docs.superpowered.com

Email: support@superpowered.zendesk.com

Knowledge base: https://superpowered.zendesk.com/hc/en-us

StackOverflow: https://stackoverflow.com/search?tab=newest&q=superpowered

YouTube: https://www.youtube.com/playlist?list=PLtRKsB6a4xFMXJrZ9wjscOow3nASBoEbU

Paid support options: https://superpowered.com/support

Licensing

For details, please see: https://superpowered.com/licensing

For licensing inquiries, please email licensing@superpowered.com.

Custom Application Development Services

Superpowered offers custom development services focusing on low-latency, interactive audio applications for mobile, web, desktop and embedded.

For development inquiries, please email hello@superpowered.com.

Contact

If you want to be informed about new code releases, bug fixes, general news and information about Superpowered, please email hello@superpowered.com.

For licensing inquiries, please email licensing@superpowered.com.

Notes

Superpowered FFT benefits from ideas in Construction of a High-Performance FFT by Eric Postpischil (http://edp.org/resume.htm).

The Superpowered MP3 and AAC decoder benefits from optimizations by Ken Cooke.

Superpowered version 2.6.6