Target Platform(s):
Wwise SDK 2022.1.8
Go to the documentation of this file.
1 /*******************************************************************************
2 The content of this file includes portions of the AUDIOKINETIC Wwise Technology
3 released in source code form as part of the SDK installer package.
5 Commercial License Usage
7 Licensees holding valid commercial licenses to the AUDIOKINETIC Wwise Technology
8 may use this file in accordance with the end user license agreement provided
9 with the software or, alternatively, in accordance with the terms contained in a
10 written agreement between you and Audiokinetic Inc.
12 Apache License Usage
14 Alternatively, this file may be used under the Apache License, Version 2.0 (the
15 "Apache License"); you may not use this file except in compliance with the
16 Apache License. You may obtain a copy of the Apache License at
19 Unless required by applicable law or agreed to in writing, software distributed
20 under the Apache License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES
21 OR CONDITIONS OF ANY KIND, either express or implied. See the Apache License for
22 the specific language governing permissions and limitations under the License.
24  Copyright (c) 2023 Audiokinetic Inc.
25 *******************************************************************************/
27 // AkAndroidSoundEngine.h
29 /// \file
30 /// Main Sound Engine interface, specific Android.
32 #pragma once
36 #include <SLES/OpenSLES.h>
37 #include "SLES/OpenSLES_Android.h"
38 #include <jni.h>
40 /// \cond !(Web)
41 ///< API used for audio output
42 ///< Use with AkPlatformInitSettings to select the API used for audio output.
43 ///< Use AkAudioAPI_Default, it will select the more appropriate API depending on the computer's capabilities. Other values should be used for testing purposes.
44 ///< \sa AK::SoundEngine::Init
45 typedef enum AkAudioAPIAndroid
46 {
47  AkAudioAPI_AAudio = 1 << 0, ///< Use AAudio (lower latency, available only for Android 8.1 or above)
48  AkAudioAPI_OpenSL_ES = 1 << 1, ///< Use OpenSL ES (older API, compatible with all Android devices)
49  AkAudioAPI_Default = AkAudioAPI_AAudio | AkAudioAPI_OpenSL_ES, ///< Default value, will select the more appropriate API (AAudio for compatible devices, OpenSL for others)
50 } AkAudioAPI;
52 /// Platform specific initialization settings
53 /// \sa AK::SoundEngine::Init
54 /// \sa AK::SoundEngine::GetDefaultPlatformInitSettings
56 {
57  // Threading model.
58  AkThreadProperties threadLEngine; ///< Lower engine threading properties
59  AkThreadProperties threadOutputMgr; ///< Ouput thread threading properties
60  AkThreadProperties threadBankManager; ///< Bank manager threading properties (its default priority is AK_THREAD_PRIORITY_NORMAL)
61  AkThreadProperties threadMonitor; ///< Monitor threading properties (its default priority is AK_THREAD_PRIORITY_ABOVENORMAL). This parameter is not used in Release build.
63  AkAudioAPI eAudioAPI; ///< Main audio API to use. Leave to AkAPI_Default for the default sink (default value).
64  ///< \ref AkAudioAPI
66  AkUInt32 uSampleRate; ///< Sampling Rate. Set to 0 to get the native sample rate. Default value is 0.
67  AkUInt16 uNumRefillsInVoice; ///< Number of refill buffers in voice buffer. Defaults to 4.
68  bool bRoundFrameSizeToHWSize;///< Used when hardware-preferred frame size and user-preferred frame size (AkInitSettings.uNumSamplesPerFrame) are not compatible.
69  /// If true (default) the sound engine will initialize to a multiple of the HW setting, close to the user setting.
70  /// If false, the user setting is used as is, regardless of the HW preference (might incur a performance hit).
72  SLObjectItf pSLEngine; ///< OpenSL engine reference for sharing between various audio components.
73  JavaVM* pJavaVM; ///< Active JavaVM for the app, used for internal system calls. Usually provided through the android_app structure given at startup or the NativeActivity. This parameter needs to be set to allow the sound engine initialization.
74  jobject jActivity; ///< instance for this application. Usually provided through the android_app structure, or through other means if your application has an overridden activity.
76  bool bVerboseSink; ///< Enable this to inspect sink behavior. Useful for debugging non-standard Android devices.
77  bool bEnableLowLatency; ///< Used the lowest output latency possible for the current hardware.
78  /// If true (default), the output audio device will be initialized in low-latency operation, allowing for more responsive audio playback on most devices. However, when operating in low-latency mode, some devices may have differences in audio reproduction.
79  /// If false, the output audio device will be initialized without low-latency operation.
80 };
81 /// \endcond
82 struct AkInitSettings;
84 namespace AK
85 {
86  namespace SoundEngine
87  {
88  /// Get instance of OpenSL created by the sound engine at initialization.
89  /// \return NULL if sound engine is not initialized
92  /// Gets specific settings for the fast audio path on Android. Call this function after AK::SoundEngine::GetDefaultSettings and AK::SoundEngine::GetPlatformDefaultSettings to modify settings for the fast path.
93  /// in_pfSettings.pJavaVM and in_pfSettings.jNativeActivity must be filled properly prior to calling GetFastPathSettings.
94  /// The fast path constraints are:
95  /// -The sample rate must match the hardware native sample rate
96  /// -The number of samples per frame must be a multiple of the hardware buffer size.
97  /// Not fulfilling these constraints makes the audio hardware less efficient.
98  /// In general, using the fast path means a higher CPU usage. Complex audio designs may not be feasible while using the fast path.
100  };
101 };
uint16_t AkUInt16
Unsigned 16-bit integer.
Definition: AkNumeralTypes.h:37
Audiokinetic namespace.
#define AK_EXTERNAPIFUNC(_type, _name)
AKSOUNDENGINE_API SLObjectItf GetWwiseOpenSLInterface()
Standard function call result.
Definition: AkTypes.h:199
Browse to Platform-Specific Audio Output API (enum AkAudioAPI) for each platform-specific audio outpu...
uint32_t AkUInt32
Unsigned 32-bit integer.
Definition: AkNumeralTypes.h:38
AKRESULT GetFastPathSettings(AkInitSettings &in_settings, AkPlatformInitSettings &in_pfSettings)

Was this page helpful?

Need Support?

Questions? Problems? Need more info? Contact us, and we can help!

Visit our Support page

Tell us about your project. We're here to help.

Register your project and we'll help you get started with no strings attached!

Get started with Wwise