19066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/* 29066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Copyright (C) 2008 The Android Open Source Project 39066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 49066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Licensed under the Apache License, Version 2.0 (the "License"); 59066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * you may not use this file except in compliance with the License. 69066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * You may obtain a copy of the License at 79066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 89066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * http://www.apache.org/licenses/LICENSE-2.0 99066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Unless required by applicable law or agreed to in writing, software 119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * distributed under the License is distributed on an "AS IS" BASIS, 129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * See the License for the specific language governing permissions and 149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * limitations under the License. 159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpackage android.media; 189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 197ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Triviimport java.lang.annotation.Retention; 207ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Triviimport java.lang.annotation.RetentionPolicy; 219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport java.lang.ref.WeakReference; 227ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Triviimport java.nio.ByteBuffer; 237ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Triviimport java.nio.NioUtils; 24a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Triviimport java.util.Iterator; 25a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Triviimport java.util.Set; 269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 277ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Triviimport android.annotation.IntDef; 281af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlockimport android.app.ActivityThread; 291af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlockimport android.app.AppOpsManager; 301af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlockimport android.content.Context; 319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.Handler; 321af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlockimport android.os.IBinder; 339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.Looper; 349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.Message; 351af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlockimport android.os.Process; 361af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlockimport android.os.RemoteException; 371af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlockimport android.os.ServiceManager; 389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.util.Log; 399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 401af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlockimport com.android.internal.app.IAppOpsService; 411af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlock 429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/** 449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The AudioTrack class manages and plays a single audio resource for Java applications. 45e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * It allows streaming of PCM audio buffers to the audio sink for playback. This is 469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * achieved by "pushing" the data to the AudioTrack object using one of the 477d60bcd2d950e3571c00ce9f1c492c6bd58334c9Glenn Kasten * {@link #write(byte[], int, int)}, {@link #write(short[], int, int)}, 487d60bcd2d950e3571c00ce9f1c492c6bd58334c9Glenn Kasten * and {@link #write(float[], int, int, int)} methods. 4988bde0ce3799c47530ea42ae3665bfa12ae38d11Narayan Kamath * 50ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * <p>An AudioTrack instance can operate under two modes: static or streaming.<br> 51ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * In Streaming mode, the application writes a continuous stream of data to the AudioTrack, using 5288bde0ce3799c47530ea42ae3665bfa12ae38d11Narayan Kamath * one of the {@code write()} methods. These are blocking and return when the data has been 5388bde0ce3799c47530ea42ae3665bfa12ae38d11Narayan Kamath * transferred from the Java layer to the native layer and queued for playback. The streaming 5488bde0ce3799c47530ea42ae3665bfa12ae38d11Narayan Kamath * mode is most useful when playing blocks of audio data that for instance are: 5588bde0ce3799c47530ea42ae3665bfa12ae38d11Narayan Kamath * 569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <ul> 579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>too big to fit in memory because of the duration of the sound to play,</li> 589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>too big to fit in memory because of the characteristics of the audio data 599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * (high sampling rate, bits per sample ...)</li> 60ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * <li>received or generated while previously queued audio is playing.</li> 619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * </ul> 6288bde0ce3799c47530ea42ae3665bfa12ae38d11Narayan Kamath * 635c17a820f9e46e0756c11795b3e6f89105f2f539Glenn Kasten * The static mode should be chosen when dealing with short sounds that fit in memory and 6488bde0ce3799c47530ea42ae3665bfa12ae38d11Narayan Kamath * that need to be played with the smallest latency possible. The static mode will 6588bde0ce3799c47530ea42ae3665bfa12ae38d11Narayan Kamath * therefore be preferred for UI and game sounds that are played often, and with the 6688bde0ce3799c47530ea42ae3665bfa12ae38d11Narayan Kamath * smallest overhead possible. 6788bde0ce3799c47530ea42ae3665bfa12ae38d11Narayan Kamath * 689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>Upon creation, an AudioTrack object initializes its associated audio buffer. 699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The size of this buffer, specified during the construction, determines how long an AudioTrack 709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * can play before running out of data.<br> 719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * For an AudioTrack using the static mode, this size is the maximum size of the sound that can 729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * be played from it.<br> 73e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * For the streaming mode, data will be written to the audio sink in chunks of 745c17a820f9e46e0756c11795b3e6f89105f2f539Glenn Kasten * sizes less than or equal to the total buffer size. 7555a3218f242a611afb3569d88970c0c5dbf8ce54Glenn Kasten * 7655a3218f242a611afb3569d88970c0c5dbf8ce54Glenn Kasten * AudioTrack is not final and thus permits subclasses, but such use is not recommended. 779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpublic class AudioTrack 799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project{ 809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //--------------------------------------------------------- 819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Constants 829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //-------------------- 8378cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten /** Minimum value for a linear gain or auxiliary effect level. 8478cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * This value must be exactly equal to 0.0f; do not change it. 8578cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten */ 8678cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten private static final float GAIN_MIN = 0.0f; 8778cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten /** Maximum value for a linear gain or auxiliary effect level. 8878cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * This value must be greater than or equal to 1.0f. 8978cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten */ 9078cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten private static final float GAIN_MAX = 1.0f; 919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 92ad67c9546494a7c4d9336b57889a7c19a7dbb945Glenn Kasten /** Minimum value for sample rate */ 93ad67c9546494a7c4d9336b57889a7c19a7dbb945Glenn Kasten private static final int SAMPLE_RATE_HZ_MIN = 4000; 94ad67c9546494a7c4d9336b57889a7c19a7dbb945Glenn Kasten /** Maximum value for sample rate */ 9570b395e8c1d06ca9288afd418b9e889df4060eabAndy Hung private static final int SAMPLE_RATE_HZ_MAX = 96000; 96ad67c9546494a7c4d9336b57889a7c19a7dbb945Glenn Kasten 97ad720aeea741d9058a7b4d326c9ab1b3ebcd7c62Andy Hung /** Maximum value for AudioTrack channel count */ 98ad720aeea741d9058a7b4d326c9ab1b3ebcd7c62Andy Hung private static final int CHANNEL_COUNT_MAX = 8; 99ad720aeea741d9058a7b4d326c9ab1b3ebcd7c62Andy Hung 100ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi /** indicates AudioTrack state is stopped */ 1019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int PLAYSTATE_STOPPED = 1; // matches SL_PLAYSTATE_STOPPED 102ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi /** indicates AudioTrack state is paused */ 1039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int PLAYSTATE_PAUSED = 2; // matches SL_PLAYSTATE_PAUSED 104ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi /** indicates AudioTrack state is playing */ 1059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int PLAYSTATE_PLAYING = 3; // matches SL_PLAYSTATE_PLAYING 1069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1075c17a820f9e46e0756c11795b3e6f89105f2f539Glenn Kasten // keep these values in sync with android_media_AudioTrack.cpp 1089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Creation mode where audio data is transferred from Java to the native layer 1109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * only once before the audio starts playing. 1119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int MODE_STATIC = 0; 1139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Creation mode where audio data is streamed from Java to the native layer 1159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * as the audio is playing. 1169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int MODE_STREAM = 1; 1189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 120ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * State of an AudioTrack that was not successfully initialized upon creation. 1219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int STATE_UNINITIALIZED = 0; 1239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * State of an AudioTrack that is ready to be used. 1259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int STATE_INITIALIZED = 1; 1279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * State of a successfully initialized AudioTrack that uses static data, 1299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * but that hasn't received that data yet. 1309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int STATE_NO_STATIC_DATA = 2; 1329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Denotes a successful operation. 1359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 136bc11a696f6856624de532a6830d5db9dbbe2384cEric Laurent public static final int SUCCESS = AudioSystem.SUCCESS; 1379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Denotes a generic operation failure. 1399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 140bc11a696f6856624de532a6830d5db9dbbe2384cEric Laurent public static final int ERROR = AudioSystem.ERROR; 1419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Denotes a failure due to the use of an invalid value. 1439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 144bc11a696f6856624de532a6830d5db9dbbe2384cEric Laurent public static final int ERROR_BAD_VALUE = AudioSystem.BAD_VALUE; 1459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Denotes a failure due to the improper use of a method. 1479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 148bc11a696f6856624de532a6830d5db9dbbe2384cEric Laurent public static final int ERROR_INVALID_OPERATION = AudioSystem.INVALID_OPERATION; 1499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 150bc11a696f6856624de532a6830d5db9dbbe2384cEric Laurent // Error codes: 151bc11a696f6856624de532a6830d5db9dbbe2384cEric Laurent // to keep in sync with frameworks/base/core/jni/android_media_AudioTrack.cpp 1529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final int ERROR_NATIVESETUP_AUDIOSYSTEM = -16; 153a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent private static final int ERROR_NATIVESETUP_INVALIDCHANNELMASK = -17; 1549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final int ERROR_NATIVESETUP_INVALIDFORMAT = -18; 1559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final int ERROR_NATIVESETUP_INVALIDSTREAMTYPE = -19; 1569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final int ERROR_NATIVESETUP_NATIVEINITFAILED = -20; 1579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Events: 159e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten // to keep in sync with frameworks/av/include/media/AudioTrack.h 1609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 161ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * Event id denotes when playback head has reached a previously set marker. 1629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final int NATIVE_EVENT_MARKER = 3; 1649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 165ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * Event id denotes when previously set update period has elapsed during playback. 1669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final int NATIVE_EVENT_NEW_POS = 4; 1689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1691f61d01508651b4475397414e1fe06af1ab8fadaGlenn Kasten private final static String TAG = "android.media.AudioTrack"; 1709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1727ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi /** @hide */ 1737ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi @IntDef({ 1747ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi WRITE_BLOCKING, 1757ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi WRITE_NON_BLOCKING 1767ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi }) 1777ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi @Retention(RetentionPolicy.SOURCE) 1787ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi public @interface WriteMode {} 1797ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi 1807ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi /** 1817ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi * The write mode indicating the write operation will block until all data has been written, 1828b520c8f8e176f07ed496a171ddae75e66b3bc4fJean-Michel Trivi * to be used in {@link #write(ByteBuffer, int, int)} 1837ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi */ 1847ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi public final static int WRITE_BLOCKING = 0; 1857ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi /** 1867ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi * The write mode indicating the write operation will return immediately after 1877ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi * queuing as much audio data for playback as possible without blocking, to be used in 1888b520c8f8e176f07ed496a171ddae75e66b3bc4fJean-Michel Trivi * {@link #write(ByteBuffer, int, int)}. 1897ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi */ 1907ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi public final static int WRITE_NON_BLOCKING = 1; 1917ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi 1929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //-------------------------------------------------------------------------- 1939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Member variables 1949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //-------------------- 1959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 196ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * Indicates the state of the AudioTrack instance. 1979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private int mState = STATE_UNINITIALIZED; 1999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 200ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * Indicates the play state of the AudioTrack instance. 2019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private int mPlayState = PLAYSTATE_STOPPED; 2039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Lock to make sure mPlayState updates are reflecting the actual state of the object. 2059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private final Object mPlayStateLock = new Object(); 2079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 208e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * Sizes of the native audio buffer. 2099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private int mNativeBufferSizeInBytes = 0; 211e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten private int mNativeBufferSizeInFrames = 0; 2129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 21386fad47e68e344b19fabeab1156c5e6742d8dfadGlenn Kasten * Handler for events coming from the native code. 2149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 21595bd2329c6a36211f18be3e089eaa775ec62df62Glenn Kasten private NativeEventHandlerDelegate mEventHandlerDelegate; 2169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 217ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * Looper associated with the thread that creates the AudioTrack instance. 218105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project */ 219b09707a041957f055cee3d290c85763cfef8d986Glenn Kasten private final Looper mInitializationLooper; 220105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project /** 2218d7fa137466c833ed422053204fb4c506b7bb209Glenn Kasten * The audio data source sampling rate in Hz. 2229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2235c17a820f9e46e0756c11795b3e6f89105f2f539Glenn Kasten private int mSampleRate; // initialized by all constructors 2249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2253026a023b8979b7ddcb3fe97bbc45531c89fda92Eric Laurent * The number of audio output channels (1 is mono, 2 is stereo). 2269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private int mChannelCount = 1; 2289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2293026a023b8979b7ddcb3fe97bbc45531c89fda92Eric Laurent * The audio channel mask. 2303026a023b8979b7ddcb3fe97bbc45531c89fda92Eric Laurent */ 2313026a023b8979b7ddcb3fe97bbc45531c89fda92Eric Laurent private int mChannels = AudioFormat.CHANNEL_OUT_MONO; 2323026a023b8979b7ddcb3fe97bbc45531c89fda92Eric Laurent 2333026a023b8979b7ddcb3fe97bbc45531c89fda92Eric Laurent /** 2349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The type of the audio stream to play. See 2359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link AudioManager#STREAM_VOICE_CALL}, {@link AudioManager#STREAM_SYSTEM}, 2365c17a820f9e46e0756c11795b3e6f89105f2f539Glenn Kasten * {@link AudioManager#STREAM_RING}, {@link AudioManager#STREAM_MUSIC}, 237b282e08ab641d4fc74d0324b7a0ce30926638dd5Glenn Kasten * {@link AudioManager#STREAM_ALARM}, {@link AudioManager#STREAM_NOTIFICATION}, and 238b282e08ab641d4fc74d0324b7a0ce30926638dd5Glenn Kasten * {@link AudioManager#STREAM_DTMF}. 2399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private int mStreamType = AudioManager.STREAM_MUSIC; 241a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi 242a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi private final AudioAttributes mAttributes; 2439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 244e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * The way audio is consumed by the audio sink, streaming or static. 2459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private int mDataLoadMode = MODE_STREAM; 2479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 248ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * The current audio channel configuration. 2499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 250a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent private int mChannelConfiguration = AudioFormat.CHANNEL_OUT_MONO; 2519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The encoding of the audio samples. 2539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see AudioFormat#ENCODING_PCM_8BIT 2549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see AudioFormat#ENCODING_PCM_16BIT 2557d60bcd2d950e3571c00ce9f1c492c6bd58334c9Glenn Kasten * @see AudioFormat#ENCODING_PCM_FLOAT 2569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private int mAudioFormat = AudioFormat.ENCODING_PCM_16BIT; 258619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent /** 259619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * Audio session ID 260619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent */ 26160bd67f7b1b85ed0ee19f77b056b90350a3d5343Glenn Kasten private int mSessionId = AudioSystem.AUDIO_SESSION_ALLOCATE; 2621af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlock /** 2631af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlock * Reference to the app-ops service. 2641af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlock */ 2651af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlock private final IAppOpsService mAppOps; 2669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //-------------------------------- 2689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Used exclusively by native code 2699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //-------------------- 2709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 271ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * Accessed by native methods: provides access to C++ AudioTrack object. 2729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @SuppressWarnings("unused") 274075e9a19ce645752f8282bc19c91b25978a7dc52Ashok Bhat private long mNativeTrackInJavaObj; 2759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Accessed by native methods: provides access to the JNI data (i.e. resources used by 2779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the native AudioTrack object, but not stored in it). 2789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @SuppressWarnings("unused") 280075e9a19ce645752f8282bc19c91b25978a7dc52Ashok Bhat private long mJniData; 2819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //-------------------------------------------------------------------------- 2849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Constructor, Finalize 2859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //-------------------- 2869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Class constructor. 2889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param streamType the type of the audio stream. See 2899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link AudioManager#STREAM_VOICE_CALL}, {@link AudioManager#STREAM_SYSTEM}, 2905c17a820f9e46e0756c11795b3e6f89105f2f539Glenn Kasten * {@link AudioManager#STREAM_RING}, {@link AudioManager#STREAM_MUSIC}, 2915c17a820f9e46e0756c11795b3e6f89105f2f539Glenn Kasten * {@link AudioManager#STREAM_ALARM}, and {@link AudioManager#STREAM_NOTIFICATION}. 2928d7fa137466c833ed422053204fb4c506b7bb209Glenn Kasten * @param sampleRateInHz the initial source sample rate expressed in Hz. 2939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param channelConfig describes the configuration of the audio channels. 294a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * See {@link AudioFormat#CHANNEL_OUT_MONO} and 295a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * {@link AudioFormat#CHANNEL_OUT_STEREO} 2969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param audioFormat the format in which the audio data is represented. 2977d60bcd2d950e3571c00ce9f1c492c6bd58334c9Glenn Kasten * See {@link AudioFormat#ENCODING_PCM_16BIT}, 2987d60bcd2d950e3571c00ce9f1c492c6bd58334c9Glenn Kasten * {@link AudioFormat#ENCODING_PCM_8BIT}, 2997d60bcd2d950e3571c00ce9f1c492c6bd58334c9Glenn Kasten * and {@link AudioFormat#ENCODING_PCM_FLOAT}. 300e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * @param bufferSizeInBytes the total size (in bytes) of the internal buffer where audio data is 301e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * read from for playback. 302e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * If track's creation mode is {@link #MODE_STREAM}, you can write data into 303e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * this buffer in chunks less than or equal to this size, and it is typical to use 304e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * chunks of 1/2 of the total size to permit double-buffering. 305e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * If the track's creation mode is {@link #MODE_STATIC}, 306e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * this is the maximum length sample, or audio clip, that can be played by this instance. 307ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * See {@link #getMinBufferSize(int, int, int)} to determine the minimum required buffer size 308ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * for the successful creation of an AudioTrack instance in streaming mode. Using values 309ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * smaller than getMinBufferSize() will result in an initialization failure. 3109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param mode streaming or static buffer. See {@link #MODE_STATIC} and {@link #MODE_STREAM} 3119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws java.lang.IllegalArgumentException 3129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public AudioTrack(int streamType, int sampleRateInHz, int channelConfig, int audioFormat, 3149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int bufferSizeInBytes, int mode) 3159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throws IllegalArgumentException { 316619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent this(streamType, sampleRateInHz, channelConfig, audioFormat, 31760bd67f7b1b85ed0ee19f77b056b90350a3d5343Glenn Kasten bufferSizeInBytes, mode, AudioSystem.AUDIO_SESSION_ALLOCATE); 318619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent } 319619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent 320619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent /** 321619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * Class constructor with audio session. Use this constructor when the AudioTrack must be 322619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * attached to a particular audio session. The primary use of the audio session ID is to 323619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * associate audio effects to a particular instance of AudioTrack: if an audio session ID 324619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * is provided when creating an AudioEffect, this effect will be applied only to audio tracks 325619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * and media players in the same session and not to the output mix. 326619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * When an AudioTrack is created without specifying a session, it will create its own session 3278d7fa137466c833ed422053204fb4c506b7bb209Glenn Kasten * which can be retrieved by calling the {@link #getAudioSessionId()} method. 3285c17a820f9e46e0756c11795b3e6f89105f2f539Glenn Kasten * If a non-zero session ID is provided, this AudioTrack will share effects attached to this 3295c17a820f9e46e0756c11795b3e6f89105f2f539Glenn Kasten * session 3305c17a820f9e46e0756c11795b3e6f89105f2f539Glenn Kasten * with all other media players or audio tracks in the same session, otherwise a new session 3315c17a820f9e46e0756c11795b3e6f89105f2f539Glenn Kasten * will be created for this track if none is supplied. 332619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * @param streamType the type of the audio stream. See 333619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * {@link AudioManager#STREAM_VOICE_CALL}, {@link AudioManager#STREAM_SYSTEM}, 3345c17a820f9e46e0756c11795b3e6f89105f2f539Glenn Kasten * {@link AudioManager#STREAM_RING}, {@link AudioManager#STREAM_MUSIC}, 3355c17a820f9e46e0756c11795b3e6f89105f2f539Glenn Kasten * {@link AudioManager#STREAM_ALARM}, and {@link AudioManager#STREAM_NOTIFICATION}. 3368d7fa137466c833ed422053204fb4c506b7bb209Glenn Kasten * @param sampleRateInHz the initial source sample rate expressed in Hz. 337619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * @param channelConfig describes the configuration of the audio channels. 338619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * See {@link AudioFormat#CHANNEL_OUT_MONO} and 339619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * {@link AudioFormat#CHANNEL_OUT_STEREO} 340619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * @param audioFormat the format in which the audio data is represented. 341619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * See {@link AudioFormat#ENCODING_PCM_16BIT} and 3427d60bcd2d950e3571c00ce9f1c492c6bd58334c9Glenn Kasten * {@link AudioFormat#ENCODING_PCM_8BIT}, 3437d60bcd2d950e3571c00ce9f1c492c6bd58334c9Glenn Kasten * and {@link AudioFormat#ENCODING_PCM_FLOAT}. 344619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * @param bufferSizeInBytes the total size (in bytes) of the buffer where audio data is read 345619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * from for playback. If using the AudioTrack in streaming mode, you can write data into 346619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * this buffer in smaller chunks than this size. If using the AudioTrack in static mode, 347619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * this is the maximum size of the sound that will be played for this instance. 348619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * See {@link #getMinBufferSize(int, int, int)} to determine the minimum required buffer size 349619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * for the successful creation of an AudioTrack instance in streaming mode. Using values 350619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * smaller than getMinBufferSize() will result in an initialization failure. 351619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * @param mode streaming or static buffer. See {@link #MODE_STATIC} and {@link #MODE_STREAM} 352619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * @param sessionId Id of audio session the AudioTrack must be attached to 353619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * @throws java.lang.IllegalArgumentException 354619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent */ 355619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent public AudioTrack(int streamType, int sampleRateInHz, int channelConfig, int audioFormat, 356619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent int bufferSizeInBytes, int mode, int sessionId) 357619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent throws IllegalArgumentException { 358a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten // mState already == STATE_UNINITIALIZED 359a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi this((new AudioAttributes.Builder()) 360a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi .setLegacyStreamType(streamType) 361a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi .build(), 362a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi (new AudioFormat.Builder()) 363a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi .setChannelMask(channelConfig) 364a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi .setEncoding(audioFormat) 365a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi .setSampleRate(sampleRateInHz) 366a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi .build(), 367a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi bufferSizeInBytes, 368a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi mode, sessionId); 369a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi } 370a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi 371a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi /** 3727f6ee760b0aee76bdb9fe61ac7ed1465c0da3489Jean-Michel Trivi * Class constructor with {@link AudioAttributes} and {@link AudioFormat}. 3737f6ee760b0aee76bdb9fe61ac7ed1465c0da3489Jean-Michel Trivi * @param attributes a non-null {@link AudioAttributes} instance. 3747f6ee760b0aee76bdb9fe61ac7ed1465c0da3489Jean-Michel Trivi * @param format a non-null {@link AudioFormat} instance describing the format of the data 3757f6ee760b0aee76bdb9fe61ac7ed1465c0da3489Jean-Michel Trivi * that will be played through this AudioTrack. See {@link AudioFormat.Builder} for 3767f6ee760b0aee76bdb9fe61ac7ed1465c0da3489Jean-Michel Trivi * configuring the audio format parameters such as encoding, channel mask and sample rate. 3777f6ee760b0aee76bdb9fe61ac7ed1465c0da3489Jean-Michel Trivi * @param bufferSizeInBytes the total size (in bytes) of the buffer where audio data is read 3787f6ee760b0aee76bdb9fe61ac7ed1465c0da3489Jean-Michel Trivi * from for playback. If using the AudioTrack in streaming mode, you can write data into 3797f6ee760b0aee76bdb9fe61ac7ed1465c0da3489Jean-Michel Trivi * this buffer in smaller chunks than this size. If using the AudioTrack in static mode, 3807f6ee760b0aee76bdb9fe61ac7ed1465c0da3489Jean-Michel Trivi * this is the maximum size of the sound that will be played for this instance. 3817f6ee760b0aee76bdb9fe61ac7ed1465c0da3489Jean-Michel Trivi * See {@link #getMinBufferSize(int, int, int)} to determine the minimum required buffer size 3827f6ee760b0aee76bdb9fe61ac7ed1465c0da3489Jean-Michel Trivi * for the successful creation of an AudioTrack instance in streaming mode. Using values 3837f6ee760b0aee76bdb9fe61ac7ed1465c0da3489Jean-Michel Trivi * smaller than getMinBufferSize() will result in an initialization failure. 3847f6ee760b0aee76bdb9fe61ac7ed1465c0da3489Jean-Michel Trivi * @param mode streaming or static buffer. See {@link #MODE_STATIC} and {@link #MODE_STREAM}. 385289cc8e887f786f557faab226a1e01abb9a632a6Jean-Michel Trivi * @param sessionId ID of audio session the AudioTrack must be attached to, or 386289cc8e887f786f557faab226a1e01abb9a632a6Jean-Michel Trivi * {@link AudioManager#AUDIO_SESSION_ID_GENERATE} if the session isn't known at construction 387289cc8e887f786f557faab226a1e01abb9a632a6Jean-Michel Trivi * time. See also {@link AudioManager#generateAudioSessionId()} to obtain a session ID before 388289cc8e887f786f557faab226a1e01abb9a632a6Jean-Michel Trivi * construction. 3897f6ee760b0aee76bdb9fe61ac7ed1465c0da3489Jean-Michel Trivi * @throws IllegalArgumentException 390a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi */ 391a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi public AudioTrack(AudioAttributes attributes, AudioFormat format, int bufferSizeInBytes, 392a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi int mode, int sessionId) 393a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi throws IllegalArgumentException { 394a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi // mState already == STATE_UNINITIALIZED 3955c17a820f9e46e0756c11795b3e6f89105f2f539Glenn Kasten 3967f6ee760b0aee76bdb9fe61ac7ed1465c0da3489Jean-Michel Trivi if (attributes == null) { 3977f6ee760b0aee76bdb9fe61ac7ed1465c0da3489Jean-Michel Trivi throw new IllegalArgumentException("Illegal null AudioAttributes"); 3987f6ee760b0aee76bdb9fe61ac7ed1465c0da3489Jean-Michel Trivi } 3997f6ee760b0aee76bdb9fe61ac7ed1465c0da3489Jean-Michel Trivi if (format == null) { 4007f6ee760b0aee76bdb9fe61ac7ed1465c0da3489Jean-Michel Trivi throw new IllegalArgumentException("Illegal null AudioFormat"); 4017f6ee760b0aee76bdb9fe61ac7ed1465c0da3489Jean-Michel Trivi } 4027f6ee760b0aee76bdb9fe61ac7ed1465c0da3489Jean-Michel Trivi 4035c17a820f9e46e0756c11795b3e6f89105f2f539Glenn Kasten // remember which looper is associated with the AudioTrack instantiation 404b09707a041957f055cee3d290c85763cfef8d986Glenn Kasten Looper looper; 405b09707a041957f055cee3d290c85763cfef8d986Glenn Kasten if ((looper = Looper.myLooper()) == null) { 406b09707a041957f055cee3d290c85763cfef8d986Glenn Kasten looper = Looper.getMainLooper(); 407105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project } 4089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 409a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi int rate = 0; 410a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi if ((format.getPropertySetMask() & AudioFormat.AUDIO_FORMAT_HAS_PROPERTY_SAMPLE_RATE) != 0) 411a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi { 412a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi rate = format.getSampleRate(); 413a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi } else { 414a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi rate = AudioSystem.getPrimaryOutputSamplingRate(); 415a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi if (rate <= 0) { 416a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi rate = 44100; 417a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi } 418a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi } 419a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi int channelMask = AudioFormat.CHANNEL_OUT_FRONT_LEFT | AudioFormat.CHANNEL_OUT_FRONT_RIGHT; 420a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi if ((format.getPropertySetMask() & AudioFormat.AUDIO_FORMAT_HAS_PROPERTY_CHANNEL_MASK) != 0) 421a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi { 422a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi channelMask = format.getChannelMask(); 423a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi } 424a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi int encoding = AudioFormat.ENCODING_DEFAULT; 425a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi if ((format.getPropertySetMask() & AudioFormat.AUDIO_FORMAT_HAS_PROPERTY_ENCODING) != 0) { 426a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi encoding = format.getEncoding(); 427a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi } 428a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi audioParamCheck(rate, channelMask, encoding, mode); 429a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi mStreamType = AudioSystem.STREAM_DEFAULT; 4309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project audioBuffSizeCheck(bufferSizeInBytes); 4329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 433a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi mInitializationLooper = looper; 4341af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlock IBinder b = ServiceManager.getService(Context.APP_OPS_SERVICE); 4351af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlock mAppOps = IAppOpsService.Stub.asInterface(b); 4361af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlock 437a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi mAttributes = (new AudioAttributes.Builder(attributes).build()); 438a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi 439619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent if (sessionId < 0) { 440f4e58051e22ad4e21c7cd436c37cc5665c194d1cGlenn Kasten throw new IllegalArgumentException("Invalid audio session ID: "+sessionId); 441619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent } 442619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent 443619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent int[] session = new int[1]; 444619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent session[0] = sessionId; 4459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // native initialization 446a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi int initResult = native_setup(new WeakReference<AudioTrack>(this), mAttributes, 447a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi mSampleRate, mChannels, mAudioFormat, 448619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent mNativeBufferSizeInBytes, mDataLoadMode, session); 4499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (initResult != SUCCESS) { 4509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project loge("Error code "+initResult+" when initializing AudioTrack."); 4519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return; // with mState == STATE_UNINITIALIZED 4529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 454619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent mSessionId = session[0]; 455619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent 4569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mDataLoadMode == MODE_STATIC) { 4579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mState = STATE_NO_STATIC_DATA; 4589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 4599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mState = STATE_INITIALIZED; 4609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4631b8f499a14a4340d3422d95c7f6fdc8c0c72b3a4Jean-Michel Trivi // mask of all the channels supported by this implementation 4641b8f499a14a4340d3422d95c7f6fdc8c0c72b3a4Jean-Michel Trivi private static final int SUPPORTED_OUT_CHANNELS = 4651b8f499a14a4340d3422d95c7f6fdc8c0c72b3a4Jean-Michel Trivi AudioFormat.CHANNEL_OUT_FRONT_LEFT | 4661b8f499a14a4340d3422d95c7f6fdc8c0c72b3a4Jean-Michel Trivi AudioFormat.CHANNEL_OUT_FRONT_RIGHT | 4671b8f499a14a4340d3422d95c7f6fdc8c0c72b3a4Jean-Michel Trivi AudioFormat.CHANNEL_OUT_FRONT_CENTER | 4681b8f499a14a4340d3422d95c7f6fdc8c0c72b3a4Jean-Michel Trivi AudioFormat.CHANNEL_OUT_LOW_FREQUENCY | 4691b8f499a14a4340d3422d95c7f6fdc8c0c72b3a4Jean-Michel Trivi AudioFormat.CHANNEL_OUT_BACK_LEFT | 4701b8f499a14a4340d3422d95c7f6fdc8c0c72b3a4Jean-Michel Trivi AudioFormat.CHANNEL_OUT_BACK_RIGHT | 471ad720aeea741d9058a7b4d326c9ab1b3ebcd7c62Andy Hung AudioFormat.CHANNEL_OUT_BACK_CENTER | 472ad720aeea741d9058a7b4d326c9ab1b3ebcd7c62Andy Hung AudioFormat.CHANNEL_OUT_SIDE_LEFT | 473ad720aeea741d9058a7b4d326c9ab1b3ebcd7c62Andy Hung AudioFormat.CHANNEL_OUT_SIDE_RIGHT; 4749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Convenience method for the constructor's parameter checks. 4769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // This is where constructor IllegalArgumentException-s are thrown 4779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // postconditions: 4789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // mChannelCount is valid 4793026a023b8979b7ddcb3fe97bbc45531c89fda92Eric Laurent // mChannels is valid 4809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // mAudioFormat is valid 4819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // mSampleRate is valid 4829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // mDataLoadMode is valid 483a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi private void audioParamCheck(int sampleRateInHz, 4849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int channelConfig, int audioFormat, int mode) { 4859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //-------------- 4865c17a820f9e46e0756c11795b3e6f89105f2f539Glenn Kasten // sample rate, note these values are subject to change 4879e4a66d69673adcf5f32e4b121809322d9ffd97cAndy Hung if (sampleRateInHz < SAMPLE_RATE_HZ_MIN || sampleRateInHz > SAMPLE_RATE_HZ_MAX) { 488f4e58051e22ad4e21c7cd436c37cc5665c194d1cGlenn Kasten throw new IllegalArgumentException(sampleRateInHz 489f4e58051e22ad4e21c7cd436c37cc5665c194d1cGlenn Kasten + "Hz is not a supported sample rate."); 4909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 491896a7f5fee46c24d31e9403abdf5813e4bb84ca5Glenn Kasten mSampleRate = sampleRateInHz; 4929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //-------------- 4949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // channel config 4953026a023b8979b7ddcb3fe97bbc45531c89fda92Eric Laurent mChannelConfiguration = channelConfig; 4963026a023b8979b7ddcb3fe97bbc45531c89fda92Eric Laurent 4979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project switch (channelConfig) { 4983026a023b8979b7ddcb3fe97bbc45531c89fda92Eric Laurent case AudioFormat.CHANNEL_OUT_DEFAULT: //AudioFormat.CHANNEL_CONFIGURATION_DEFAULT 499a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent case AudioFormat.CHANNEL_OUT_MONO: 5003026a023b8979b7ddcb3fe97bbc45531c89fda92Eric Laurent case AudioFormat.CHANNEL_CONFIGURATION_MONO: 5019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mChannelCount = 1; 5023026a023b8979b7ddcb3fe97bbc45531c89fda92Eric Laurent mChannels = AudioFormat.CHANNEL_OUT_MONO; 5039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project break; 504a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent case AudioFormat.CHANNEL_OUT_STEREO: 5053026a023b8979b7ddcb3fe97bbc45531c89fda92Eric Laurent case AudioFormat.CHANNEL_CONFIGURATION_STEREO: 5069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mChannelCount = 2; 5073026a023b8979b7ddcb3fe97bbc45531c89fda92Eric Laurent mChannels = AudioFormat.CHANNEL_OUT_STEREO; 5089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project break; 5099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project default: 510d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi if (!isMultichannelConfigSupported(channelConfig)) { 5111b8f499a14a4340d3422d95c7f6fdc8c0c72b3a4Jean-Michel Trivi // input channel configuration features unsupported channels 512f4e58051e22ad4e21c7cd436c37cc5665c194d1cGlenn Kasten throw new IllegalArgumentException("Unsupported channel configuration."); 5131b8f499a14a4340d3422d95c7f6fdc8c0c72b3a4Jean-Michel Trivi } 514896a7f5fee46c24d31e9403abdf5813e4bb84ca5Glenn Kasten mChannels = channelConfig; 515896a7f5fee46c24d31e9403abdf5813e4bb84ca5Glenn Kasten mChannelCount = Integer.bitCount(channelConfig); 5169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //-------------- 5199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // audio format 520ff0d9f098e51c54e1a030ed21fd980680cb7b405Eric Laurent if (audioFormat == AudioFormat.ENCODING_DEFAULT) { 521ff0d9f098e51c54e1a030ed21fd980680cb7b405Eric Laurent audioFormat = AudioFormat.ENCODING_PCM_16BIT; 522ff0d9f098e51c54e1a030ed21fd980680cb7b405Eric Laurent } 523ff0d9f098e51c54e1a030ed21fd980680cb7b405Eric Laurent 524ff0d9f098e51c54e1a030ed21fd980680cb7b405Eric Laurent if (!AudioFormat.isValidEncoding(audioFormat)) { 525ff0d9f098e51c54e1a030ed21fd980680cb7b405Eric Laurent throw new IllegalArgumentException("Unsupported audio encoding."); 5269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 527ff0d9f098e51c54e1a030ed21fd980680cb7b405Eric Laurent mAudioFormat = audioFormat; 5289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //-------------- 5309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // audio load mode 531ff0d9f098e51c54e1a030ed21fd980680cb7b405Eric Laurent if (((mode != MODE_STREAM) && (mode != MODE_STATIC)) || 532ff0d9f098e51c54e1a030ed21fd980680cb7b405Eric Laurent ((mode != MODE_STREAM) && !AudioFormat.isEncodingLinearPcm(mAudioFormat))) { 533f4e58051e22ad4e21c7cd436c37cc5665c194d1cGlenn Kasten throw new IllegalArgumentException("Invalid mode."); 5349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 535896a7f5fee46c24d31e9403abdf5813e4bb84ca5Glenn Kasten mDataLoadMode = mode; 5369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 538d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi /** 539d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi * Convenience method to check that the channel configuration (a.k.a channel mask) is supported 540d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi * @param channelConfig the mask to validate 541d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi * @return false if the AudioTrack can't be used with such a mask 542d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi */ 543d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi private static boolean isMultichannelConfigSupported(int channelConfig) { 544d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi // check for unsupported channels 545d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi if ((channelConfig & SUPPORTED_OUT_CHANNELS) != channelConfig) { 5461f61d01508651b4475397414e1fe06af1ab8fadaGlenn Kasten loge("Channel configuration features unsupported channels"); 547d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi return false; 548d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi } 549ad720aeea741d9058a7b4d326c9ab1b3ebcd7c62Andy Hung final int channelCount = Integer.bitCount(channelConfig); 550ad720aeea741d9058a7b4d326c9ab1b3ebcd7c62Andy Hung if (channelCount > CHANNEL_COUNT_MAX) { 551ad720aeea741d9058a7b4d326c9ab1b3ebcd7c62Andy Hung loge("Channel configuration contains too many channels " + 552ad720aeea741d9058a7b4d326c9ab1b3ebcd7c62Andy Hung channelCount + ">" + CHANNEL_COUNT_MAX); 553ad720aeea741d9058a7b4d326c9ab1b3ebcd7c62Andy Hung return false; 554ad720aeea741d9058a7b4d326c9ab1b3ebcd7c62Andy Hung } 555d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi // check for unsupported multichannel combinations: 556d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi // - FL/FR must be present 557d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi // - L/R channels must be paired (e.g. no single L channel) 558d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi final int frontPair = 559d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi AudioFormat.CHANNEL_OUT_FRONT_LEFT | AudioFormat.CHANNEL_OUT_FRONT_RIGHT; 560d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi if ((channelConfig & frontPair) != frontPair) { 5611f61d01508651b4475397414e1fe06af1ab8fadaGlenn Kasten loge("Front channels must be present in multichannel configurations"); 562d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi return false; 563d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi } 564d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi final int backPair = 565d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi AudioFormat.CHANNEL_OUT_BACK_LEFT | AudioFormat.CHANNEL_OUT_BACK_RIGHT; 566d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi if ((channelConfig & backPair) != 0) { 567d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi if ((channelConfig & backPair) != backPair) { 5681f61d01508651b4475397414e1fe06af1ab8fadaGlenn Kasten loge("Rear channels can't be used independently"); 569d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi return false; 570d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi } 571d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi } 572ad720aeea741d9058a7b4d326c9ab1b3ebcd7c62Andy Hung final int sidePair = 573ad720aeea741d9058a7b4d326c9ab1b3ebcd7c62Andy Hung AudioFormat.CHANNEL_OUT_SIDE_LEFT | AudioFormat.CHANNEL_OUT_SIDE_RIGHT; 574ad720aeea741d9058a7b4d326c9ab1b3ebcd7c62Andy Hung if ((channelConfig & sidePair) != 0 575ad720aeea741d9058a7b4d326c9ab1b3ebcd7c62Andy Hung && (channelConfig & sidePair) != sidePair) { 576ad720aeea741d9058a7b4d326c9ab1b3ebcd7c62Andy Hung loge("Side channels can't be used independently"); 577ad720aeea741d9058a7b4d326c9ab1b3ebcd7c62Andy Hung return false; 578ad720aeea741d9058a7b4d326c9ab1b3ebcd7c62Andy Hung } 579d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi return true; 580d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi } 581d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi 5829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 583e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten // Convenience method for the constructor's audio buffer size check. 5849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // preconditions: 5859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // mChannelCount is valid 5869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // mAudioFormat is valid 5879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // postcondition: 5889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // mNativeBufferSizeInBytes is valid (multiple of frame size, positive) 5899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private void audioBuffSizeCheck(int audioBufferSize) { 5909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // NB: this section is only valid with PCM data. 5919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // To update when supporting compressed formats 592ff0d9f098e51c54e1a030ed21fd980680cb7b405Eric Laurent int frameSizeInBytes; 593ff0d9f098e51c54e1a030ed21fd980680cb7b405Eric Laurent if (AudioFormat.isEncodingLinearPcm(mAudioFormat)) { 594ff0d9f098e51c54e1a030ed21fd980680cb7b405Eric Laurent frameSizeInBytes = mChannelCount 595ff0d9f098e51c54e1a030ed21fd980680cb7b405Eric Laurent * (AudioFormat.getBytesPerSample(mAudioFormat)); 596ff0d9f098e51c54e1a030ed21fd980680cb7b405Eric Laurent } else { 597ff0d9f098e51c54e1a030ed21fd980680cb7b405Eric Laurent frameSizeInBytes = 1; 598ff0d9f098e51c54e1a030ed21fd980680cb7b405Eric Laurent } 5999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if ((audioBufferSize % frameSizeInBytes != 0) || (audioBufferSize < 1)) { 600f4e58051e22ad4e21c7cd436c37cc5665c194d1cGlenn Kasten throw new IllegalArgumentException("Invalid audio buffer size."); 6019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mNativeBufferSizeInBytes = audioBufferSize; 604e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten mNativeBufferSizeInFrames = audioBufferSize / frameSizeInBytes; 6059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Releases the native AudioTrack resources. 6109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void release() { 6129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // even though native_release() stops the native AudioTrack, we need to stop 6139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // AudioTrack subclasses too. 6149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 6159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project stop(); 616fb2ab9efc3805c81521afb9ff91a58ff5097a36eGlenn Kasten } catch(IllegalStateException ise) { 6179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // don't raise an exception, we're releasing the resources. 6189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project native_release(); 6209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mState = STATE_UNINITIALIZED; 6219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 6249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project protected void finalize() { 6259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project native_finalize(); 6269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //-------------------------------------------------------------------------- 6299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Getters 6309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //-------------------- 6319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 63278cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * Returns the minimum gain value, which is the constant 0.0. 63378cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * Gain values less than 0.0 will be clamped to 0.0. 63478cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * <p>The word "volume" in the API name is historical; this is actually a linear gain. 63578cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * @return the minimum value, which is the constant 0.0. 6369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project static public float getMinVolume() { 63878cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten return GAIN_MIN; 6399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 64278cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * Returns the maximum gain value, which is greater than or equal to 1.0. 64378cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * Gain values greater than the maximum will be clamped to the maximum. 64478cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * <p>The word "volume" in the API name is historical; this is actually a gain. 64578cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * expressed as a linear multiplier on sample values, where a maximum value of 1.0 64678cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * corresponds to a gain of 0 dB (sample values left unmodified). 64778cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * @return the maximum value, which is greater than or equal to 1.0. 6489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project static public float getMaxVolume() { 65078cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten return GAIN_MAX; 6519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the configured audio data sample rate in Hz 6559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getSampleRate() { 6579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mSampleRate; 6589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 659fb2ab9efc3805c81521afb9ff91a58ff5097a36eGlenn Kasten 6609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 66188e209dcf8c2ebddda5c272f46d1bd5478bc639cEric Laurent * Returns the current playback rate in Hz. 6629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getPlaybackRate() { 6649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return native_get_playback_rate(); 6659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the configured audio data format. See {@link AudioFormat#ENCODING_PCM_16BIT} 6699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * and {@link AudioFormat#ENCODING_PCM_8BIT}. 6709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getAudioFormat() { 6729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mAudioFormat; 6739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the type of audio stream this AudioTrack is configured for. 6779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Compare the result against {@link AudioManager#STREAM_VOICE_CALL}, 6789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link AudioManager#STREAM_SYSTEM}, {@link AudioManager#STREAM_RING}, 6795c17a820f9e46e0756c11795b3e6f89105f2f539Glenn Kasten * {@link AudioManager#STREAM_MUSIC}, {@link AudioManager#STREAM_ALARM}, 680b282e08ab641d4fc74d0324b7a0ce30926638dd5Glenn Kasten * {@link AudioManager#STREAM_NOTIFICATION}, or {@link AudioManager#STREAM_DTMF}. 6819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getStreamType() { 6839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mStreamType; 6849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the configured channel configuration. 688a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * See {@link AudioFormat#CHANNEL_OUT_MONO} 689a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * and {@link AudioFormat#CHANNEL_OUT_STEREO}. 6909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getChannelConfiguration() { 6929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mChannelConfiguration; 6939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the configured number of channels. 6979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getChannelCount() { 6999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mChannelCount; 7009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the state of the AudioTrack instance. This is useful after the 7049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * AudioTrack instance has been created to check if it was initialized 705e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * properly. This ensures that the appropriate resources have been acquired. 706ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * @see #STATE_INITIALIZED 707ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * @see #STATE_NO_STATIC_DATA 708ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * @see #STATE_UNINITIALIZED 7099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getState() { 7119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mState; 7129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the playback state of the AudioTrack instance. 7169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #PLAYSTATE_STOPPED 7179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #PLAYSTATE_PAUSED 7189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #PLAYSTATE_PLAYING 7199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getPlayState() { 72106e0333c7eb50533cc6e0f7b61812d2840844296Narayan Kamath synchronized (mPlayStateLock) { 72206e0333c7eb50533cc6e0f7b61812d2840844296Narayan Kamath return mPlayState; 72306e0333c7eb50533cc6e0f7b61812d2840844296Narayan Kamath } 7249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 727e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * Returns the "native frame count", derived from the bufferSizeInBytes specified at 728e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * creation time and converted to frame units. 729e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * If track's creation mode is {@link #MODE_STATIC}, 730e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * it is equal to the specified bufferSizeInBytes converted to frame units. 731e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * If track's creation mode is {@link #MODE_STREAM}, 732e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * it is typically greater than or equal to the specified bufferSizeInBytes converted to frame 733e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * units; it may be rounded up to a larger value if needed by the target device implementation. 73455a3218f242a611afb3569d88970c0c5dbf8ce54Glenn Kasten * @deprecated Only accessible by subclasses, which are not recommended for AudioTrack. 73555a3218f242a611afb3569d88970c0c5dbf8ce54Glenn Kasten * See {@link AudioManager#getProperty(String)} for key 73655a3218f242a611afb3569d88970c0c5dbf8ce54Glenn Kasten * {@link AudioManager#PROPERTY_OUTPUT_FRAMES_PER_BUFFER}. 7379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 73855a3218f242a611afb3569d88970c0c5dbf8ce54Glenn Kasten @Deprecated 7399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project protected int getNativeFrameCount() { 7409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return native_get_native_frame_count(); 7419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 744ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * Returns marker position expressed in frames. 745e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * @return marker position in wrapping frame units similar to {@link #getPlaybackHeadPosition}, 746e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * or zero if marker is disabled. 7479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getNotificationMarkerPosition() { 7499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return native_get_marker_pos(); 7509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 753ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * Returns the notification update period expressed in frames. 754e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * Zero means that no position update notifications are being delivered. 7559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getPositionNotificationPeriod() { 7579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return native_get_pos_update_period(); 7589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 761e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * Returns the playback head position expressed in frames. 762e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * Though the "int" type is signed 32-bits, the value should be reinterpreted as if it is 763e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * unsigned 32-bits. That is, the next position after 0x7FFFFFFF is (int) 0x80000000. 764e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * This is a continuously advancing counter. It will wrap (overflow) periodically, 765e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * for example approximately once every 27:03:11 hours:minutes:seconds at 44.1 kHz. 766e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * It is reset to zero by flush(), reload(), and stop(). 7679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getPlaybackHeadPosition() { 7699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return native_get_position(); 7709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 77361dcdf3764b614c6f01e77cb4342d192e3101f8aOliver Woodman * Returns this track's estimated latency in milliseconds. This includes the latency due 77461dcdf3764b614c6f01e77cb4342d192e3101f8aOliver Woodman * to AudioTrack buffer size, AudioMixer (if any) and audio hardware driver. 77561dcdf3764b614c6f01e77cb4342d192e3101f8aOliver Woodman * 77661dcdf3764b614c6f01e77cb4342d192e3101f8aOliver Woodman * DO NOT UNHIDE. The existing approach for doing A/V sync has too many problems. We need 77761dcdf3764b614c6f01e77cb4342d192e3101f8aOliver Woodman * a better solution. 77861dcdf3764b614c6f01e77cb4342d192e3101f8aOliver Woodman * @hide 77961dcdf3764b614c6f01e77cb4342d192e3101f8aOliver Woodman */ 78061dcdf3764b614c6f01e77cb4342d192e3101f8aOliver Woodman public int getLatency() { 78161dcdf3764b614c6f01e77cb4342d192e3101f8aOliver Woodman return native_get_latency(); 78261dcdf3764b614c6f01e77cb4342d192e3101f8aOliver Woodman } 78361dcdf3764b614c6f01e77cb4342d192e3101f8aOliver Woodman 78461dcdf3764b614c6f01e77cb4342d192e3101f8aOliver Woodman /** 785e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * Returns the output sample rate in Hz for the specified stream type. 7869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project static public int getNativeOutputSampleRate(int streamType) { 7889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return native_get_output_sample_rate(streamType); 7899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 790fb2ab9efc3805c81521afb9ff91a58ff5097a36eGlenn Kasten 7919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the minimum buffer size required for the successful creation of an AudioTrack 793ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * object to be created in the {@link #MODE_STREAM} mode. Note that this size doesn't 794ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * guarantee a smooth playback under load, and higher values should be chosen according to 795fb2ab9efc3805c81521afb9ff91a58ff5097a36eGlenn Kasten * the expected frequency at which the buffer will be refilled with additional data to play. 7968d7fa137466c833ed422053204fb4c506b7bb209Glenn Kasten * For example, if you intend to dynamically set the source sample rate of an AudioTrack 7978d7fa137466c833ed422053204fb4c506b7bb209Glenn Kasten * to a higher value than the initial source sample rate, be sure to configure the buffer size 7988d7fa137466c833ed422053204fb4c506b7bb209Glenn Kasten * based on the highest planned sample rate. 7998d7fa137466c833ed422053204fb4c506b7bb209Glenn Kasten * @param sampleRateInHz the source sample rate expressed in Hz. 800fb2ab9efc3805c81521afb9ff91a58ff5097a36eGlenn Kasten * @param channelConfig describes the configuration of the audio channels. 801a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * See {@link AudioFormat#CHANNEL_OUT_MONO} and 802a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * {@link AudioFormat#CHANNEL_OUT_STEREO} 803fb2ab9efc3805c81521afb9ff91a58ff5097a36eGlenn Kasten * @param audioFormat the format in which the audio data is represented. 804fb2ab9efc3805c81521afb9ff91a58ff5097a36eGlenn Kasten * See {@link AudioFormat#ENCODING_PCM_16BIT} and 8057d60bcd2d950e3571c00ce9f1c492c6bd58334c9Glenn Kasten * {@link AudioFormat#ENCODING_PCM_8BIT}, 8067d60bcd2d950e3571c00ce9f1c492c6bd58334c9Glenn Kasten * and {@link AudioFormat#ENCODING_PCM_FLOAT}. 8079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return {@link #ERROR_BAD_VALUE} if an invalid parameter was passed, 808e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * or {@link #ERROR} if unable to query for output properties, 809ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * or the minimum buffer size expressed in bytes. 8109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project static public int getMinBufferSize(int sampleRateInHz, int channelConfig, int audioFormat) { 8129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int channelCount = 0; 8139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project switch(channelConfig) { 814a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent case AudioFormat.CHANNEL_OUT_MONO: 8153026a023b8979b7ddcb3fe97bbc45531c89fda92Eric Laurent case AudioFormat.CHANNEL_CONFIGURATION_MONO: 8169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project channelCount = 1; 8179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project break; 818a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent case AudioFormat.CHANNEL_OUT_STEREO: 8193026a023b8979b7ddcb3fe97bbc45531c89fda92Eric Laurent case AudioFormat.CHANNEL_CONFIGURATION_STEREO: 8209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project channelCount = 2; 8219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project break; 8229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project default: 8231b8f499a14a4340d3422d95c7f6fdc8c0c72b3a4Jean-Michel Trivi if ((channelConfig & SUPPORTED_OUT_CHANNELS) != channelConfig) { 8241b8f499a14a4340d3422d95c7f6fdc8c0c72b3a4Jean-Michel Trivi // input channel configuration features unsupported channels 8251b8f499a14a4340d3422d95c7f6fdc8c0c72b3a4Jean-Michel Trivi loge("getMinBufferSize(): Invalid channel configuration."); 826df3cb5279857cac41909643c6703e8fc1621fad1Glenn Kasten return ERROR_BAD_VALUE; 8271b8f499a14a4340d3422d95c7f6fdc8c0c72b3a4Jean-Michel Trivi } else { 8281b8f499a14a4340d3422d95c7f6fdc8c0c72b3a4Jean-Michel Trivi channelCount = Integer.bitCount(channelConfig); 8291b8f499a14a4340d3422d95c7f6fdc8c0c72b3a4Jean-Michel Trivi } 8309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 831fb2ab9efc3805c81521afb9ff91a58ff5097a36eGlenn Kasten 832ff0d9f098e51c54e1a030ed21fd980680cb7b405Eric Laurent if (!AudioFormat.isValidEncoding(audioFormat)) { 8339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project loge("getMinBufferSize(): Invalid audio format."); 834df3cb5279857cac41909643c6703e8fc1621fad1Glenn Kasten return ERROR_BAD_VALUE; 8359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 836fb2ab9efc3805c81521afb9ff91a58ff5097a36eGlenn Kasten 8375c17a820f9e46e0756c11795b3e6f89105f2f539Glenn Kasten // sample rate, note these values are subject to change 838ad67c9546494a7c4d9336b57889a7c19a7dbb945Glenn Kasten if ( (sampleRateInHz < SAMPLE_RATE_HZ_MIN) || (sampleRateInHz > SAMPLE_RATE_HZ_MAX) ) { 839ad67c9546494a7c4d9336b57889a7c19a7dbb945Glenn Kasten loge("getMinBufferSize(): " + sampleRateInHz + " Hz is not a supported sample rate."); 840df3cb5279857cac41909643c6703e8fc1621fad1Glenn Kasten return ERROR_BAD_VALUE; 8419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 842fb2ab9efc3805c81521afb9ff91a58ff5097a36eGlenn Kasten 8439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int size = native_get_min_buff_size(sampleRateInHz, channelCount, audioFormat); 844a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten if (size <= 0) { 8459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project loge("getMinBufferSize(): error querying hardware"); 846df3cb5279857cac41909643c6703e8fc1621fad1Glenn Kasten return ERROR; 8479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project else { 8499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return size; 8509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 853619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent /** 854619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * Returns the audio session ID. 855619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * 856619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * @return the ID of the audio session this AudioTrack belongs to. 857619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent */ 858619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent public int getAudioSessionId() { 859619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent return mSessionId; 860619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent } 8619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 862948c2e6ff46d65942277f2e0e9ce0c038972b9d8Glenn Kasten /** 863948c2e6ff46d65942277f2e0e9ce0c038972b9d8Glenn Kasten * Poll for a timestamp on demand. 864486918b41584cd2589c46c5217b3fba1e7d18874Glenn Kasten * <p> 865486918b41584cd2589c46c5217b3fba1e7d18874Glenn Kasten * If you need to track timestamps during initial warmup or after a routing or mode change, 866486918b41584cd2589c46c5217b3fba1e7d18874Glenn Kasten * you should request a new timestamp once per second until the reported timestamps 867486918b41584cd2589c46c5217b3fba1e7d18874Glenn Kasten * show that the audio clock is stable. 868486918b41584cd2589c46c5217b3fba1e7d18874Glenn Kasten * Thereafter, query for a new timestamp approximately once every 10 seconds to once per minute. 869486918b41584cd2589c46c5217b3fba1e7d18874Glenn Kasten * Calling this method more often is inefficient. 870486918b41584cd2589c46c5217b3fba1e7d18874Glenn Kasten * It is also counter-productive to call this method more often than recommended, 871486918b41584cd2589c46c5217b3fba1e7d18874Glenn Kasten * because the short-term differences between successive timestamp reports are not meaningful. 872486918b41584cd2589c46c5217b3fba1e7d18874Glenn Kasten * If you need a high-resolution mapping between frame position and presentation time, 873948c2e6ff46d65942277f2e0e9ce0c038972b9d8Glenn Kasten * consider implementing that at application level, based on low-resolution timestamps. 874486918b41584cd2589c46c5217b3fba1e7d18874Glenn Kasten * <p> 875948c2e6ff46d65942277f2e0e9ce0c038972b9d8Glenn Kasten * The audio data at the returned position may either already have been 876948c2e6ff46d65942277f2e0e9ce0c038972b9d8Glenn Kasten * presented, or may have not yet been presented but is committed to be presented. 877948c2e6ff46d65942277f2e0e9ce0c038972b9d8Glenn Kasten * It is not possible to request the time corresponding to a particular position, 878948c2e6ff46d65942277f2e0e9ce0c038972b9d8Glenn Kasten * or to request the (fractional) position corresponding to a particular time. 879948c2e6ff46d65942277f2e0e9ce0c038972b9d8Glenn Kasten * If you need such features, consider implementing them at application level. 880948c2e6ff46d65942277f2e0e9ce0c038972b9d8Glenn Kasten * 881948c2e6ff46d65942277f2e0e9ce0c038972b9d8Glenn Kasten * @param timestamp a reference to a non-null AudioTimestamp instance allocated 882596fb8e7969cafdf7f25dfdc97372be4c0950cc3Glenn Kasten * and owned by caller. 883596fb8e7969cafdf7f25dfdc97372be4c0950cc3Glenn Kasten * @return true if a timestamp is available, or false if no timestamp is available. 884596fb8e7969cafdf7f25dfdc97372be4c0950cc3Glenn Kasten * If a timestamp if available, 885948c2e6ff46d65942277f2e0e9ce0c038972b9d8Glenn Kasten * the AudioTimestamp instance is filled in with a position in frame units, together 886948c2e6ff46d65942277f2e0e9ce0c038972b9d8Glenn Kasten * with the estimated time when that frame was presented or is committed to 887948c2e6ff46d65942277f2e0e9ce0c038972b9d8Glenn Kasten * be presented. 888948c2e6ff46d65942277f2e0e9ce0c038972b9d8Glenn Kasten * In the case that no timestamp is available, any supplied instance is left unaltered. 889c52f4e25e21719d5d637a588e3200be941b9fe4dGlenn Kasten * A timestamp may be temporarily unavailable while the audio clock is stabilizing, 890c52f4e25e21719d5d637a588e3200be941b9fe4dGlenn Kasten * or during and immediately after a route change. 891948c2e6ff46d65942277f2e0e9ce0c038972b9d8Glenn Kasten */ 892486918b41584cd2589c46c5217b3fba1e7d18874Glenn Kasten // Add this text when the "on new timestamp" API is added: 893486918b41584cd2589c46c5217b3fba1e7d18874Glenn Kasten // Use if you need to get the most recent timestamp outside of the event callback handler. 894596fb8e7969cafdf7f25dfdc97372be4c0950cc3Glenn Kasten public boolean getTimestamp(AudioTimestamp timestamp) 895948c2e6ff46d65942277f2e0e9ce0c038972b9d8Glenn Kasten { 896596fb8e7969cafdf7f25dfdc97372be4c0950cc3Glenn Kasten if (timestamp == null) { 897596fb8e7969cafdf7f25dfdc97372be4c0950cc3Glenn Kasten throw new IllegalArgumentException(); 898596fb8e7969cafdf7f25dfdc97372be4c0950cc3Glenn Kasten } 899948c2e6ff46d65942277f2e0e9ce0c038972b9d8Glenn Kasten // It's unfortunate, but we have to either create garbage every time or use synchronized 900948c2e6ff46d65942277f2e0e9ce0c038972b9d8Glenn Kasten long[] longArray = new long[2]; 901948c2e6ff46d65942277f2e0e9ce0c038972b9d8Glenn Kasten int ret = native_get_timestamp(longArray); 902596fb8e7969cafdf7f25dfdc97372be4c0950cc3Glenn Kasten if (ret != SUCCESS) { 903596fb8e7969cafdf7f25dfdc97372be4c0950cc3Glenn Kasten return false; 904948c2e6ff46d65942277f2e0e9ce0c038972b9d8Glenn Kasten } 905596fb8e7969cafdf7f25dfdc97372be4c0950cc3Glenn Kasten timestamp.framePosition = longArray[0]; 906596fb8e7969cafdf7f25dfdc97372be4c0950cc3Glenn Kasten timestamp.nanoTime = longArray[1]; 907596fb8e7969cafdf7f25dfdc97372be4c0950cc3Glenn Kasten return true; 908948c2e6ff46d65942277f2e0e9ce0c038972b9d8Glenn Kasten } 909948c2e6ff46d65942277f2e0e9ce0c038972b9d8Glenn Kasten 910948c2e6ff46d65942277f2e0e9ce0c038972b9d8Glenn Kasten 9119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //-------------------------------------------------------------------------- 9129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Initialization / configuration 9139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //-------------------- 9149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9154df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project * Sets the listener the AudioTrack notifies when a previously set marker is reached or 9164df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project * for each periodic playback head position update. 917ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * Notifications will be received in the same thread as the one in which the AudioTrack 918ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * instance was created. 9199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param listener 9209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9214df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project public void setPlaybackPositionUpdateListener(OnPlaybackPositionUpdateListener listener) { 9224df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project setPlaybackPositionUpdateListener(listener, null); 9239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 924fb2ab9efc3805c81521afb9ff91a58ff5097a36eGlenn Kasten 925ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi /** 926ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * Sets the listener the AudioTrack notifies when a previously set marker is reached or 927ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * for each periodic playback head position update. 928ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * Use this method to receive AudioTrack events in the Handler associated with another 929ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * thread than the one in which you created the AudioTrack instance. 930ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * @param listener 931ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * @param handler the Handler that will receive the event notification messages. 932ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi */ 933fb2ab9efc3805c81521afb9ff91a58ff5097a36eGlenn Kasten public void setPlaybackPositionUpdateListener(OnPlaybackPositionUpdateListener listener, 9344df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project Handler handler) { 9354df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project if (listener != null) { 93695bd2329c6a36211f18be3e089eaa775ec62df62Glenn Kasten mEventHandlerDelegate = new NativeEventHandlerDelegate(this, listener, handler); 93795bd2329c6a36211f18be3e089eaa775ec62df62Glenn Kasten } else { 93895bd2329c6a36211f18be3e089eaa775ec62df62Glenn Kasten mEventHandlerDelegate = null; 9399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 94378cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten private static float clampGainOrLevel(float gainOrLevel) { 94478cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten if (Float.isNaN(gainOrLevel)) { 94578cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten throw new IllegalArgumentException(); 94678cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten } 94778cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten if (gainOrLevel < GAIN_MIN) { 94878cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten gainOrLevel = GAIN_MIN; 94978cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten } else if (gainOrLevel > GAIN_MAX) { 95078cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten gainOrLevel = GAIN_MAX; 95178cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten } 95278cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten return gainOrLevel; 95378cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten } 95478cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten 9554df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project 9569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 95778cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * Sets the specified left and right output gain values on the AudioTrack. 95878cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * <p>Gain values are clamped to the closed interval [0.0, max] where 95978cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * max is the value of {@link #getMaxVolume}. 96078cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * A value of 0.0 results in zero gain (silence), and 96178cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * a value of 1.0 means unity gain (signal unchanged). 96278cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * The default value is 1.0 meaning unity gain. 96378cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * <p>The word "volume" in the API name is historical; this is actually a linear gain. 96478cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * @param leftGain output gain for the left channel. 96578cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * @param rightGain output gain for the right channel 9669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return error code or success, see {@link #SUCCESS}, 9679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #ERROR_INVALID_OPERATION} 96878cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * @deprecated Applications should use {@link #setVolume} instead, as it 96978cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * more gracefully scales down to mono, and up to multi-channel content beyond stereo. 9709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 97178cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten public int setStereoVolume(float leftGain, float rightGain) { 9721af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlock if (isRestricted()) { 9731af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlock return SUCCESS; 9741af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlock } 9753b4df62704a6184878afd9272830cf3db7bd2d66Glenn Kasten if (mState == STATE_UNINITIALIZED) { 9769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return ERROR_INVALID_OPERATION; 9779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 97978cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten leftGain = clampGainOrLevel(leftGain); 98078cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten rightGain = clampGainOrLevel(rightGain); 9819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 98278cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten native_setVolume(leftGain, rightGain); 9839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return SUCCESS; 9859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 98978cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * Sets the specified output gain value on all channels of this track. 99078cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * <p>Gain values are clamped to the closed interval [0.0, max] where 99178cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * max is the value of {@link #getMaxVolume}. 99278cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * A value of 0.0 results in zero gain (silence), and 99378cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * a value of 1.0 means unity gain (signal unchanged). 99478cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * The default value is 1.0 meaning unity gain. 99578cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * <p>This API is preferred over {@link #setStereoVolume}, as it 99678cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * more gracefully scales down to mono, and up to multi-channel content beyond stereo. 99778cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * <p>The word "volume" in the API name is historical; this is actually a linear gain. 99878cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * @param gain output gain for all channels. 9993e21cc8140e42bdcd924590e5e12446b6c55ad2aGlenn Kasten * @return error code or success, see {@link #SUCCESS}, 10003e21cc8140e42bdcd924590e5e12446b6c55ad2aGlenn Kasten * {@link #ERROR_INVALID_OPERATION} 1001068225de0197df07a0247b2877666ea91c22c992Glenn Kasten */ 100278cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten public int setVolume(float gain) { 100378cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten return setStereoVolume(gain, gain); 1004068225de0197df07a0247b2877666ea91c22c992Glenn Kasten } 1005068225de0197df07a0247b2877666ea91c22c992Glenn Kasten 1006068225de0197df07a0247b2877666ea91c22c992Glenn Kasten 1007068225de0197df07a0247b2877666ea91c22c992Glenn Kasten /** 10089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets the playback sample rate for this track. This sets the sampling rate at which 10098d7fa137466c833ed422053204fb4c506b7bb209Glenn Kasten * the audio data will be consumed and played back 10108d7fa137466c833ed422053204fb4c506b7bb209Glenn Kasten * (as set by the sampleRateInHz parameter in the 10118d7fa137466c833ed422053204fb4c506b7bb209Glenn Kasten * {@link #AudioTrack(int, int, int, int, int, int)} constructor), 10128d7fa137466c833ed422053204fb4c506b7bb209Glenn Kasten * not the original sampling rate of the 1013e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * content. For example, setting it to half the sample rate of the content will cause the 1014e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * playback to last twice as long, but will also result in a pitch shift down by one octave. 1015e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * The valid sample rate range is from 1 Hz to twice the value returned by 101688e209dcf8c2ebddda5c272f46d1bd5478bc639cEric Laurent * {@link #getNativeOutputSampleRate(int)}. 1017ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * @param sampleRateInHz the sample rate expressed in Hz 10189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return error code or success, see {@link #SUCCESS}, {@link #ERROR_BAD_VALUE}, 10199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #ERROR_INVALID_OPERATION} 10209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 10219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int setPlaybackRate(int sampleRateInHz) { 1022f19395db6343efdf80d064e0ba7c3b9aa4dbae75Glenn Kasten if (mState != STATE_INITIALIZED) { 10239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return ERROR_INVALID_OPERATION; 10249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (sampleRateInHz <= 0) { 10269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return ERROR_BAD_VALUE; 10279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 102888e209dcf8c2ebddda5c272f46d1bd5478bc639cEric Laurent return native_set_playback_rate(sampleRateInHz); 10299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1033e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * Sets the position of the notification marker. At most one marker can be active. 1034e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * @param markerInFrames marker position in wrapping frame units similar to 1035e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * {@link #getPlaybackHeadPosition}, or zero to disable the marker. 1036e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * To set a marker at a position which would appear as zero due to wraparound, 1037e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * a workaround is to use a non-zero position near zero, such as -1 or 1. 10389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return error code or success, see {@link #SUCCESS}, {@link #ERROR_BAD_VALUE}, 10399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #ERROR_INVALID_OPERATION} 10409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 10419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int setNotificationMarkerPosition(int markerInFrames) { 10423b4df62704a6184878afd9272830cf3db7bd2d66Glenn Kasten if (mState == STATE_UNINITIALIZED) { 10439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return ERROR_INVALID_OPERATION; 10449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return native_set_marker_pos(markerInFrames); 10469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1050ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * Sets the period for the periodic notification event. 1051ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * @param periodInFrames update period expressed in frames 10529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return error code or success, see {@link #SUCCESS}, {@link #ERROR_INVALID_OPERATION} 10539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 10549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int setPositionNotificationPeriod(int periodInFrames) { 10553b4df62704a6184878afd9272830cf3db7bd2d66Glenn Kasten if (mState == STATE_UNINITIALIZED) { 10569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return ERROR_INVALID_OPERATION; 10579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return native_set_pos_update_period(periodInFrames); 10599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1063a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten * Sets the playback head position. 1064a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten * The track must be stopped or paused for the position to be changed, 1065a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten * and must use the {@link #MODE_STATIC} mode. 1066ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * @param positionInFrames playback head position expressed in frames 1067e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * Zero corresponds to start of buffer. 1068e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * The position must not be greater than the buffer size in frames, or negative. 10699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return error code or success, see {@link #SUCCESS}, {@link #ERROR_BAD_VALUE}, 10709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #ERROR_INVALID_OPERATION} 10719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 10729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int setPlaybackHeadPosition(int positionInFrames) { 107378bfa6322bf34e49d5e4426296c701a64f705e49Andy Hung if (mDataLoadMode == MODE_STREAM || mState == STATE_UNINITIALIZED || 1074a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten getPlayState() == PLAYSTATE_PLAYING) { 1075a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten return ERROR_INVALID_OPERATION; 10769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1077e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten if (!(0 <= positionInFrames && positionInFrames <= mNativeBufferSizeInFrames)) { 1078e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten return ERROR_BAD_VALUE; 1079e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten } 1080a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten return native_set_position(positionInFrames); 10819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 10849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets the loop points and the loop count. The loop can be infinite. 1085a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten * Similarly to setPlaybackHeadPosition, 1086e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * the track must be stopped or paused for the loop points to be changed, 1087a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten * and must use the {@link #MODE_STATIC} mode. 1088ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * @param startInFrames loop start marker expressed in frames 1089e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * Zero corresponds to start of buffer. 1090e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * The start marker must not be greater than or equal to the buffer size in frames, or negative. 1091ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * @param endInFrames loop end marker expressed in frames 1092e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * The total buffer size in frames corresponds to end of buffer. 1093e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * The end marker must not be greater than the buffer size in frames. 1094e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * For looping, the end marker must not be less than or equal to the start marker, 1095e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * but to disable looping 1096e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * it is permitted for start marker, end marker, and loop count to all be 0. 10979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param loopCount the number of times the loop is looped. 1098e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * A value of -1 means infinite looping, and 0 disables looping. 10999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return error code or success, see {@link #SUCCESS}, {@link #ERROR_BAD_VALUE}, 11009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #ERROR_INVALID_OPERATION} 11019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 11029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int setLoopPoints(int startInFrames, int endInFrames, int loopCount) { 110378bfa6322bf34e49d5e4426296c701a64f705e49Andy Hung if (mDataLoadMode == MODE_STREAM || mState == STATE_UNINITIALIZED || 1104a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten getPlayState() == PLAYSTATE_PLAYING) { 11059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return ERROR_INVALID_OPERATION; 11069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1107e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten if (loopCount == 0) { 1108e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten ; // explicitly allowed as an exception to the loop region range check 1109e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten } else if (!(0 <= startInFrames && startInFrames < mNativeBufferSizeInFrames && 1110e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten startInFrames < endInFrames && endInFrames <= mNativeBufferSizeInFrames)) { 1111e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten return ERROR_BAD_VALUE; 1112e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten } 11139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return native_set_loop(startInFrames, endInFrames, loopCount); 11149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 111755a3218f242a611afb3569d88970c0c5dbf8ce54Glenn Kasten * Sets the initialization state of the instance. This method was originally intended to be used 111855a3218f242a611afb3569d88970c0c5dbf8ce54Glenn Kasten * in an AudioTrack subclass constructor to set a subclass-specific post-initialization state. 111955a3218f242a611afb3569d88970c0c5dbf8ce54Glenn Kasten * However, subclasses of AudioTrack are no longer recommended, so this method is obsolete. 11209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param state the state of the AudioTrack instance 112155a3218f242a611afb3569d88970c0c5dbf8ce54Glenn Kasten * @deprecated Only accessible by subclasses, which are not recommended for AudioTrack. 11229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 112355a3218f242a611afb3569d88970c0c5dbf8ce54Glenn Kasten @Deprecated 11249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project protected void setState(int state) { 11259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mState = state; 11269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //--------------------------------------------------------- 11309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Transport control methods 11319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //-------------------- 11329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Starts playing an AudioTrack. 1134e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * If track's creation mode is {@link #MODE_STATIC}, you must have called write() prior. 113588bde0ce3799c47530ea42ae3665bfa12ae38d11Narayan Kamath * 11369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws IllegalStateException 11379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 11389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void play() 11399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throws IllegalStateException { 11409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mState != STATE_INITIALIZED) { 1141f4e58051e22ad4e21c7cd436c37cc5665c194d1cGlenn Kasten throw new IllegalStateException("play() called on uninitialized AudioTrack."); 11429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11431af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlock if (isRestricted()) { 11441af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlock setVolume(0); 11451af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlock } 11469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project synchronized(mPlayStateLock) { 11479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project native_start(); 11489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mPlayState = PLAYSTATE_PLAYING; 11499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11521af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlock private boolean isRestricted() { 11531af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlock try { 11547b41467704f941b11af6aace3e40993afc7f6c6fJohn Spurlock final int usage = AudioAttributes.usageForLegacyStreamType(mStreamType); 11557b41467704f941b11af6aace3e40993afc7f6c6fJohn Spurlock final int mode = mAppOps.checkAudioOperation(AppOpsManager.OP_PLAY_AUDIO, usage, 11561af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlock Process.myUid(), ActivityThread.currentPackageName()); 11571af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlock return mode != AppOpsManager.MODE_ALLOWED; 11581af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlock } catch (RemoteException e) { 11591af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlock return false; 11601af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlock } 11611af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlock } 11621af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlock 11639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Stops playing the audio data. 1165a701da8ebabb3d63ac57b7718055698abb21804aJean-Michel Trivi * When used on an instance created in {@link #MODE_STREAM} mode, audio will stop playing 1166a701da8ebabb3d63ac57b7718055698abb21804aJean-Michel Trivi * after the last buffer that was written has been played. For an immediate stop, use 1167a701da8ebabb3d63ac57b7718055698abb21804aJean-Michel Trivi * {@link #pause()}, followed by {@link #flush()} to discard audio data that hasn't been played 1168a701da8ebabb3d63ac57b7718055698abb21804aJean-Michel Trivi * back yet. 11699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws IllegalStateException 11709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 11719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void stop() 11729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throws IllegalStateException { 11739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mState != STATE_INITIALIZED) { 1174f4e58051e22ad4e21c7cd436c37cc5665c194d1cGlenn Kasten throw new IllegalStateException("stop() called on uninitialized AudioTrack."); 11759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // stop playing 11789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project synchronized(mPlayStateLock) { 11799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project native_stop(); 11809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mPlayState = PLAYSTATE_STOPPED; 11819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 118588bde0ce3799c47530ea42ae3665bfa12ae38d11Narayan Kamath * Pauses the playback of the audio data. Data that has not been played 118688bde0ce3799c47530ea42ae3665bfa12ae38d11Narayan Kamath * back will not be discarded. Subsequent calls to {@link #play} will play 1187a701da8ebabb3d63ac57b7718055698abb21804aJean-Michel Trivi * this data back. See {@link #flush()} to discard this data. 118888bde0ce3799c47530ea42ae3665bfa12ae38d11Narayan Kamath * 11899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws IllegalStateException 11909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 11919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void pause() 11929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throws IllegalStateException { 11939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mState != STATE_INITIALIZED) { 1194f4e58051e22ad4e21c7cd436c37cc5665c194d1cGlenn Kasten throw new IllegalStateException("pause() called on uninitialized AudioTrack."); 11959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //logd("pause()"); 11979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // pause playback 11999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project synchronized(mPlayStateLock) { 12009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project native_pause(); 12019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mPlayState = PLAYSTATE_PAUSED; 12029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //--------------------------------------------------------- 12079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Audio data supply 12089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //-------------------- 12099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 121188bde0ce3799c47530ea42ae3665bfa12ae38d11Narayan Kamath * Flushes the audio data currently queued for playback. Any data that has 1212e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * not been played back will be discarded. No-op if not stopped or paused, 1213e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * or if the track's creation mode is not {@link #MODE_STREAM}. 12149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 12159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void flush() { 12169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mState == STATE_INITIALIZED) { 12179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // flush the data in native layer 12189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project native_flush(); 12199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1224e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * Writes the audio data to the audio sink for playback (streaming mode), 1225e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * or copies audio data for later playback (static buffer mode). 1226e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * In streaming mode, will block until all data has been written to the audio sink. 1227e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * In static buffer mode, copies the data to the buffer starting at offset 0. 122888bde0ce3799c47530ea42ae3665bfa12ae38d11Narayan Kamath * Note that the actual playback of this data might occur after this function 122988bde0ce3799c47530ea42ae3665bfa12ae38d11Narayan Kamath * returns. This function is thread safe with respect to {@link #stop} calls, 1230e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * in which case all of the specified data might not be written to the audio sink. 123188bde0ce3799c47530ea42ae3665bfa12ae38d11Narayan Kamath * 12329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param audioData the array that holds the data to play. 123388bde0ce3799c47530ea42ae3665bfa12ae38d11Narayan Kamath * @param offsetInBytes the offset expressed in bytes in audioData where the data to play 1234ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * starts. 12359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param sizeInBytes the number of bytes to read in audioData after the offset. 12369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return the number of bytes that were written or {@link #ERROR_INVALID_OPERATION} 12379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * if the object wasn't properly initialized, or {@link #ERROR_BAD_VALUE} if 1238ff0d9f098e51c54e1a030ed21fd980680cb7b405Eric Laurent * the parameters don't resolve to valid data and indexes, or 1239ff0d9f098e51c54e1a030ed21fd980680cb7b405Eric Laurent * {@link AudioManager#ERROR_DEAD_OBJECT} if the AudioTrack is not valid anymore and 1240ff0d9f098e51c54e1a030ed21fd980680cb7b405Eric Laurent * needs to be recreated. 12419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 12429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12435c17a820f9e46e0756c11795b3e6f89105f2f539Glenn Kasten public int write(byte[] audioData, int offsetInBytes, int sizeInBytes) { 12449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 124554955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten if (mState == STATE_UNINITIALIZED || mAudioFormat == AudioFormat.ENCODING_PCM_FLOAT) { 12469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return ERROR_INVALID_OPERATION; 12479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1249fb2ab9efc3805c81521afb9ff91a58ff5097a36eGlenn Kasten if ( (audioData == null) || (offsetInBytes < 0 ) || (sizeInBytes < 0) 1250a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten || (offsetInBytes + sizeInBytes < 0) // detect integer overflow 12519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project || (offsetInBytes + sizeInBytes > audioData.length)) { 12529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return ERROR_BAD_VALUE; 12539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12557ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi int ret = native_write_byte(audioData, offsetInBytes, sizeInBytes, mAudioFormat, 12567ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi true /*isBlocking*/); 1257a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten 1258a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten if ((mDataLoadMode == MODE_STATIC) 1259a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten && (mState == STATE_NO_STATIC_DATA) 1260a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten && (ret > 0)) { 1261a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten // benign race with respect to other APIs that read mState 1262a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten mState = STATE_INITIALIZED; 1263a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten } 1264a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten 1265a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten return ret; 12669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1270e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * Writes the audio data to the audio sink for playback (streaming mode), 1271e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * or copies audio data for later playback (static buffer mode). 1272e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * In streaming mode, will block until all data has been written to the audio sink. 1273e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * In static buffer mode, copies the data to the buffer starting at offset 0. 127488bde0ce3799c47530ea42ae3665bfa12ae38d11Narayan Kamath * Note that the actual playback of this data might occur after this function 127588bde0ce3799c47530ea42ae3665bfa12ae38d11Narayan Kamath * returns. This function is thread safe with respect to {@link #stop} calls, 1276e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * in which case all of the specified data might not be written to the audio sink. 127788bde0ce3799c47530ea42ae3665bfa12ae38d11Narayan Kamath * 12789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param audioData the array that holds the data to play. 1279ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * @param offsetInShorts the offset expressed in shorts in audioData where the data to play 1280ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * starts. 1281e8c82a37050e568f211d47951480b182a61d42b4Glenn Kasten * @param sizeInShorts the number of shorts to read in audioData after the offset. 12829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return the number of shorts that were written or {@link #ERROR_INVALID_OPERATION} 128354955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten * if the object wasn't properly initialized, or {@link #ERROR_BAD_VALUE} if 128454955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten * the parameters don't resolve to valid data and indexes. 12859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 12869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int write(short[] audioData, int offsetInShorts, int sizeInShorts) { 1288fb2ab9efc3805c81521afb9ff91a58ff5097a36eGlenn Kasten 1289c56b8085919771b6f027dc64ed6a44915e392464Glenn Kasten if (mState == STATE_UNINITIALIZED || mAudioFormat == AudioFormat.ENCODING_PCM_FLOAT) { 12909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return ERROR_INVALID_OPERATION; 12919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1293fb2ab9efc3805c81521afb9ff91a58ff5097a36eGlenn Kasten if ( (audioData == null) || (offsetInShorts < 0 ) || (sizeInShorts < 0) 1294a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten || (offsetInShorts + sizeInShorts < 0) // detect integer overflow 12959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project || (offsetInShorts + sizeInShorts > audioData.length)) { 12969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return ERROR_BAD_VALUE; 12979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1299a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten int ret = native_write_short(audioData, offsetInShorts, sizeInShorts, mAudioFormat); 1300a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten 1301a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten if ((mDataLoadMode == MODE_STATIC) 1302a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten && (mState == STATE_NO_STATIC_DATA) 1303a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten && (ret > 0)) { 1304a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten // benign race with respect to other APIs that read mState 1305a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten mState = STATE_INITIALIZED; 1306a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten } 1307a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten 1308a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten return ret; 13099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 13137ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi * Writes the audio data to the audio sink for playback (streaming mode), 13147ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi * or copies audio data for later playback (static buffer mode). 131554955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten * In static buffer mode, copies the data to the buffer starting at offset 0, 131654955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten * and the write mode is ignored. 131754955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten * In streaming mode, the blocking behavior will depend on the write mode. 131854955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten * <p> 131954955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten * Note that the actual playback of this data might occur after this function 132054955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten * returns. This function is thread safe with respect to {@link #stop} calls, 132154955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten * in which case all of the specified data might not be written to the audio sink. 132254955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten * <p> 132354955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten * @param audioData the array that holds the data to play. 132454955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten * The implementation does not clip for sample values within the nominal range 132554955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten * [-1.0f, 1.0f], provided that all gains in the audio pipeline are 132654955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten * less than or equal to unity (1.0f), and in the absence of post-processing effects 132754955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten * that could add energy, such as reverb. For the convenience of applications 132854955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten * that compute samples using filters with non-unity gain, 132954955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten * sample values +3 dB beyond the nominal range are permitted. 133054955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten * However such values may eventually be limited or clipped, depending on various gains 133154955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten * and later processing in the audio path. Therefore applications are encouraged 133254955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten * to provide samples values within the nominal range. 133354955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten * @param offsetInFloats the offset, expressed as a number of floats, 133454955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten * in audioData where the data to play starts. 133554955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten * @param sizeInFloats the number of floats to read in audioData after the offset. 133654955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten * @param writeMode one of {@link #WRITE_BLOCKING}, {@link #WRITE_NON_BLOCKING}. It has no 133754955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten * effect in static mode. 133854955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten * <BR>With {@link #WRITE_BLOCKING}, the write will block until all data has been written 133954955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten * to the audio sink. 134054955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten * <BR>With {@link #WRITE_NON_BLOCKING}, the write will return immediately after 134154955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten * queuing as much audio data for playback as possible without blocking. 134254955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten * @return the number of floats that were written, or {@link #ERROR_INVALID_OPERATION} 134354955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten * if the object wasn't properly initialized, or {@link #ERROR_BAD_VALUE} if 134454955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten * the parameters don't resolve to valid data and indexes. 134554955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten */ 134654955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten public int write(float[] audioData, int offsetInFloats, int sizeInFloats, 134754955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten @WriteMode int writeMode) { 134854955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten 134954955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten if (mState == STATE_UNINITIALIZED) { 135054955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten Log.e(TAG, "AudioTrack.write() called in invalid state STATE_UNINITIALIZED"); 135154955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten return ERROR_INVALID_OPERATION; 135254955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten } 135354955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten 135454955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten if (mAudioFormat != AudioFormat.ENCODING_PCM_FLOAT) { 135554955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten Log.e(TAG, "AudioTrack.write(float[] ...) requires format ENCODING_PCM_FLOAT"); 135654955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten return ERROR_INVALID_OPERATION; 135754955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten } 135854955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten 135954955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten if ((writeMode != WRITE_BLOCKING) && (writeMode != WRITE_NON_BLOCKING)) { 136054955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten Log.e(TAG, "AudioTrack.write() called with invalid blocking mode"); 136154955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten return ERROR_BAD_VALUE; 136254955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten } 136354955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten 136454955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten if ( (audioData == null) || (offsetInFloats < 0 ) || (sizeInFloats < 0) 136554955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten || (offsetInFloats + sizeInFloats < 0) // detect integer overflow 136654955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten || (offsetInFloats + sizeInFloats > audioData.length)) { 136754955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten Log.e(TAG, "AudioTrack.write() called with invalid array, offset, or size"); 136854955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten return ERROR_BAD_VALUE; 136954955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten } 137054955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten 137154955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten int ret = native_write_float(audioData, offsetInFloats, sizeInFloats, mAudioFormat, 137254955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten writeMode == WRITE_BLOCKING); 137354955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten 137454955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten if ((mDataLoadMode == MODE_STATIC) 137554955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten && (mState == STATE_NO_STATIC_DATA) 137654955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten && (ret > 0)) { 137754955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten // benign race with respect to other APIs that read mState 137854955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten mState = STATE_INITIALIZED; 137954955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten } 138054955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten 138154955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten return ret; 138254955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten } 138354955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten 138454955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten 138554955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten /** 138654955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten * Writes the audio data to the audio sink for playback (streaming mode), 138754955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten * or copies audio data for later playback (static buffer mode). 13887ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi * In static buffer mode, copies the data to the buffer starting at its 0 offset, and the write 13897ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi * mode is ignored. 13907ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi * In streaming mode, the blocking behavior will depend on the write mode. 13917ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi * @param audioData the buffer that holds the data to play, starting at the position reported 13927ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi * by <code>audioData.position()</code>. 13935d21f679c58dbb13c8c931ffec6e06b6b8cd454fJean-Michel Trivi * <BR>Note that upon return, the buffer position (<code>audioData.position()</code>) will 13945d21f679c58dbb13c8c931ffec6e06b6b8cd454fJean-Michel Trivi * have been advanced to reflect the amount of data that was successfully written to 13955d21f679c58dbb13c8c931ffec6e06b6b8cd454fJean-Michel Trivi * the AudioTrack. 13965d21f679c58dbb13c8c931ffec6e06b6b8cd454fJean-Michel Trivi * @param sizeInBytes number of bytes to write. 13975d21f679c58dbb13c8c931ffec6e06b6b8cd454fJean-Michel Trivi * <BR>Note this may differ from <code>audioData.remaining()</code>, but cannot exceed it. 13987ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi * @param writeMode one of {@link #WRITE_BLOCKING}, {@link #WRITE_NON_BLOCKING}. It has no 13997ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi * effect in static mode. 14007ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi * <BR>With {@link #WRITE_BLOCKING}, the write will block until all data has been written 14017ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi * to the audio sink. 14027ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi * <BR>With {@link #WRITE_NON_BLOCKING}, the write will return immediately after 14037ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi * queuing as much audio data for playback as possible without blocking. 14047ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi * @return 0 or a positive number of bytes that were written, or 14057ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi * {@link #ERROR_BAD_VALUE}, {@link #ERROR_INVALID_OPERATION} 14067ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi */ 14075d21f679c58dbb13c8c931ffec6e06b6b8cd454fJean-Michel Trivi public int write(ByteBuffer audioData, int sizeInBytes, 14087ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi @WriteMode int writeMode) { 14097ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi 14107ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi if (mState == STATE_UNINITIALIZED) { 14117ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi Log.e(TAG, "AudioTrack.write() called in invalid state STATE_UNINITIALIZED"); 14127ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi return ERROR_INVALID_OPERATION; 14137ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi } 14147ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi 14157ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi if ((writeMode != WRITE_BLOCKING) && (writeMode != WRITE_NON_BLOCKING)) { 14167ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi Log.e(TAG, "AudioTrack.write() called with invalid blocking mode"); 14177ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi return ERROR_BAD_VALUE; 14187ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi } 14197ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi 14205d21f679c58dbb13c8c931ffec6e06b6b8cd454fJean-Michel Trivi if ( (audioData == null) || (sizeInBytes < 0) || (sizeInBytes > audioData.remaining())) { 14215d21f679c58dbb13c8c931ffec6e06b6b8cd454fJean-Michel Trivi Log.e(TAG, "AudioTrack.write() called with invalid size (" + sizeInBytes + ") value"); 14227ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi return ERROR_BAD_VALUE; 14237ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi } 14247ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi 14257ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi int ret = 0; 14267ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi if (audioData.isDirect()) { 14277ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi ret = native_write_native_bytes(audioData, 14285d21f679c58dbb13c8c931ffec6e06b6b8cd454fJean-Michel Trivi audioData.position(), sizeInBytes, mAudioFormat, 14297ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi writeMode == WRITE_BLOCKING); 14307ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi } else { 14317ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi ret = native_write_byte(NioUtils.unsafeArray(audioData), 14325d21f679c58dbb13c8c931ffec6e06b6b8cd454fJean-Michel Trivi NioUtils.unsafeArrayOffset(audioData) + audioData.position(), 14337ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi sizeInBytes, mAudioFormat, 14347ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi writeMode == WRITE_BLOCKING); 14357ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi } 14367ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi 14377ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi if ((mDataLoadMode == MODE_STATIC) 14387ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi && (mState == STATE_NO_STATIC_DATA) 14397ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi && (ret > 0)) { 14407ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi // benign race with respect to other APIs that read mState 14417ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi mState = STATE_INITIALIZED; 14427ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi } 14437ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi 14445d21f679c58dbb13c8c931ffec6e06b6b8cd454fJean-Michel Trivi if (ret > 0) { 14455d21f679c58dbb13c8c931ffec6e06b6b8cd454fJean-Michel Trivi audioData.position(audioData.position() + ret); 14465d21f679c58dbb13c8c931ffec6e06b6b8cd454fJean-Michel Trivi } 14475d21f679c58dbb13c8c931ffec6e06b6b8cd454fJean-Michel Trivi 14487ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi return ret; 14497ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi } 14507ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi 14517ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi /** 14529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Notifies the native resource to reuse the audio data already loaded in the native 1453e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * layer, that is to rewind to start of buffer. 1454e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * The track's creation mode must be {@link #MODE_STATIC}. 14559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return error code or success, see {@link #SUCCESS}, {@link #ERROR_BAD_VALUE}, 14569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #ERROR_INVALID_OPERATION} 14579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 14589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int reloadStaticData() { 1459a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten if (mDataLoadMode == MODE_STREAM || mState != STATE_INITIALIZED) { 14609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return ERROR_INVALID_OPERATION; 14619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return native_reload_static(); 14639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14657070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent //-------------------------------------------------------------------------- 14667070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent // Audio effects management 14677070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent //-------------------- 14687070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent 14697070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent /** 14701a5149e5d7f2dddc8b324f7695e69fd89af73c52Eric Laurent * Attaches an auxiliary effect to the audio track. A typical auxiliary 14711a5149e5d7f2dddc8b324f7695e69fd89af73c52Eric Laurent * effect is a reverberation effect which can be applied on any sound source 14721a5149e5d7f2dddc8b324f7695e69fd89af73c52Eric Laurent * that directs a certain amount of its energy to this effect. This amount 14731a5149e5d7f2dddc8b324f7695e69fd89af73c52Eric Laurent * is defined by setAuxEffectSendLevel(). 14747070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent * {@see #setAuxEffectSendLevel(float)}. 14751a5149e5d7f2dddc8b324f7695e69fd89af73c52Eric Laurent * <p>After creating an auxiliary effect (e.g. 14761a5149e5d7f2dddc8b324f7695e69fd89af73c52Eric Laurent * {@link android.media.audiofx.EnvironmentalReverb}), retrieve its ID with 14771a5149e5d7f2dddc8b324f7695e69fd89af73c52Eric Laurent * {@link android.media.audiofx.AudioEffect#getId()} and use it when calling 14787070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent * this method to attach the audio track to the effect. 14791a5149e5d7f2dddc8b324f7695e69fd89af73c52Eric Laurent * <p>To detach the effect from the audio track, call this method with a 14801a5149e5d7f2dddc8b324f7695e69fd89af73c52Eric Laurent * null effect id. 14817070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent * 14827070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent * @param effectId system wide unique id of the effect to attach 14837070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent * @return error code or success, see {@link #SUCCESS}, 14847070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent * {@link #ERROR_INVALID_OPERATION}, {@link #ERROR_BAD_VALUE} 14857070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent */ 14867070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent public int attachAuxEffect(int effectId) { 14873b4df62704a6184878afd9272830cf3db7bd2d66Glenn Kasten if (mState == STATE_UNINITIALIZED) { 14887070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent return ERROR_INVALID_OPERATION; 14897070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent } 14907070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent return native_attachAuxEffect(effectId); 14917070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent } 14927070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent 14937070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent /** 14947070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent * Sets the send level of the audio track to the attached auxiliary effect 149578cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * {@link #attachAuxEffect(int)}. Effect levels 149678cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * are clamped to the closed interval [0.0, max] where 149778cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * max is the value of {@link #getMaxVolume}. 149878cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * A value of 0.0 results in no effect, and a value of 1.0 is full send. 1499e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * <p>By default the send level is 0.0f, so even if an effect is attached to the player 15007070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent * this method must be called for the effect to be applied. 150178cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * <p>Note that the passed level value is a linear scalar. UI controls should be scaled 150278cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * logarithmically: the gain applied by audio framework ranges from -72dB to at least 0dB, 15037070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent * so an appropriate conversion from linear UI input x to level is: 15045c17a820f9e46e0756c11795b3e6f89105f2f539Glenn Kasten * x == 0 -> level = 0 15055c17a820f9e46e0756c11795b3e6f89105f2f539Glenn Kasten * 0 < x <= R -> level = 10^(72*(x-R)/20/R) 15067070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent * 150778cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * @param level linear send level 15087070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent * @return error code or success, see {@link #SUCCESS}, 15093009f0b911e39d3b26c69bd7667d6444eacb9d11Glenn Kasten * {@link #ERROR_INVALID_OPERATION}, {@link #ERROR} 15107070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent */ 15117070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent public int setAuxEffectSendLevel(float level) { 15121af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlock if (isRestricted()) { 15131af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlock return SUCCESS; 15141af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlock } 15153b4df62704a6184878afd9272830cf3db7bd2d66Glenn Kasten if (mState == STATE_UNINITIALIZED) { 15167070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent return ERROR_INVALID_OPERATION; 15177070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent } 151878cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten level = clampGainOrLevel(level); 15193009f0b911e39d3b26c69bd7667d6444eacb9d11Glenn Kasten int err = native_setAuxEffectSendLevel(level); 15203009f0b911e39d3b26c69bd7667d6444eacb9d11Glenn Kasten return err == 0 ? SUCCESS : ERROR; 15217070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent } 15229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 15239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //--------------------------------------------------------- 15249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Interface definitions 15259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //-------------------- 15269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 15274df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project * Interface definition for a callback to be invoked when the playback head position of 15284df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project * an AudioTrack has reached a notification marker or has increased by a certain period. 15299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 15304df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project public interface OnPlaybackPositionUpdateListener { 15319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 15329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Called on the listener to notify it that the previously set marker has been reached 15339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * by the playback head. 15349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 15359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project void onMarkerReached(AudioTrack track); 1536fb2ab9efc3805c81521afb9ff91a58ff5097a36eGlenn Kasten 15379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 15389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Called on the listener to periodically notify it that the playback head has reached 15399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * a multiple of the notification period. 15409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 15419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project void onPeriodicNotification(AudioTrack track); 15429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 15449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //--------------------------------------------------------- 15459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Inner classes 15469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //-------------------- 15479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 15484df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project * Helper class to handle the forwarding of native events to the appropriate listener 15494df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project * (potentially) handled in a different thread 15505c17a820f9e46e0756c11795b3e6f89105f2f539Glenn Kasten */ 15514df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project private class NativeEventHandlerDelegate { 15524df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project private final Handler mHandler; 1553fb2ab9efc3805c81521afb9ff91a58ff5097a36eGlenn Kasten 155495bd2329c6a36211f18be3e089eaa775ec62df62Glenn Kasten NativeEventHandlerDelegate(final AudioTrack track, 155595bd2329c6a36211f18be3e089eaa775ec62df62Glenn Kasten final OnPlaybackPositionUpdateListener listener, 155695bd2329c6a36211f18be3e089eaa775ec62df62Glenn Kasten Handler handler) { 15574df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project // find the looper for our new event handler 15584df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project Looper looper; 15594df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project if (handler != null) { 15604df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project looper = handler.getLooper(); 15614df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project } else { 1562105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project // no given handler, use the looper the AudioTrack was created in 1563105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project looper = mInitializationLooper; 15649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1565fb2ab9efc3805c81521afb9ff91a58ff5097a36eGlenn Kasten 15664df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project // construct the event handler with this looper 15674df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project if (looper != null) { 15684df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project // implement the event handler delegate 15694df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project mHandler = new Handler(looper) { 15704df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project @Override 15714df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project public void handleMessage(Message msg) { 157295bd2329c6a36211f18be3e089eaa775ec62df62Glenn Kasten if (track == null) { 15734df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project return; 15744df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project } 15754df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project switch(msg.what) { 15764df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project case NATIVE_EVENT_MARKER: 15774df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project if (listener != null) { 157895bd2329c6a36211f18be3e089eaa775ec62df62Glenn Kasten listener.onMarkerReached(track); 15794df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project } 15804df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project break; 15814df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project case NATIVE_EVENT_NEW_POS: 15824df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project if (listener != null) { 158395bd2329c6a36211f18be3e089eaa775ec62df62Glenn Kasten listener.onPeriodicNotification(track); 15844df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project } 15854df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project break; 15864df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project default: 15871f61d01508651b4475397414e1fe06af1ab8fadaGlenn Kasten loge("Unknown native event type: " + msg.what); 15884df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project break; 15894df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project } 15904df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project } 15914df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project }; 15924df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project } else { 15934df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project mHandler = null; 1594fb2ab9efc3805c81521afb9ff91a58ff5097a36eGlenn Kasten } 15954df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project } 1596fb2ab9efc3805c81521afb9ff91a58ff5097a36eGlenn Kasten 15974df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project Handler getHandler() { 15984df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project return mHandler; 15999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 16009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 16019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 16029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 16039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //--------------------------------------------------------- 16049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Java methods called from the native side 16059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //-------------------- 16069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @SuppressWarnings("unused") 16079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static void postEventFromNative(Object audiotrack_ref, 16089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int what, int arg1, int arg2, Object obj) { 16099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //logd("Event posted from the native side: event="+ what + " args="+ arg1+" "+arg2); 16109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project AudioTrack track = (AudioTrack)((WeakReference)audiotrack_ref).get(); 16119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (track == null) { 16129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return; 16139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 16149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 161595bd2329c6a36211f18be3e089eaa775ec62df62Glenn Kasten NativeEventHandlerDelegate delegate = track.mEventHandlerDelegate; 161695bd2329c6a36211f18be3e089eaa775ec62df62Glenn Kasten if (delegate != null) { 161795bd2329c6a36211f18be3e089eaa775ec62df62Glenn Kasten Handler handler = delegate.getHandler(); 161895bd2329c6a36211f18be3e089eaa775ec62df62Glenn Kasten if (handler != null) { 161995bd2329c6a36211f18be3e089eaa775ec62df62Glenn Kasten Message m = handler.obtainMessage(what, arg1, arg2, obj); 162095bd2329c6a36211f18be3e089eaa775ec62df62Glenn Kasten handler.sendMessage(m); 162195bd2329c6a36211f18be3e089eaa775ec62df62Glenn Kasten } 16229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 16239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 16249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 16259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 16269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 16279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //--------------------------------------------------------- 16289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Native methods called from the Java side 16299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //-------------------- 16309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1631a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi // post-condition: mStreamType is overwritten with a value 1632a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi // that reflects the audio attributes (e.g. an AudioAttributes object with a usage of 1633a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi // AudioAttributes.USAGE_MEDIA will map to AudioManager.STREAM_MUSIC 1634a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi private native final int native_setup(Object /*WeakReference<AudioTrack>*/ audiotrack_this, 1635a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi Object /*AudioAttributes*/ attributes, 1636a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi int sampleRate, int channelMask, int audioFormat, 1637619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent int buffSizeInBytes, int mode, int[] sessionId); 16389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 16399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private native final void native_finalize(); 16409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 16419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private native final void native_release(); 16429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 16439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private native final void native_start(); 16449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 16459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private native final void native_stop(); 16469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 16479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private native final void native_pause(); 16489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 16499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private native final void native_flush(); 16509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 16519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private native final int native_write_byte(byte[] audioData, 16527ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi int offsetInBytes, int sizeInBytes, int format, 16537ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi boolean isBlocking); 16549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 16559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private native final int native_write_short(short[] audioData, 16569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int offsetInShorts, int sizeInShorts, int format); 16579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 165854955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten private native final int native_write_float(float[] audioData, 165954955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten int offsetInFloats, int sizeInFloats, int format, 166054955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten boolean isBlocking); 166154955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten 16627ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi private native final int native_write_native_bytes(Object audioData, 16635d21f679c58dbb13c8c931ffec6e06b6b8cd454fJean-Michel Trivi int positionInBytes, int sizeInBytes, int format, boolean blocking); 16647ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi 16659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private native final int native_reload_static(); 16669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 16679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private native final int native_get_native_frame_count(); 16689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 16699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private native final void native_setVolume(float leftVolume, float rightVolume); 16709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 167188e209dcf8c2ebddda5c272f46d1bd5478bc639cEric Laurent private native final int native_set_playback_rate(int sampleRateInHz); 167288e209dcf8c2ebddda5c272f46d1bd5478bc639cEric Laurent private native final int native_get_playback_rate(); 16739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 16749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private native final int native_set_marker_pos(int marker); 16759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private native final int native_get_marker_pos(); 16769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 16779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private native final int native_set_pos_update_period(int updatePeriod); 16789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private native final int native_get_pos_update_period(); 16799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 16809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private native final int native_set_position(int position); 16819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private native final int native_get_position(); 16829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 168361dcdf3764b614c6f01e77cb4342d192e3101f8aOliver Woodman private native final int native_get_latency(); 168461dcdf3764b614c6f01e77cb4342d192e3101f8aOliver Woodman 1685948c2e6ff46d65942277f2e0e9ce0c038972b9d8Glenn Kasten // longArray must be a non-null array of length >= 2 1686948c2e6ff46d65942277f2e0e9ce0c038972b9d8Glenn Kasten // [0] is assigned the frame position 1687948c2e6ff46d65942277f2e0e9ce0c038972b9d8Glenn Kasten // [1] is assigned the time in CLOCK_MONOTONIC nanoseconds 1688948c2e6ff46d65942277f2e0e9ce0c038972b9d8Glenn Kasten private native final int native_get_timestamp(long[] longArray); 1689948c2e6ff46d65942277f2e0e9ce0c038972b9d8Glenn Kasten 16909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private native final int native_set_loop(int start, int end, int loopCount); 16919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 16929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project static private native final int native_get_output_sample_rate(int streamType); 16939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project static private native final int native_get_min_buff_size( 16949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int sampleRateInHz, int channelConfig, int audioFormat); 16959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 16967070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent private native final int native_attachAuxEffect(int effectId); 16973009f0b911e39d3b26c69bd7667d6444eacb9d11Glenn Kasten private native final int native_setAuxEffectSendLevel(float level); 16987070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent 16999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //--------------------------------------------------------- 17009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Utility methods 17019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //------------------ 17029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 17039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static void logd(String msg) { 17041f61d01508651b4475397414e1fe06af1ab8fadaGlenn Kasten Log.d(TAG, msg); 17059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 17069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 17079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static void loge(String msg) { 17081f61d01508651b4475397414e1fe06af1ab8fadaGlenn Kasten Log.e(TAG, msg); 17099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 17109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 17119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project} 1712