AudioTrack.java revision 00908b6c6964346af4d2512ba161a109912d97b8
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; 22cfe964a09ca05778e5dd84f2fd24119b89401696Rachadimport java.lang.Math; 237ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Triviimport java.nio.ByteBuffer; 24cfe964a09ca05778e5dd84f2fd24119b89401696Rachadimport java.nio.ByteOrder; 257ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Triviimport java.nio.NioUtils; 26d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLeanimport java.util.Collection; 2735ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi 287ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Triviimport android.annotation.IntDef; 2935ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Triviimport android.annotation.NonNull; 3035ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Triviimport android.annotation.SystemApi; 311af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlockimport android.app.ActivityThread; 321af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlockimport android.app.AppOpsManager; 331af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlockimport android.content.Context; 349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.Handler; 351af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlockimport android.os.IBinder; 369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.Looper; 379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.Message; 381af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlockimport android.os.Process; 391af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlockimport android.os.RemoteException; 401af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlockimport android.os.ServiceManager; 41d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLeanimport android.util.ArrayMap; 429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.util.Log; 439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 441af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlockimport com.android.internal.app.IAppOpsService; 451af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlock 469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/** 489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The AudioTrack class manages and plays a single audio resource for Java applications. 49e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * It allows streaming of PCM audio buffers to the audio sink for playback. This is 509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * achieved by "pushing" the data to the AudioTrack object using one of the 517d60bcd2d950e3571c00ce9f1c492c6bd58334c9Glenn Kasten * {@link #write(byte[], int, int)}, {@link #write(short[], int, int)}, 527d60bcd2d950e3571c00ce9f1c492c6bd58334c9Glenn Kasten * and {@link #write(float[], int, int, int)} methods. 5388bde0ce3799c47530ea42ae3665bfa12ae38d11Narayan Kamath * 54ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * <p>An AudioTrack instance can operate under two modes: static or streaming.<br> 55ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * In Streaming mode, the application writes a continuous stream of data to the AudioTrack, using 5688bde0ce3799c47530ea42ae3665bfa12ae38d11Narayan Kamath * one of the {@code write()} methods. These are blocking and return when the data has been 5788bde0ce3799c47530ea42ae3665bfa12ae38d11Narayan Kamath * transferred from the Java layer to the native layer and queued for playback. The streaming 5888bde0ce3799c47530ea42ae3665bfa12ae38d11Narayan Kamath * mode is most useful when playing blocks of audio data that for instance are: 5988bde0ce3799c47530ea42ae3665bfa12ae38d11Narayan Kamath * 609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <ul> 619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>too big to fit in memory because of the duration of the sound to play,</li> 629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>too big to fit in memory because of the characteristics of the audio data 639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * (high sampling rate, bits per sample ...)</li> 64ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * <li>received or generated while previously queued audio is playing.</li> 659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * </ul> 6688bde0ce3799c47530ea42ae3665bfa12ae38d11Narayan Kamath * 675c17a820f9e46e0756c11795b3e6f89105f2f539Glenn Kasten * The static mode should be chosen when dealing with short sounds that fit in memory and 6888bde0ce3799c47530ea42ae3665bfa12ae38d11Narayan Kamath * that need to be played with the smallest latency possible. The static mode will 6988bde0ce3799c47530ea42ae3665bfa12ae38d11Narayan Kamath * therefore be preferred for UI and game sounds that are played often, and with the 7088bde0ce3799c47530ea42ae3665bfa12ae38d11Narayan Kamath * smallest overhead possible. 7188bde0ce3799c47530ea42ae3665bfa12ae38d11Narayan Kamath * 729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>Upon creation, an AudioTrack object initializes its associated audio buffer. 739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The size of this buffer, specified during the construction, determines how long an AudioTrack 749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * can play before running out of data.<br> 759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * For an AudioTrack using the static mode, this size is the maximum size of the sound that can 769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * be played from it.<br> 77e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * For the streaming mode, data will be written to the audio sink in chunks of 785c17a820f9e46e0756c11795b3e6f89105f2f539Glenn Kasten * sizes less than or equal to the total buffer size. 7955a3218f242a611afb3569d88970c0c5dbf8ce54Glenn Kasten * 8055a3218f242a611afb3569d88970c0c5dbf8ce54Glenn Kasten * AudioTrack is not final and thus permits subclasses, but such use is not recommended. 819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpublic class AudioTrack 839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project{ 849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //--------------------------------------------------------- 859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Constants 869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //-------------------- 8778cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten /** Minimum value for a linear gain or auxiliary effect level. 8878cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * This value must be exactly equal to 0.0f; do not change it. 8978cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten */ 9078cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten private static final float GAIN_MIN = 0.0f; 9178cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten /** Maximum value for a linear gain or auxiliary effect level. 9278cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * This value must be greater than or equal to 1.0f. 9378cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten */ 9478cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten private static final float GAIN_MAX = 1.0f; 959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 96ad67c9546494a7c4d9336b57889a7c19a7dbb945Glenn Kasten /** Minimum value for sample rate */ 97ad67c9546494a7c4d9336b57889a7c19a7dbb945Glenn Kasten private static final int SAMPLE_RATE_HZ_MIN = 4000; 98ad67c9546494a7c4d9336b57889a7c19a7dbb945Glenn Kasten /** Maximum value for sample rate */ 998fd0928cdb6249882acb18274ff7ddaab6fa46d0Andy Hung private static final int SAMPLE_RATE_HZ_MAX = 192000; 100ad67c9546494a7c4d9336b57889a7c19a7dbb945Glenn Kasten 101340a6d09bdba7d4d99cef52a83a90fb96842c58aGlenn Kasten // FCC_8 102ad720aeea741d9058a7b4d326c9ab1b3ebcd7c62Andy Hung /** Maximum value for AudioTrack channel count */ 103ad720aeea741d9058a7b4d326c9ab1b3ebcd7c62Andy Hung private static final int CHANNEL_COUNT_MAX = 8; 104ad720aeea741d9058a7b4d326c9ab1b3ebcd7c62Andy Hung 105ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi /** indicates AudioTrack state is stopped */ 1069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int PLAYSTATE_STOPPED = 1; // matches SL_PLAYSTATE_STOPPED 107ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi /** indicates AudioTrack state is paused */ 1089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int PLAYSTATE_PAUSED = 2; // matches SL_PLAYSTATE_PAUSED 109ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi /** indicates AudioTrack state is playing */ 1109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int PLAYSTATE_PLAYING = 3; // matches SL_PLAYSTATE_PLAYING 1119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1125c17a820f9e46e0756c11795b3e6f89105f2f539Glenn Kasten // keep these values in sync with android_media_AudioTrack.cpp 1139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Creation mode where audio data is transferred from Java to the native layer 1159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * only once before the audio starts playing. 1169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int MODE_STATIC = 0; 1189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Creation mode where audio data is streamed from Java to the native layer 1209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * as the audio is playing. 1219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int MODE_STREAM = 1; 1239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12435ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi /** @hide */ 12535ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi @IntDef({ 12635ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi MODE_STATIC, 12735ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi MODE_STREAM 12835ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi }) 12935ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi @Retention(RetentionPolicy.SOURCE) 13035ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi public @interface TransferMode {} 13135ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi 1329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 133ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * State of an AudioTrack that was not successfully initialized upon creation. 1349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int STATE_UNINITIALIZED = 0; 1369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * State of an AudioTrack that is ready to be used. 1389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int STATE_INITIALIZED = 1; 1409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * State of a successfully initialized AudioTrack that uses static data, 1429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * but that hasn't received that data yet. 1439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int STATE_NO_STATIC_DATA = 2; 1459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Denotes a successful operation. 1489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 149bc11a696f6856624de532a6830d5db9dbbe2384cEric Laurent public static final int SUCCESS = AudioSystem.SUCCESS; 1509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Denotes a generic operation failure. 1529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 153bc11a696f6856624de532a6830d5db9dbbe2384cEric Laurent public static final int ERROR = AudioSystem.ERROR; 1549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Denotes a failure due to the use of an invalid value. 1569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 157bc11a696f6856624de532a6830d5db9dbbe2384cEric Laurent public static final int ERROR_BAD_VALUE = AudioSystem.BAD_VALUE; 1589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Denotes a failure due to the improper use of a method. 1609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 161bc11a696f6856624de532a6830d5db9dbbe2384cEric Laurent public static final int ERROR_INVALID_OPERATION = AudioSystem.INVALID_OPERATION; 1629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 163bc11a696f6856624de532a6830d5db9dbbe2384cEric Laurent // Error codes: 164bc11a696f6856624de532a6830d5db9dbbe2384cEric Laurent // to keep in sync with frameworks/base/core/jni/android_media_AudioTrack.cpp 1659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final int ERROR_NATIVESETUP_AUDIOSYSTEM = -16; 166a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent private static final int ERROR_NATIVESETUP_INVALIDCHANNELMASK = -17; 1679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final int ERROR_NATIVESETUP_INVALIDFORMAT = -18; 1689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final int ERROR_NATIVESETUP_INVALIDSTREAMTYPE = -19; 1699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final int ERROR_NATIVESETUP_NATIVEINITFAILED = -20; 1709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Events: 172e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten // to keep in sync with frameworks/av/include/media/AudioTrack.h 1739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 174ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * Event id denotes when playback head has reached a previously set marker. 1759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final int NATIVE_EVENT_MARKER = 3; 1779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 178ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * Event id denotes when previously set update period has elapsed during playback. 1799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final int NATIVE_EVENT_NEW_POS = 4; 1819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1821f61d01508651b4475397414e1fe06af1ab8fadaGlenn Kasten private final static String TAG = "android.media.AudioTrack"; 1839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1857ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi /** @hide */ 1867ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi @IntDef({ 1877ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi WRITE_BLOCKING, 1887ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi WRITE_NON_BLOCKING 1897ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi }) 1907ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi @Retention(RetentionPolicy.SOURCE) 1917ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi public @interface WriteMode {} 1927ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi 1937ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi /** 1947ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi * The write mode indicating the write operation will block until all data has been written, 195659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * to be used as the actual value of the writeMode parameter in 196659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * {@link #write(byte[], int, int, int)}, {@link #write(short[], int, int, int)}, 197659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * {@link #write(float[], int, int, int)}, {@link #write(ByteBuffer, int, int)}, and 198659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * {@link #write(ByteBuffer, int, int, long)}. 1997ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi */ 2007ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi public final static int WRITE_BLOCKING = 0; 201659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten 2027ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi /** 2037ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi * The write mode indicating the write operation will return immediately after 204659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * queuing as much audio data for playback as possible without blocking, 205659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * to be used as the actual value of the writeMode parameter in 206659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * {@link #write(ByteBuffer, int, int)}, {@link #write(short[], int, int, int)}, 207659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * {@link #write(float[], int, int, int)}, {@link #write(ByteBuffer, int, int)}, and 208659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * {@link #write(ByteBuffer, int, int, long)}. 2097ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi */ 2107ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi public final static int WRITE_NON_BLOCKING = 1; 2117ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi 2129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //-------------------------------------------------------------------------- 2139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Member variables 2149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //-------------------- 2159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 216ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * Indicates the state of the AudioTrack instance. 217340a6d09bdba7d4d99cef52a83a90fb96842c58aGlenn Kasten * One of STATE_UNINITIALIZED, STATE_INITIALIZED, or STATE_NO_STATIC_DATA. 2189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private int mState = STATE_UNINITIALIZED; 2209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 221ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * Indicates the play state of the AudioTrack instance. 222340a6d09bdba7d4d99cef52a83a90fb96842c58aGlenn Kasten * One of PLAYSTATE_STOPPED, PLAYSTATE_PAUSED, or PLAYSTATE_PLAYING. 2239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private int mPlayState = PLAYSTATE_STOPPED; 2259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 226340a6d09bdba7d4d99cef52a83a90fb96842c58aGlenn Kasten * Lock to ensure mPlayState updates reflect the actual state of the object. 2279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private final Object mPlayStateLock = new Object(); 2299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 230e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * Sizes of the native audio buffer. 2314bd513e6ed168811c97dbc83cd5a7c7cc43caffeAndy Hung * These values are set during construction and can be stale. 232e90a0a88f4eabdc27c3ef033f38c91ea23362a1eAndy Hung * To obtain the current native audio buffer frame count use {@link #getBufferSizeInFrames()}. 2339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private int mNativeBufferSizeInBytes = 0; 235e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten private int mNativeBufferSizeInFrames = 0; 2369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 23786fad47e68e344b19fabeab1156c5e6742d8dfadGlenn Kasten * Handler for events coming from the native code. 2389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 239d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean private NativePositionEventHandlerDelegate mEventHandlerDelegate; 2409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 241ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * Looper associated with the thread that creates the AudioTrack instance. 242105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project */ 243b09707a041957f055cee3d290c85763cfef8d986Glenn Kasten private final Looper mInitializationLooper; 244105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project /** 2458d7fa137466c833ed422053204fb4c506b7bb209Glenn Kasten * The audio data source sampling rate in Hz. 2469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 247340a6d09bdba7d4d99cef52a83a90fb96842c58aGlenn Kasten private int mSampleRate; // initialized by all constructors via audioParamCheck() 2489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 249340a6d09bdba7d4d99cef52a83a90fb96842c58aGlenn Kasten * The number of audio output channels (1 is mono, 2 is stereo, etc.). 2509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private int mChannelCount = 1; 2529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 253a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung * The audio channel mask used for calling native AudioTrack 2543026a023b8979b7ddcb3fe97bbc45531c89fda92Eric Laurent */ 2559ea5e5564812bb88e62d0c4fae8f1d40d8a6e7e0Glenn Kasten private int mChannelMask = AudioFormat.CHANNEL_OUT_MONO; 2563026a023b8979b7ddcb3fe97bbc45531c89fda92Eric Laurent 2573026a023b8979b7ddcb3fe97bbc45531c89fda92Eric Laurent /** 2589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The type of the audio stream to play. See 2599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link AudioManager#STREAM_VOICE_CALL}, {@link AudioManager#STREAM_SYSTEM}, 2605c17a820f9e46e0756c11795b3e6f89105f2f539Glenn Kasten * {@link AudioManager#STREAM_RING}, {@link AudioManager#STREAM_MUSIC}, 261b282e08ab641d4fc74d0324b7a0ce30926638dd5Glenn Kasten * {@link AudioManager#STREAM_ALARM}, {@link AudioManager#STREAM_NOTIFICATION}, and 262b282e08ab641d4fc74d0324b7a0ce30926638dd5Glenn Kasten * {@link AudioManager#STREAM_DTMF}. 2639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private int mStreamType = AudioManager.STREAM_MUSIC; 265a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi 266a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi private final AudioAttributes mAttributes; 2679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 268340a6d09bdba7d4d99cef52a83a90fb96842c58aGlenn Kasten * The way audio is consumed by the audio sink, one of MODE_STATIC or MODE_STREAM. 2699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private int mDataLoadMode = MODE_STREAM; 2719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 272a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung * The current channel position mask, as specified on AudioTrack creation. 273a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung * Can be set simultaneously with channel index mask {@link #mChannelIndexMask}. 274a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung * May be set to {@link AudioFormat#CHANNEL_INVALID} if a channel index mask is specified. 2759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 276a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent private int mChannelConfiguration = AudioFormat.CHANNEL_OUT_MONO; 2779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 278340a6d09bdba7d4d99cef52a83a90fb96842c58aGlenn Kasten * The channel index mask if specified, otherwise 0. 279a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung */ 280a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung private int mChannelIndexMask = 0; 281a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung /** 2829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The encoding of the audio samples. 2839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see AudioFormat#ENCODING_PCM_8BIT 2849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see AudioFormat#ENCODING_PCM_16BIT 2857d60bcd2d950e3571c00ce9f1c492c6bd58334c9Glenn Kasten * @see AudioFormat#ENCODING_PCM_FLOAT 2869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 287340a6d09bdba7d4d99cef52a83a90fb96842c58aGlenn Kasten private int mAudioFormat; // initialized by all constructors via audioParamCheck() 288619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent /** 289619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * Audio session ID 290619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent */ 29160bd67f7b1b85ed0ee19f77b056b90350a3d5343Glenn Kasten private int mSessionId = AudioSystem.AUDIO_SESSION_ALLOCATE; 2921af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlock /** 2931af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlock * Reference to the app-ops service. 2941af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlock */ 2951af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlock private final IAppOpsService mAppOps; 296cfe964a09ca05778e5dd84f2fd24119b89401696Rachad /** 297cfe964a09ca05778e5dd84f2fd24119b89401696Rachad * HW_AV_SYNC track AV Sync Header 298cfe964a09ca05778e5dd84f2fd24119b89401696Rachad */ 299cfe964a09ca05778e5dd84f2fd24119b89401696Rachad private ByteBuffer mAvSyncHeader = null; 300cfe964a09ca05778e5dd84f2fd24119b89401696Rachad /** 301cfe964a09ca05778e5dd84f2fd24119b89401696Rachad * HW_AV_SYNC track audio data bytes remaining to write after current AV sync header 302cfe964a09ca05778e5dd84f2fd24119b89401696Rachad */ 303cfe964a09ca05778e5dd84f2fd24119b89401696Rachad private int mAvSyncBytesRemaining = 0; 3049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //-------------------------------- 3069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Used exclusively by native code 3079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //-------------------- 3089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 309ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * Accessed by native methods: provides access to C++ AudioTrack object. 3109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @SuppressWarnings("unused") 312075e9a19ce645752f8282bc19c91b25978a7dc52Ashok Bhat private long mNativeTrackInJavaObj; 3139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Accessed by native methods: provides access to the JNI data (i.e. resources used by 3159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the native AudioTrack object, but not stored in it). 3169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @SuppressWarnings("unused") 318075e9a19ce645752f8282bc19c91b25978a7dc52Ashok Bhat private long mJniData; 3199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //-------------------------------------------------------------------------- 3229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Constructor, Finalize 3239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //-------------------- 3249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Class constructor. 3269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param streamType the type of the audio stream. See 3279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link AudioManager#STREAM_VOICE_CALL}, {@link AudioManager#STREAM_SYSTEM}, 3285c17a820f9e46e0756c11795b3e6f89105f2f539Glenn Kasten * {@link AudioManager#STREAM_RING}, {@link AudioManager#STREAM_MUSIC}, 3295c17a820f9e46e0756c11795b3e6f89105f2f539Glenn Kasten * {@link AudioManager#STREAM_ALARM}, and {@link AudioManager#STREAM_NOTIFICATION}. 3308d7fa137466c833ed422053204fb4c506b7bb209Glenn Kasten * @param sampleRateInHz the initial source sample rate expressed in Hz. 3319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param channelConfig describes the configuration of the audio channels. 332a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * See {@link AudioFormat#CHANNEL_OUT_MONO} and 333a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * {@link AudioFormat#CHANNEL_OUT_STEREO} 3349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param audioFormat the format in which the audio data is represented. 3357d60bcd2d950e3571c00ce9f1c492c6bd58334c9Glenn Kasten * See {@link AudioFormat#ENCODING_PCM_16BIT}, 3367d60bcd2d950e3571c00ce9f1c492c6bd58334c9Glenn Kasten * {@link AudioFormat#ENCODING_PCM_8BIT}, 3377d60bcd2d950e3571c00ce9f1c492c6bd58334c9Glenn Kasten * and {@link AudioFormat#ENCODING_PCM_FLOAT}. 338e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * @param bufferSizeInBytes the total size (in bytes) of the internal buffer where audio data is 3394bd513e6ed168811c97dbc83cd5a7c7cc43caffeAndy Hung * read from for playback. This should be a multiple of the frame size in bytes. 3404bd513e6ed168811c97dbc83cd5a7c7cc43caffeAndy Hung * <p> If the track's creation mode is {@link #MODE_STATIC}, 341e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * this is the maximum length sample, or audio clip, that can be played by this instance. 3424bd513e6ed168811c97dbc83cd5a7c7cc43caffeAndy Hung * <p> If the track's creation mode is {@link #MODE_STREAM}, 3434bd513e6ed168811c97dbc83cd5a7c7cc43caffeAndy Hung * this should be the desired buffer size 3444bd513e6ed168811c97dbc83cd5a7c7cc43caffeAndy Hung * for the <code>AudioTrack</code> to satisfy the application's 3454bd513e6ed168811c97dbc83cd5a7c7cc43caffeAndy Hung * natural latency requirements. 3464bd513e6ed168811c97dbc83cd5a7c7cc43caffeAndy Hung * If <code>bufferSizeInBytes</code> is less than the 3474bd513e6ed168811c97dbc83cd5a7c7cc43caffeAndy Hung * minimum buffer size for the output sink, it is automatically increased to the minimum 3484bd513e6ed168811c97dbc83cd5a7c7cc43caffeAndy Hung * buffer size. 349e90a0a88f4eabdc27c3ef033f38c91ea23362a1eAndy Hung * The method {@link #getBufferSizeInFrames()} returns the 3504bd513e6ed168811c97dbc83cd5a7c7cc43caffeAndy Hung * actual size in frames of the native buffer created, which 3514bd513e6ed168811c97dbc83cd5a7c7cc43caffeAndy Hung * determines the frequency to write 3524bd513e6ed168811c97dbc83cd5a7c7cc43caffeAndy Hung * to the streaming <code>AudioTrack</code> to avoid underrun. 3539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param mode streaming or static buffer. See {@link #MODE_STATIC} and {@link #MODE_STREAM} 3549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws java.lang.IllegalArgumentException 3559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public AudioTrack(int streamType, int sampleRateInHz, int channelConfig, int audioFormat, 3579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int bufferSizeInBytes, int mode) 3589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throws IllegalArgumentException { 359619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent this(streamType, sampleRateInHz, channelConfig, audioFormat, 36060bd67f7b1b85ed0ee19f77b056b90350a3d5343Glenn Kasten bufferSizeInBytes, mode, AudioSystem.AUDIO_SESSION_ALLOCATE); 361619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent } 362619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent 363619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent /** 364619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * Class constructor with audio session. Use this constructor when the AudioTrack must be 365619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * attached to a particular audio session. The primary use of the audio session ID is to 366619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * associate audio effects to a particular instance of AudioTrack: if an audio session ID 367619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * is provided when creating an AudioEffect, this effect will be applied only to audio tracks 368619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * and media players in the same session and not to the output mix. 369619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * When an AudioTrack is created without specifying a session, it will create its own session 3708d7fa137466c833ed422053204fb4c506b7bb209Glenn Kasten * which can be retrieved by calling the {@link #getAudioSessionId()} method. 3715c17a820f9e46e0756c11795b3e6f89105f2f539Glenn Kasten * If a non-zero session ID is provided, this AudioTrack will share effects attached to this 3725c17a820f9e46e0756c11795b3e6f89105f2f539Glenn Kasten * session 3735c17a820f9e46e0756c11795b3e6f89105f2f539Glenn Kasten * with all other media players or audio tracks in the same session, otherwise a new session 3745c17a820f9e46e0756c11795b3e6f89105f2f539Glenn Kasten * will be created for this track if none is supplied. 375619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * @param streamType the type of the audio stream. See 376619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * {@link AudioManager#STREAM_VOICE_CALL}, {@link AudioManager#STREAM_SYSTEM}, 3775c17a820f9e46e0756c11795b3e6f89105f2f539Glenn Kasten * {@link AudioManager#STREAM_RING}, {@link AudioManager#STREAM_MUSIC}, 3785c17a820f9e46e0756c11795b3e6f89105f2f539Glenn Kasten * {@link AudioManager#STREAM_ALARM}, and {@link AudioManager#STREAM_NOTIFICATION}. 3798d7fa137466c833ed422053204fb4c506b7bb209Glenn Kasten * @param sampleRateInHz the initial source sample rate expressed in Hz. 380619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * @param channelConfig describes the configuration of the audio channels. 381619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * See {@link AudioFormat#CHANNEL_OUT_MONO} and 382619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * {@link AudioFormat#CHANNEL_OUT_STEREO} 383619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * @param audioFormat the format in which the audio data is represented. 384619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * See {@link AudioFormat#ENCODING_PCM_16BIT} and 3857d60bcd2d950e3571c00ce9f1c492c6bd58334c9Glenn Kasten * {@link AudioFormat#ENCODING_PCM_8BIT}, 3867d60bcd2d950e3571c00ce9f1c492c6bd58334c9Glenn Kasten * and {@link AudioFormat#ENCODING_PCM_FLOAT}. 387619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * @param bufferSizeInBytes the total size (in bytes) of the buffer where audio data is read 388619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * from for playback. If using the AudioTrack in streaming mode, you can write data into 389619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * this buffer in smaller chunks than this size. If using the AudioTrack in static mode, 390619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * this is the maximum size of the sound that will be played for this instance. 391619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * See {@link #getMinBufferSize(int, int, int)} to determine the minimum required buffer size 392619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * for the successful creation of an AudioTrack instance in streaming mode. Using values 393619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * smaller than getMinBufferSize() will result in an initialization failure. 394619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * @param mode streaming or static buffer. See {@link #MODE_STATIC} and {@link #MODE_STREAM} 395619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * @param sessionId Id of audio session the AudioTrack must be attached to 396619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * @throws java.lang.IllegalArgumentException 397619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent */ 398619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent public AudioTrack(int streamType, int sampleRateInHz, int channelConfig, int audioFormat, 399619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent int bufferSizeInBytes, int mode, int sessionId) 400619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent throws IllegalArgumentException { 401a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten // mState already == STATE_UNINITIALIZED 402a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi this((new AudioAttributes.Builder()) 403a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi .setLegacyStreamType(streamType) 404a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi .build(), 405a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi (new AudioFormat.Builder()) 406a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi .setChannelMask(channelConfig) 407a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi .setEncoding(audioFormat) 408a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi .setSampleRate(sampleRateInHz) 409a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi .build(), 410a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi bufferSizeInBytes, 411a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi mode, sessionId); 412a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi } 413a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi 414a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi /** 4157f6ee760b0aee76bdb9fe61ac7ed1465c0da3489Jean-Michel Trivi * Class constructor with {@link AudioAttributes} and {@link AudioFormat}. 4167f6ee760b0aee76bdb9fe61ac7ed1465c0da3489Jean-Michel Trivi * @param attributes a non-null {@link AudioAttributes} instance. 4177f6ee760b0aee76bdb9fe61ac7ed1465c0da3489Jean-Michel Trivi * @param format a non-null {@link AudioFormat} instance describing the format of the data 4187f6ee760b0aee76bdb9fe61ac7ed1465c0da3489Jean-Michel Trivi * that will be played through this AudioTrack. See {@link AudioFormat.Builder} for 4197f6ee760b0aee76bdb9fe61ac7ed1465c0da3489Jean-Michel Trivi * configuring the audio format parameters such as encoding, channel mask and sample rate. 4207f6ee760b0aee76bdb9fe61ac7ed1465c0da3489Jean-Michel Trivi * @param bufferSizeInBytes the total size (in bytes) of the buffer where audio data is read 4217f6ee760b0aee76bdb9fe61ac7ed1465c0da3489Jean-Michel Trivi * from for playback. If using the AudioTrack in streaming mode, you can write data into 4227f6ee760b0aee76bdb9fe61ac7ed1465c0da3489Jean-Michel Trivi * this buffer in smaller chunks than this size. If using the AudioTrack in static mode, 4237f6ee760b0aee76bdb9fe61ac7ed1465c0da3489Jean-Michel Trivi * this is the maximum size of the sound that will be played for this instance. 4247f6ee760b0aee76bdb9fe61ac7ed1465c0da3489Jean-Michel Trivi * See {@link #getMinBufferSize(int, int, int)} to determine the minimum required buffer size 4257f6ee760b0aee76bdb9fe61ac7ed1465c0da3489Jean-Michel Trivi * for the successful creation of an AudioTrack instance in streaming mode. Using values 4267f6ee760b0aee76bdb9fe61ac7ed1465c0da3489Jean-Michel Trivi * smaller than getMinBufferSize() will result in an initialization failure. 4277f6ee760b0aee76bdb9fe61ac7ed1465c0da3489Jean-Michel Trivi * @param mode streaming or static buffer. See {@link #MODE_STATIC} and {@link #MODE_STREAM}. 428289cc8e887f786f557faab226a1e01abb9a632a6Jean-Michel Trivi * @param sessionId ID of audio session the AudioTrack must be attached to, or 429289cc8e887f786f557faab226a1e01abb9a632a6Jean-Michel Trivi * {@link AudioManager#AUDIO_SESSION_ID_GENERATE} if the session isn't known at construction 430289cc8e887f786f557faab226a1e01abb9a632a6Jean-Michel Trivi * time. See also {@link AudioManager#generateAudioSessionId()} to obtain a session ID before 431289cc8e887f786f557faab226a1e01abb9a632a6Jean-Michel Trivi * construction. 4327f6ee760b0aee76bdb9fe61ac7ed1465c0da3489Jean-Michel Trivi * @throws IllegalArgumentException 433a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi */ 434a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi public AudioTrack(AudioAttributes attributes, AudioFormat format, int bufferSizeInBytes, 435a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi int mode, int sessionId) 436a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi throws IllegalArgumentException { 437a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi // mState already == STATE_UNINITIALIZED 4385c17a820f9e46e0756c11795b3e6f89105f2f539Glenn Kasten 4397f6ee760b0aee76bdb9fe61ac7ed1465c0da3489Jean-Michel Trivi if (attributes == null) { 4407f6ee760b0aee76bdb9fe61ac7ed1465c0da3489Jean-Michel Trivi throw new IllegalArgumentException("Illegal null AudioAttributes"); 4417f6ee760b0aee76bdb9fe61ac7ed1465c0da3489Jean-Michel Trivi } 4427f6ee760b0aee76bdb9fe61ac7ed1465c0da3489Jean-Michel Trivi if (format == null) { 4437f6ee760b0aee76bdb9fe61ac7ed1465c0da3489Jean-Michel Trivi throw new IllegalArgumentException("Illegal null AudioFormat"); 4447f6ee760b0aee76bdb9fe61ac7ed1465c0da3489Jean-Michel Trivi } 4457f6ee760b0aee76bdb9fe61ac7ed1465c0da3489Jean-Michel Trivi 4465c17a820f9e46e0756c11795b3e6f89105f2f539Glenn Kasten // remember which looper is associated with the AudioTrack instantiation 447b09707a041957f055cee3d290c85763cfef8d986Glenn Kasten Looper looper; 448b09707a041957f055cee3d290c85763cfef8d986Glenn Kasten if ((looper = Looper.myLooper()) == null) { 449b09707a041957f055cee3d290c85763cfef8d986Glenn Kasten looper = Looper.getMainLooper(); 450105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project } 4519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 452a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi int rate = 0; 453a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi if ((format.getPropertySetMask() & AudioFormat.AUDIO_FORMAT_HAS_PROPERTY_SAMPLE_RATE) != 0) 454a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi { 455a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi rate = format.getSampleRate(); 456a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi } else { 457a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi rate = AudioSystem.getPrimaryOutputSamplingRate(); 458a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi if (rate <= 0) { 459a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi rate = 44100; 460a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi } 461a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi } 462a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung int channelIndexMask = 0; 463a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung if ((format.getPropertySetMask() 464a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung & AudioFormat.AUDIO_FORMAT_HAS_PROPERTY_CHANNEL_INDEX_MASK) != 0) { 465a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung channelIndexMask = format.getChannelIndexMask(); 466a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung } 467a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung int channelMask = 0; 468a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung if ((format.getPropertySetMask() 469a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung & AudioFormat.AUDIO_FORMAT_HAS_PROPERTY_CHANNEL_MASK) != 0) { 470a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi channelMask = format.getChannelMask(); 471a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung } else if (channelIndexMask == 0) { // if no masks at all, use stereo 472a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung channelMask = AudioFormat.CHANNEL_OUT_FRONT_LEFT 473a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung | AudioFormat.CHANNEL_OUT_FRONT_RIGHT; 474a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi } 475a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi int encoding = AudioFormat.ENCODING_DEFAULT; 476a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi if ((format.getPropertySetMask() & AudioFormat.AUDIO_FORMAT_HAS_PROPERTY_ENCODING) != 0) { 477a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi encoding = format.getEncoding(); 478a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi } 479a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung audioParamCheck(rate, channelMask, channelIndexMask, encoding, mode); 480a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi mStreamType = AudioSystem.STREAM_DEFAULT; 4819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project audioBuffSizeCheck(bufferSizeInBytes); 4839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 484a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi mInitializationLooper = looper; 4851af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlock IBinder b = ServiceManager.getService(Context.APP_OPS_SERVICE); 4861af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlock mAppOps = IAppOpsService.Stub.asInterface(b); 4871af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlock 488340a6d09bdba7d4d99cef52a83a90fb96842c58aGlenn Kasten mAttributes = new AudioAttributes.Builder(attributes).build(); 489a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi 490619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent if (sessionId < 0) { 491f4e58051e22ad4e21c7cd436c37cc5665c194d1cGlenn Kasten throw new IllegalArgumentException("Invalid audio session ID: "+sessionId); 492619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent } 493619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent 494619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent int[] session = new int[1]; 495619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent session[0] = sessionId; 4969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // native initialization 497a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi int initResult = native_setup(new WeakReference<AudioTrack>(this), mAttributes, 4989ea5e5564812bb88e62d0c4fae8f1d40d8a6e7e0Glenn Kasten mSampleRate, mChannelMask, mChannelIndexMask, mAudioFormat, 499619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent mNativeBufferSizeInBytes, mDataLoadMode, session); 5009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (initResult != SUCCESS) { 5019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project loge("Error code "+initResult+" when initializing AudioTrack."); 5029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return; // with mState == STATE_UNINITIALIZED 5039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 505619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent mSessionId = session[0]; 506619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent 5079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mDataLoadMode == MODE_STATIC) { 5089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mState = STATE_NO_STATIC_DATA; 5099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 5109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mState = STATE_INITIALIZED; 5119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 51435ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi /** 51535ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * Builder class for {@link AudioTrack} objects. 51635ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * Use this class to configure and create an <code>AudioTrack</code> instance. By setting audio 51735ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * attributes and audio format parameters, you indicate which of those vary from the default 51835ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * behavior on the device. 51935ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * <p> Here is an example where <code>Builder</code> is used to specify all {@link AudioFormat} 52035ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * parameters, to be used by a new <code>AudioTrack</code> instance: 52135ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * 52235ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * <pre class="prettyprint"> 52335ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * AudioTrack player = new AudioTrack.Builder() 52435ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * .setAudioAttributes(new AudioAttributes.Builder() 52535ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * .setUsage(AudioAttributes.USAGE_ALARM) 52635ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * .setContentType(CONTENT_TYPE_MUSIC) 52735ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * .build()) 52835ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * .setAudioFormat(new AudioFormat.Builder() 52935ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * .setEncoding(AudioFormat.ENCODING_PCM_16BIT) 53035ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * .setSampleRate(441000) 53135ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * .setChannelMask(AudioFormat.CHANNEL_OUT_STEREO) 53235ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * .build()) 53335ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * .setBufferSize(minBuffSize) 53435ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * .build(); 53535ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * </pre> 53635ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * <p> 53735ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * If the audio attributes are not set with {@link #setAudioAttributes(AudioAttributes)}, 53835ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * attributes comprising {@link AudioAttributes#USAGE_MEDIA} will be used. 53935ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * <br>If the audio format is not specified or is incomplete, its sample rate will be the 54035ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * default output sample rate of the device (see 54135ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * {@link AudioManager#PROPERTY_OUTPUT_SAMPLE_RATE}), its channel configuration will be 54235ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * {@link AudioFormat#CHANNEL_OUT_STEREO} and the encoding will be 54335ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * {@link AudioFormat#ENCODING_PCM_16BIT}. 5444bd513e6ed168811c97dbc83cd5a7c7cc43caffeAndy Hung * <br>If the buffer size is not specified with {@link #setBufferSizeInBytes(int)}, 5454bd513e6ed168811c97dbc83cd5a7c7cc43caffeAndy Hung * and the mode is {@link AudioTrack#MODE_STREAM}, the minimum buffer size is used. 54635ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * <br>If the transfer mode is not specified with {@link #setTransferMode(int)}, 5474bd513e6ed168811c97dbc83cd5a7c7cc43caffeAndy Hung * <code>MODE_STREAM</code> will be used. 54835ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * <br>If the session ID is not specified with {@link #setSessionId(int)}, a new one will 54935ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * be generated. 55035ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi */ 55135ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi public static class Builder { 55235ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi private AudioAttributes mAttributes; 55335ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi private AudioFormat mFormat; 55435ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi private int mBufferSizeInBytes; 55535ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi private int mSessionId = AudioManager.AUDIO_SESSION_ID_GENERATE; 55635ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi private int mMode = MODE_STREAM; 55735ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi 55835ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi /** 55935ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * Constructs a new Builder with the default values as described above. 56035ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi */ 56135ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi public Builder() { 56235ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi } 56335ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi 56435ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi /** 56535ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * Sets the {@link AudioAttributes}. 56635ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * @param attributes a non-null {@link AudioAttributes} instance that describes the audio 56735ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * data to be played. 56835ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * @return the same Builder instance. 56935ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * @throws IllegalArgumentException 57035ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi */ 57135ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi public @NonNull Builder setAudioAttributes(@NonNull AudioAttributes attributes) 57235ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi throws IllegalArgumentException { 57335ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi if (attributes == null) { 57435ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi throw new IllegalArgumentException("Illegal null AudioAttributes argument"); 57535ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi } 57635ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi // keep reference, we only copy the data when building 57735ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi mAttributes = attributes; 57835ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi return this; 57935ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi } 58035ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi 58135ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi /** 58235ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * Sets the format of the audio data to be played by the {@link AudioTrack}. 58335ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * See {@link AudioFormat.Builder} for configuring the audio format parameters such 58435ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * as encoding, channel mask and sample rate. 58535ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * @param format a non-null {@link AudioFormat} instance. 58635ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * @return the same Builder instance. 58735ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * @throws IllegalArgumentException 58835ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi */ 58935ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi public @NonNull Builder setAudioFormat(@NonNull AudioFormat format) 59035ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi throws IllegalArgumentException { 59135ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi if (format == null) { 59235ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi throw new IllegalArgumentException("Illegal null AudioFormat argument"); 59335ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi } 59435ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi // keep reference, we only copy the data when building 59535ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi mFormat = format; 59635ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi return this; 59735ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi } 59835ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi 59935ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi /** 60035ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * Sets the total size (in bytes) of the buffer where audio data is read from for playback. 60135ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * If using the {@link AudioTrack} in streaming mode 60235ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * (see {@link AudioTrack#MODE_STREAM}, you can write data into this buffer in smaller 60335ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * chunks than this size. See {@link #getMinBufferSize(int, int, int)} to determine 60435ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * the minimum required buffer size for the successful creation of an AudioTrack instance 60535ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * in streaming mode. Using values smaller than <code>getMinBufferSize()</code> will result 60635ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * in an exception when trying to build the <code>AudioTrack</code>. 60735ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * <br>If using the <code>AudioTrack</code> in static mode (see 60835ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * {@link AudioTrack#MODE_STATIC}), this is the maximum size of the sound that will be 60935ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * played by this instance. 61035ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * @param bufferSizeInBytes 61135ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * @return the same Builder instance. 61235ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * @throws IllegalArgumentException 61335ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi */ 61435ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi public @NonNull Builder setBufferSizeInBytes(int bufferSizeInBytes) 61535ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi throws IllegalArgumentException { 61635ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi if (bufferSizeInBytes <= 0) { 61735ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi throw new IllegalArgumentException("Invalid buffer size " + bufferSizeInBytes); 61835ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi } 61935ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi mBufferSizeInBytes = bufferSizeInBytes; 62035ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi return this; 62135ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi } 62235ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi 62335ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi /** 62435ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * Sets the mode under which buffers of audio data are transferred from the 62535ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * {@link AudioTrack} to the framework. 62635ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * @param mode one of {@link AudioTrack#MODE_STREAM}, {@link AudioTrack#MODE_STATIC}. 62735ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * @return the same Builder instance. 62835ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * @throws IllegalArgumentException 62935ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi */ 63035ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi public @NonNull Builder setTransferMode(@TransferMode int mode) 63135ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi throws IllegalArgumentException { 63235ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi switch(mode) { 63335ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi case MODE_STREAM: 63435ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi case MODE_STATIC: 63535ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi mMode = mode; 63635ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi break; 63735ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi default: 63835ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi throw new IllegalArgumentException("Invalid transfer mode " + mode); 63935ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi } 64035ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi return this; 64135ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi } 64235ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi 64335ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi /** 64435ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * Sets the session ID the {@link AudioTrack} will be attached to. 64535ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * @param sessionId a strictly positive ID number retrieved from another 64635ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * <code>AudioTrack</code> via {@link AudioTrack#getAudioSessionId()} or allocated by 64735ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * {@link AudioManager} via {@link AudioManager#generateAudioSessionId()}, or 64835ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * {@link AudioManager#AUDIO_SESSION_ID_GENERATE}. 64935ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * @return the same Builder instance. 65035ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * @throws IllegalArgumentException 65135ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi */ 65235ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi public @NonNull Builder setSessionId(int sessionId) 65335ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi throws IllegalArgumentException { 65435ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi if ((sessionId != AudioManager.AUDIO_SESSION_ID_GENERATE) && (sessionId < 1)) { 65535ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi throw new IllegalArgumentException("Invalid audio session ID " + sessionId); 65635ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi } 65735ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi mSessionId = sessionId; 65835ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi return this; 65935ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi } 66035ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi 66135ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi /** 66235ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * Builds an {@link AudioTrack} instance initialized with all the parameters set 66335ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * on this <code>Builder</code>. 6642d2d89363f0b794cbb63f389584fa4c5557ff51aAndy Hung * @return a new successfully initialized {@link AudioTrack} instance. 66535ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * @throws UnsupportedOperationException if the parameters set on the <code>Builder</code> 6662d2d89363f0b794cbb63f389584fa4c5557ff51aAndy Hung * were incompatible, or if they are not supported by the device, 6672d2d89363f0b794cbb63f389584fa4c5557ff51aAndy Hung * or if the device was not available. 66835ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi */ 66935ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi public @NonNull AudioTrack build() throws UnsupportedOperationException { 67035ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi if (mAttributes == null) { 67135ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi mAttributes = new AudioAttributes.Builder() 67235ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi .setUsage(AudioAttributes.USAGE_MEDIA) 67335ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi .build(); 67435ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi } 67535ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi if (mFormat == null) { 67635ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi mFormat = new AudioFormat.Builder() 67735ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi .setChannelMask(AudioFormat.CHANNEL_OUT_STEREO) 67835ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi .setSampleRate(AudioSystem.getPrimaryOutputSamplingRate()) 67935ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi .setEncoding(AudioFormat.ENCODING_DEFAULT) 68035ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi .build(); 68135ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi } 68235ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi try { 6834bd513e6ed168811c97dbc83cd5a7c7cc43caffeAndy Hung // If the buffer size is not specified in streaming mode, 6844bd513e6ed168811c97dbc83cd5a7c7cc43caffeAndy Hung // use a single frame for the buffer size and let the 6854bd513e6ed168811c97dbc83cd5a7c7cc43caffeAndy Hung // native code figure out the minimum buffer size. 6864bd513e6ed168811c97dbc83cd5a7c7cc43caffeAndy Hung if (mMode == MODE_STREAM && mBufferSizeInBytes == 0) { 6874bd513e6ed168811c97dbc83cd5a7c7cc43caffeAndy Hung mBufferSizeInBytes = mFormat.getChannelCount() 6884bd513e6ed168811c97dbc83cd5a7c7cc43caffeAndy Hung * mFormat.getBytesPerSample(mFormat.getEncoding()); 6894bd513e6ed168811c97dbc83cd5a7c7cc43caffeAndy Hung } 6902d2d89363f0b794cbb63f389584fa4c5557ff51aAndy Hung final AudioTrack track = new AudioTrack( 6912d2d89363f0b794cbb63f389584fa4c5557ff51aAndy Hung mAttributes, mFormat, mBufferSizeInBytes, mMode, mSessionId); 6922d2d89363f0b794cbb63f389584fa4c5557ff51aAndy Hung if (track.getState() == STATE_UNINITIALIZED) { 6932d2d89363f0b794cbb63f389584fa4c5557ff51aAndy Hung // release is not necessary 6942d2d89363f0b794cbb63f389584fa4c5557ff51aAndy Hung throw new UnsupportedOperationException("Cannot create AudioTrack"); 6952d2d89363f0b794cbb63f389584fa4c5557ff51aAndy Hung } 6962d2d89363f0b794cbb63f389584fa4c5557ff51aAndy Hung return track; 69735ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi } catch (IllegalArgumentException e) { 69835ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi throw new UnsupportedOperationException(e.getMessage()); 69935ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi } 70035ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi } 70135ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi } 70235ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi 703340a6d09bdba7d4d99cef52a83a90fb96842c58aGlenn Kasten // mask of all the positional channels supported, however the allowed combinations 704340a6d09bdba7d4d99cef52a83a90fb96842c58aGlenn Kasten // are further restricted by the matching left/right rule and CHANNEL_COUNT_MAX 7051b8f499a14a4340d3422d95c7f6fdc8c0c72b3a4Jean-Michel Trivi private static final int SUPPORTED_OUT_CHANNELS = 7061b8f499a14a4340d3422d95c7f6fdc8c0c72b3a4Jean-Michel Trivi AudioFormat.CHANNEL_OUT_FRONT_LEFT | 7071b8f499a14a4340d3422d95c7f6fdc8c0c72b3a4Jean-Michel Trivi AudioFormat.CHANNEL_OUT_FRONT_RIGHT | 7081b8f499a14a4340d3422d95c7f6fdc8c0c72b3a4Jean-Michel Trivi AudioFormat.CHANNEL_OUT_FRONT_CENTER | 7091b8f499a14a4340d3422d95c7f6fdc8c0c72b3a4Jean-Michel Trivi AudioFormat.CHANNEL_OUT_LOW_FREQUENCY | 7101b8f499a14a4340d3422d95c7f6fdc8c0c72b3a4Jean-Michel Trivi AudioFormat.CHANNEL_OUT_BACK_LEFT | 7111b8f499a14a4340d3422d95c7f6fdc8c0c72b3a4Jean-Michel Trivi AudioFormat.CHANNEL_OUT_BACK_RIGHT | 712ad720aeea741d9058a7b4d326c9ab1b3ebcd7c62Andy Hung AudioFormat.CHANNEL_OUT_BACK_CENTER | 713ad720aeea741d9058a7b4d326c9ab1b3ebcd7c62Andy Hung AudioFormat.CHANNEL_OUT_SIDE_LEFT | 714ad720aeea741d9058a7b4d326c9ab1b3ebcd7c62Andy Hung AudioFormat.CHANNEL_OUT_SIDE_RIGHT; 7159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Convenience method for the constructor's parameter checks. 7179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // This is where constructor IllegalArgumentException-s are thrown 7189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // postconditions: 7199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // mChannelCount is valid 7209ea5e5564812bb88e62d0c4fae8f1d40d8a6e7e0Glenn Kasten // mChannelMask is valid 7219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // mAudioFormat is valid 7229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // mSampleRate is valid 7239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // mDataLoadMode is valid 724a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung private void audioParamCheck(int sampleRateInHz, int channelConfig, int channelIndexMask, 725a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung int audioFormat, int mode) { 7269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //-------------- 7275c17a820f9e46e0756c11795b3e6f89105f2f539Glenn Kasten // sample rate, note these values are subject to change 7289e4a66d69673adcf5f32e4b121809322d9ffd97cAndy Hung if (sampleRateInHz < SAMPLE_RATE_HZ_MIN || sampleRateInHz > SAMPLE_RATE_HZ_MAX) { 729f4e58051e22ad4e21c7cd436c37cc5665c194d1cGlenn Kasten throw new IllegalArgumentException(sampleRateInHz 730f4e58051e22ad4e21c7cd436c37cc5665c194d1cGlenn Kasten + "Hz is not a supported sample rate."); 7319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 732896a7f5fee46c24d31e9403abdf5813e4bb84ca5Glenn Kasten mSampleRate = sampleRateInHz; 7339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //-------------- 7359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // channel config 7363026a023b8979b7ddcb3fe97bbc45531c89fda92Eric Laurent mChannelConfiguration = channelConfig; 7373026a023b8979b7ddcb3fe97bbc45531c89fda92Eric Laurent 7389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project switch (channelConfig) { 7393026a023b8979b7ddcb3fe97bbc45531c89fda92Eric Laurent case AudioFormat.CHANNEL_OUT_DEFAULT: //AudioFormat.CHANNEL_CONFIGURATION_DEFAULT 740a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent case AudioFormat.CHANNEL_OUT_MONO: 7413026a023b8979b7ddcb3fe97bbc45531c89fda92Eric Laurent case AudioFormat.CHANNEL_CONFIGURATION_MONO: 7429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mChannelCount = 1; 7439ea5e5564812bb88e62d0c4fae8f1d40d8a6e7e0Glenn Kasten mChannelMask = AudioFormat.CHANNEL_OUT_MONO; 7449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project break; 745a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent case AudioFormat.CHANNEL_OUT_STEREO: 7463026a023b8979b7ddcb3fe97bbc45531c89fda92Eric Laurent case AudioFormat.CHANNEL_CONFIGURATION_STEREO: 7479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mChannelCount = 2; 7489ea5e5564812bb88e62d0c4fae8f1d40d8a6e7e0Glenn Kasten mChannelMask = AudioFormat.CHANNEL_OUT_STEREO; 7499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project break; 7509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project default: 751a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung if (channelConfig == AudioFormat.CHANNEL_INVALID && channelIndexMask != 0) { 752a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung mChannelCount = 0; 753a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung break; // channel index configuration only 754a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung } 755d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi if (!isMultichannelConfigSupported(channelConfig)) { 7561b8f499a14a4340d3422d95c7f6fdc8c0c72b3a4Jean-Michel Trivi // input channel configuration features unsupported channels 757f4e58051e22ad4e21c7cd436c37cc5665c194d1cGlenn Kasten throw new IllegalArgumentException("Unsupported channel configuration."); 7581b8f499a14a4340d3422d95c7f6fdc8c0c72b3a4Jean-Michel Trivi } 7599ea5e5564812bb88e62d0c4fae8f1d40d8a6e7e0Glenn Kasten mChannelMask = channelConfig; 7608528ed43b41ff02535675c5da7425bef5195e73bAndy Hung mChannelCount = AudioFormat.channelCountFromOutChannelMask(channelConfig); 7619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 762a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung // check the channel index configuration (if present) 763a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung mChannelIndexMask = channelIndexMask; 764a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung if (mChannelIndexMask != 0) { 765a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung // restrictive: indexMask could allow up to AUDIO_CHANNEL_BITS_LOG2 766a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung final int indexMask = (1 << CHANNEL_COUNT_MAX) - 1; 767a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung if ((channelIndexMask & ~indexMask) != 0) { 768a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung throw new IllegalArgumentException("Unsupported channel index configuration " 769a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung + channelIndexMask); 770a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung } 771a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung int channelIndexCount = Integer.bitCount(channelIndexMask); 772a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung if (mChannelCount == 0) { 773a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung mChannelCount = channelIndexCount; 774a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung } else if (mChannelCount != channelIndexCount) { 775a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung throw new IllegalArgumentException("Channel count must match"); 776a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung } 777a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung } 7789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //-------------- 7809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // audio format 781ff0d9f098e51c54e1a030ed21fd980680cb7b405Eric Laurent if (audioFormat == AudioFormat.ENCODING_DEFAULT) { 782ff0d9f098e51c54e1a030ed21fd980680cb7b405Eric Laurent audioFormat = AudioFormat.ENCODING_PCM_16BIT; 783ff0d9f098e51c54e1a030ed21fd980680cb7b405Eric Laurent } 784ff0d9f098e51c54e1a030ed21fd980680cb7b405Eric Laurent 785cae346633321e237f824f3ca10d7e6fff2307b2fEric Laurent if (!AudioFormat.isPublicEncoding(audioFormat)) { 786ff0d9f098e51c54e1a030ed21fd980680cb7b405Eric Laurent throw new IllegalArgumentException("Unsupported audio encoding."); 7879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 788ff0d9f098e51c54e1a030ed21fd980680cb7b405Eric Laurent mAudioFormat = audioFormat; 7899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //-------------- 7919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // audio load mode 792ff0d9f098e51c54e1a030ed21fd980680cb7b405Eric Laurent if (((mode != MODE_STREAM) && (mode != MODE_STATIC)) || 793ff0d9f098e51c54e1a030ed21fd980680cb7b405Eric Laurent ((mode != MODE_STREAM) && !AudioFormat.isEncodingLinearPcm(mAudioFormat))) { 794f4e58051e22ad4e21c7cd436c37cc5665c194d1cGlenn Kasten throw new IllegalArgumentException("Invalid mode."); 7959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 796896a7f5fee46c24d31e9403abdf5813e4bb84ca5Glenn Kasten mDataLoadMode = mode; 7979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 799d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi /** 800d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi * Convenience method to check that the channel configuration (a.k.a channel mask) is supported 801d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi * @param channelConfig the mask to validate 802d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi * @return false if the AudioTrack can't be used with such a mask 803d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi */ 804d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi private static boolean isMultichannelConfigSupported(int channelConfig) { 805d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi // check for unsupported channels 806d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi if ((channelConfig & SUPPORTED_OUT_CHANNELS) != channelConfig) { 8071f61d01508651b4475397414e1fe06af1ab8fadaGlenn Kasten loge("Channel configuration features unsupported channels"); 808d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi return false; 809d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi } 8108528ed43b41ff02535675c5da7425bef5195e73bAndy Hung final int channelCount = AudioFormat.channelCountFromOutChannelMask(channelConfig); 811ad720aeea741d9058a7b4d326c9ab1b3ebcd7c62Andy Hung if (channelCount > CHANNEL_COUNT_MAX) { 812ad720aeea741d9058a7b4d326c9ab1b3ebcd7c62Andy Hung loge("Channel configuration contains too many channels " + 813ad720aeea741d9058a7b4d326c9ab1b3ebcd7c62Andy Hung channelCount + ">" + CHANNEL_COUNT_MAX); 814ad720aeea741d9058a7b4d326c9ab1b3ebcd7c62Andy Hung return false; 815ad720aeea741d9058a7b4d326c9ab1b3ebcd7c62Andy Hung } 816d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi // check for unsupported multichannel combinations: 817d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi // - FL/FR must be present 818d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi // - L/R channels must be paired (e.g. no single L channel) 819d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi final int frontPair = 820d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi AudioFormat.CHANNEL_OUT_FRONT_LEFT | AudioFormat.CHANNEL_OUT_FRONT_RIGHT; 821d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi if ((channelConfig & frontPair) != frontPair) { 8221f61d01508651b4475397414e1fe06af1ab8fadaGlenn Kasten loge("Front channels must be present in multichannel configurations"); 823d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi return false; 824d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi } 825d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi final int backPair = 826d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi AudioFormat.CHANNEL_OUT_BACK_LEFT | AudioFormat.CHANNEL_OUT_BACK_RIGHT; 827d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi if ((channelConfig & backPair) != 0) { 828d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi if ((channelConfig & backPair) != backPair) { 8291f61d01508651b4475397414e1fe06af1ab8fadaGlenn Kasten loge("Rear channels can't be used independently"); 830d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi return false; 831d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi } 832d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi } 833ad720aeea741d9058a7b4d326c9ab1b3ebcd7c62Andy Hung final int sidePair = 834ad720aeea741d9058a7b4d326c9ab1b3ebcd7c62Andy Hung AudioFormat.CHANNEL_OUT_SIDE_LEFT | AudioFormat.CHANNEL_OUT_SIDE_RIGHT; 835ad720aeea741d9058a7b4d326c9ab1b3ebcd7c62Andy Hung if ((channelConfig & sidePair) != 0 836ad720aeea741d9058a7b4d326c9ab1b3ebcd7c62Andy Hung && (channelConfig & sidePair) != sidePair) { 837ad720aeea741d9058a7b4d326c9ab1b3ebcd7c62Andy Hung loge("Side channels can't be used independently"); 838ad720aeea741d9058a7b4d326c9ab1b3ebcd7c62Andy Hung return false; 839ad720aeea741d9058a7b4d326c9ab1b3ebcd7c62Andy Hung } 840d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi return true; 841d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi } 842d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi 8439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 844e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten // Convenience method for the constructor's audio buffer size check. 8459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // preconditions: 8469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // mChannelCount is valid 8479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // mAudioFormat is valid 8489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // postcondition: 8499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // mNativeBufferSizeInBytes is valid (multiple of frame size, positive) 8509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private void audioBuffSizeCheck(int audioBufferSize) { 8519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // NB: this section is only valid with PCM data. 8529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // To update when supporting compressed formats 853ff0d9f098e51c54e1a030ed21fd980680cb7b405Eric Laurent int frameSizeInBytes; 854ff0d9f098e51c54e1a030ed21fd980680cb7b405Eric Laurent if (AudioFormat.isEncodingLinearPcm(mAudioFormat)) { 855340a6d09bdba7d4d99cef52a83a90fb96842c58aGlenn Kasten frameSizeInBytes = mChannelCount * AudioFormat.getBytesPerSample(mAudioFormat); 856ff0d9f098e51c54e1a030ed21fd980680cb7b405Eric Laurent } else { 857ff0d9f098e51c54e1a030ed21fd980680cb7b405Eric Laurent frameSizeInBytes = 1; 858ff0d9f098e51c54e1a030ed21fd980680cb7b405Eric Laurent } 8599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if ((audioBufferSize % frameSizeInBytes != 0) || (audioBufferSize < 1)) { 860f4e58051e22ad4e21c7cd436c37cc5665c194d1cGlenn Kasten throw new IllegalArgumentException("Invalid audio buffer size."); 8619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mNativeBufferSizeInBytes = audioBufferSize; 864e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten mNativeBufferSizeInFrames = audioBufferSize / frameSizeInBytes; 8659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Releases the native AudioTrack resources. 8709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void release() { 8729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // even though native_release() stops the native AudioTrack, we need to stop 8739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // AudioTrack subclasses too. 8749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 8759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project stop(); 876fb2ab9efc3805c81521afb9ff91a58ff5097a36eGlenn Kasten } catch(IllegalStateException ise) { 8779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // don't raise an exception, we're releasing the resources. 8789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project native_release(); 8809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mState = STATE_UNINITIALIZED; 8819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 8849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project protected void finalize() { 8859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project native_finalize(); 8869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //-------------------------------------------------------------------------- 8899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Getters 8909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //-------------------- 8919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 89278cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * Returns the minimum gain value, which is the constant 0.0. 89378cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * Gain values less than 0.0 will be clamped to 0.0. 89478cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * <p>The word "volume" in the API name is historical; this is actually a linear gain. 89578cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * @return the minimum value, which is the constant 0.0. 8969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project static public float getMinVolume() { 89878cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten return GAIN_MIN; 8999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 90278cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * Returns the maximum gain value, which is greater than or equal to 1.0. 90378cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * Gain values greater than the maximum will be clamped to the maximum. 90478cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * <p>The word "volume" in the API name is historical; this is actually a gain. 90578cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * expressed as a linear multiplier on sample values, where a maximum value of 1.0 90678cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * corresponds to a gain of 0 dB (sample values left unmodified). 90778cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * @return the maximum value, which is greater than or equal to 1.0. 9089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project static public float getMaxVolume() { 91078cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten return GAIN_MAX; 9119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the configured audio data sample rate in Hz 9159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getSampleRate() { 9179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mSampleRate; 9189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 919fb2ab9efc3805c81521afb9ff91a58ff5097a36eGlenn Kasten 9209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 921263b4c97823295c41900210515d0c769a236190cAndy Hung * Returns the current playback sample rate rate in Hz. 9229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getPlaybackRate() { 9249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return native_get_playback_rate(); 9259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9285f68c7a3f8400bcef233bf02d9a722f6d21f5c34Glenn Kasten * Returns the current playback parameters. 9295f68c7a3f8400bcef233bf02d9a722f6d21f5c34Glenn Kasten * See {@link #setPlaybackParams(PlaybackParams)} to set playback parameters 9302d61e2b97c92ac2de80ebb3782b728ae5cdf5306Wei Jia * @return current {@link PlaybackParams}. 931263b4c97823295c41900210515d0c769a236190cAndy Hung * @throws IllegalStateException if track is not initialized. 932263b4c97823295c41900210515d0c769a236190cAndy Hung */ 9332d61e2b97c92ac2de80ebb3782b728ae5cdf5306Wei Jia public @NonNull PlaybackParams getPlaybackParams() { 9342d61e2b97c92ac2de80ebb3782b728ae5cdf5306Wei Jia return native_get_playback_params(); 935263b4c97823295c41900210515d0c769a236190cAndy Hung } 936263b4c97823295c41900210515d0c769a236190cAndy Hung 937263b4c97823295c41900210515d0c769a236190cAndy Hung /** 938463a8c7743c5187827a8ac56b7767b50ab491ca8Andy Hung * Returns the configured audio data encoding. See {@link AudioFormat#ENCODING_PCM_8BIT}, 939463a8c7743c5187827a8ac56b7767b50ab491ca8Andy Hung * {@link AudioFormat#ENCODING_PCM_16BIT}, and {@link AudioFormat#ENCODING_PCM_FLOAT}. 9409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getAudioFormat() { 9429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mAudioFormat; 9439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the type of audio stream this AudioTrack is configured for. 9479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Compare the result against {@link AudioManager#STREAM_VOICE_CALL}, 9489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link AudioManager#STREAM_SYSTEM}, {@link AudioManager#STREAM_RING}, 9495c17a820f9e46e0756c11795b3e6f89105f2f539Glenn Kasten * {@link AudioManager#STREAM_MUSIC}, {@link AudioManager#STREAM_ALARM}, 950b282e08ab641d4fc74d0324b7a0ce30926638dd5Glenn Kasten * {@link AudioManager#STREAM_NOTIFICATION}, or {@link AudioManager#STREAM_DTMF}. 9519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getStreamType() { 9539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mStreamType; 9549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 957a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung * Returns the configured channel position mask. 958463a8c7743c5187827a8ac56b7767b50ab491ca8Andy Hung * <p> For example, refer to {@link AudioFormat#CHANNEL_OUT_MONO}, 959a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung * {@link AudioFormat#CHANNEL_OUT_STEREO}, {@link AudioFormat#CHANNEL_OUT_5POINT1}. 960463a8c7743c5187827a8ac56b7767b50ab491ca8Andy Hung * This method may return {@link AudioFormat#CHANNEL_INVALID} if 961340a6d09bdba7d4d99cef52a83a90fb96842c58aGlenn Kasten * a channel index mask was used. Consider 962463a8c7743c5187827a8ac56b7767b50ab491ca8Andy Hung * {@link #getFormat()} instead, to obtain an {@link AudioFormat}, 963463a8c7743c5187827a8ac56b7767b50ab491ca8Andy Hung * which contains both the channel position mask and the channel index mask. 9649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getChannelConfiguration() { 9669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mChannelConfiguration; 9679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 970463a8c7743c5187827a8ac56b7767b50ab491ca8Andy Hung * Returns the configured <code>AudioTrack</code> format. 971463a8c7743c5187827a8ac56b7767b50ab491ca8Andy Hung * @return an {@link AudioFormat} containing the 972463a8c7743c5187827a8ac56b7767b50ab491ca8Andy Hung * <code>AudioTrack</code> parameters at the time of configuration. 973463a8c7743c5187827a8ac56b7767b50ab491ca8Andy Hung */ 974463a8c7743c5187827a8ac56b7767b50ab491ca8Andy Hung public @NonNull AudioFormat getFormat() { 975463a8c7743c5187827a8ac56b7767b50ab491ca8Andy Hung AudioFormat.Builder builder = new AudioFormat.Builder() 976463a8c7743c5187827a8ac56b7767b50ab491ca8Andy Hung .setSampleRate(mSampleRate) 977463a8c7743c5187827a8ac56b7767b50ab491ca8Andy Hung .setEncoding(mAudioFormat); 978463a8c7743c5187827a8ac56b7767b50ab491ca8Andy Hung if (mChannelConfiguration != AudioFormat.CHANNEL_INVALID) { 979463a8c7743c5187827a8ac56b7767b50ab491ca8Andy Hung builder.setChannelMask(mChannelConfiguration); 980463a8c7743c5187827a8ac56b7767b50ab491ca8Andy Hung } 981463a8c7743c5187827a8ac56b7767b50ab491ca8Andy Hung if (mChannelIndexMask != AudioFormat.CHANNEL_INVALID /* 0 */) { 982463a8c7743c5187827a8ac56b7767b50ab491ca8Andy Hung builder.setChannelIndexMask(mChannelIndexMask); 983463a8c7743c5187827a8ac56b7767b50ab491ca8Andy Hung } 984463a8c7743c5187827a8ac56b7767b50ab491ca8Andy Hung return builder.build(); 985463a8c7743c5187827a8ac56b7767b50ab491ca8Andy Hung } 986463a8c7743c5187827a8ac56b7767b50ab491ca8Andy Hung 987463a8c7743c5187827a8ac56b7767b50ab491ca8Andy Hung /** 9889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the configured number of channels. 9899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getChannelCount() { 9919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mChannelCount; 9929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the state of the AudioTrack instance. This is useful after the 9969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * AudioTrack instance has been created to check if it was initialized 997e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * properly. This ensures that the appropriate resources have been acquired. 998340a6d09bdba7d4d99cef52a83a90fb96842c58aGlenn Kasten * @see #STATE_UNINITIALIZED 999ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * @see #STATE_INITIALIZED 1000ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * @see #STATE_NO_STATIC_DATA 10019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 10029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getState() { 10039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mState; 10049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 10079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the playback state of the AudioTrack instance. 10089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #PLAYSTATE_STOPPED 10099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #PLAYSTATE_PAUSED 10109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #PLAYSTATE_PLAYING 10119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 10129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getPlayState() { 101306e0333c7eb50533cc6e0f7b61812d2840844296Narayan Kamath synchronized (mPlayStateLock) { 101406e0333c7eb50533cc6e0f7b61812d2840844296Narayan Kamath return mPlayState; 101506e0333c7eb50533cc6e0f7b61812d2840844296Narayan Kamath } 10169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1019e90a0a88f4eabdc27c3ef033f38c91ea23362a1eAndy Hung * Returns the frame count of the native <code>AudioTrack</code> buffer. 10204bd513e6ed168811c97dbc83cd5a7c7cc43caffeAndy Hung * <p> If the track's creation mode is {@link #MODE_STATIC}, 10214bd513e6ed168811c97dbc83cd5a7c7cc43caffeAndy Hung * it is equal to the specified bufferSizeInBytes on construction, converted to frame units. 10224bd513e6ed168811c97dbc83cd5a7c7cc43caffeAndy Hung * A static track's native frame count will not change. 10234bd513e6ed168811c97dbc83cd5a7c7cc43caffeAndy Hung * <p> If the track's creation mode is {@link #MODE_STREAM}, 10244bd513e6ed168811c97dbc83cd5a7c7cc43caffeAndy Hung * it is greater than or equal to the specified bufferSizeInBytes converted to frame units. 10254bd513e6ed168811c97dbc83cd5a7c7cc43caffeAndy Hung * For streaming tracks, this value may be rounded up to a larger value if needed by 10264bd513e6ed168811c97dbc83cd5a7c7cc43caffeAndy Hung * the target output sink, and 10274bd513e6ed168811c97dbc83cd5a7c7cc43caffeAndy Hung * if the track is subsequently routed to a different output sink, the native 10284bd513e6ed168811c97dbc83cd5a7c7cc43caffeAndy Hung * frame count may enlarge to accommodate. 1029e90a0a88f4eabdc27c3ef033f38c91ea23362a1eAndy Hung * <p> If the <code>AudioTrack</code> encoding indicates compressed data, 1030e90a0a88f4eabdc27c3ef033f38c91ea23362a1eAndy Hung * e.g. {@link AudioFormat#ENCODING_AC3}, then the frame count returned is 1031e90a0a88f4eabdc27c3ef033f38c91ea23362a1eAndy Hung * the size of the native <code>AudioTrack</code> buffer in bytes. 1032e90a0a88f4eabdc27c3ef033f38c91ea23362a1eAndy Hung * <p> See also {@link AudioManager#getProperty(String)} for key 103355a3218f242a611afb3569d88970c0c5dbf8ce54Glenn Kasten * {@link AudioManager#PROPERTY_OUTPUT_FRAMES_PER_BUFFER}. 1034e90a0a88f4eabdc27c3ef033f38c91ea23362a1eAndy Hung * @return current size in frames of the <code>AudioTrack</code> buffer. 10354bd513e6ed168811c97dbc83cd5a7c7cc43caffeAndy Hung * @throws IllegalStateException 10369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1037e90a0a88f4eabdc27c3ef033f38c91ea23362a1eAndy Hung public int getBufferSizeInFrames() { 1038e90a0a88f4eabdc27c3ef033f38c91ea23362a1eAndy Hung return native_get_native_frame_count(); 1039e90a0a88f4eabdc27c3ef033f38c91ea23362a1eAndy Hung } 1040e90a0a88f4eabdc27c3ef033f38c91ea23362a1eAndy Hung 1041e90a0a88f4eabdc27c3ef033f38c91ea23362a1eAndy Hung /** 1042e90a0a88f4eabdc27c3ef033f38c91ea23362a1eAndy Hung * Returns the frame count of the native <code>AudioTrack</code> buffer. 1043e90a0a88f4eabdc27c3ef033f38c91ea23362a1eAndy Hung * @return current size in frames of the <code>AudioTrack</code> buffer. 1044e90a0a88f4eabdc27c3ef033f38c91ea23362a1eAndy Hung * @throws IllegalStateException 1045e90a0a88f4eabdc27c3ef033f38c91ea23362a1eAndy Hung * @deprecated Use the identical public method {@link #getBufferSizeInFrames()} instead. 1046e90a0a88f4eabdc27c3ef033f38c91ea23362a1eAndy Hung */ 1047e90a0a88f4eabdc27c3ef033f38c91ea23362a1eAndy Hung @Deprecated 1048e90a0a88f4eabdc27c3ef033f38c91ea23362a1eAndy Hung protected int getNativeFrameCount() { 10499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return native_get_native_frame_count(); 10509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1053ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * Returns marker position expressed in frames. 1054e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * @return marker position in wrapping frame units similar to {@link #getPlaybackHeadPosition}, 1055e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * or zero if marker is disabled. 10569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 10579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getNotificationMarkerPosition() { 10589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return native_get_marker_pos(); 10599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1062ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * Returns the notification update period expressed in frames. 1063e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * Zero means that no position update notifications are being delivered. 10649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 10659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getPositionNotificationPeriod() { 10669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return native_get_pos_update_period(); 10679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1070e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * Returns the playback head position expressed in frames. 1071e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * Though the "int" type is signed 32-bits, the value should be reinterpreted as if it is 1072e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * unsigned 32-bits. That is, the next position after 0x7FFFFFFF is (int) 0x80000000. 1073e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * This is a continuously advancing counter. It will wrap (overflow) periodically, 1074e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * for example approximately once every 27:03:11 hours:minutes:seconds at 44.1 kHz. 1075ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * It is reset to zero by {@link #flush()}, {@link #reloadStaticData()}, and {@link #stop()}. 1076ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * If the track's creation mode is {@link #MODE_STATIC}, the return value indicates 1077ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * the total number of frames played since reset, 1078ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * <i>not</i> the current offset within the buffer. 10799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 10809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getPlaybackHeadPosition() { 10819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return native_get_position(); 10829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 108561dcdf3764b614c6f01e77cb4342d192e3101f8aOliver Woodman * Returns this track's estimated latency in milliseconds. This includes the latency due 108661dcdf3764b614c6f01e77cb4342d192e3101f8aOliver Woodman * to AudioTrack buffer size, AudioMixer (if any) and audio hardware driver. 108761dcdf3764b614c6f01e77cb4342d192e3101f8aOliver Woodman * 108861dcdf3764b614c6f01e77cb4342d192e3101f8aOliver Woodman * DO NOT UNHIDE. The existing approach for doing A/V sync has too many problems. We need 108961dcdf3764b614c6f01e77cb4342d192e3101f8aOliver Woodman * a better solution. 109061dcdf3764b614c6f01e77cb4342d192e3101f8aOliver Woodman * @hide 109161dcdf3764b614c6f01e77cb4342d192e3101f8aOliver Woodman */ 109261dcdf3764b614c6f01e77cb4342d192e3101f8aOliver Woodman public int getLatency() { 109361dcdf3764b614c6f01e77cb4342d192e3101f8aOliver Woodman return native_get_latency(); 109461dcdf3764b614c6f01e77cb4342d192e3101f8aOliver Woodman } 109561dcdf3764b614c6f01e77cb4342d192e3101f8aOliver Woodman 109661dcdf3764b614c6f01e77cb4342d192e3101f8aOliver Woodman /** 1097e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * Returns the output sample rate in Hz for the specified stream type. 10989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 10999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project static public int getNativeOutputSampleRate(int streamType) { 11009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return native_get_output_sample_rate(streamType); 11019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1102fb2ab9efc3805c81521afb9ff91a58ff5097a36eGlenn Kasten 11039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the minimum buffer size required for the successful creation of an AudioTrack 1105ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * object to be created in the {@link #MODE_STREAM} mode. Note that this size doesn't 1106ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * guarantee a smooth playback under load, and higher values should be chosen according to 1107fb2ab9efc3805c81521afb9ff91a58ff5097a36eGlenn Kasten * the expected frequency at which the buffer will be refilled with additional data to play. 11088d7fa137466c833ed422053204fb4c506b7bb209Glenn Kasten * For example, if you intend to dynamically set the source sample rate of an AudioTrack 11098d7fa137466c833ed422053204fb4c506b7bb209Glenn Kasten * to a higher value than the initial source sample rate, be sure to configure the buffer size 11108d7fa137466c833ed422053204fb4c506b7bb209Glenn Kasten * based on the highest planned sample rate. 11118d7fa137466c833ed422053204fb4c506b7bb209Glenn Kasten * @param sampleRateInHz the source sample rate expressed in Hz. 1112fb2ab9efc3805c81521afb9ff91a58ff5097a36eGlenn Kasten * @param channelConfig describes the configuration of the audio channels. 1113a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * See {@link AudioFormat#CHANNEL_OUT_MONO} and 1114a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * {@link AudioFormat#CHANNEL_OUT_STEREO} 1115fb2ab9efc3805c81521afb9ff91a58ff5097a36eGlenn Kasten * @param audioFormat the format in which the audio data is represented. 1116fb2ab9efc3805c81521afb9ff91a58ff5097a36eGlenn Kasten * See {@link AudioFormat#ENCODING_PCM_16BIT} and 11177d60bcd2d950e3571c00ce9f1c492c6bd58334c9Glenn Kasten * {@link AudioFormat#ENCODING_PCM_8BIT}, 11187d60bcd2d950e3571c00ce9f1c492c6bd58334c9Glenn Kasten * and {@link AudioFormat#ENCODING_PCM_FLOAT}. 11199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return {@link #ERROR_BAD_VALUE} if an invalid parameter was passed, 1120e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * or {@link #ERROR} if unable to query for output properties, 1121ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * or the minimum buffer size expressed in bytes. 11229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 11239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project static public int getMinBufferSize(int sampleRateInHz, int channelConfig, int audioFormat) { 11249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int channelCount = 0; 11259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project switch(channelConfig) { 1126a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent case AudioFormat.CHANNEL_OUT_MONO: 11273026a023b8979b7ddcb3fe97bbc45531c89fda92Eric Laurent case AudioFormat.CHANNEL_CONFIGURATION_MONO: 11289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project channelCount = 1; 11299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project break; 1130a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent case AudioFormat.CHANNEL_OUT_STEREO: 11313026a023b8979b7ddcb3fe97bbc45531c89fda92Eric Laurent case AudioFormat.CHANNEL_CONFIGURATION_STEREO: 11329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project channelCount = 2; 11339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project break; 11349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project default: 1135a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung if (!isMultichannelConfigSupported(channelConfig)) { 11361b8f499a14a4340d3422d95c7f6fdc8c0c72b3a4Jean-Michel Trivi loge("getMinBufferSize(): Invalid channel configuration."); 1137df3cb5279857cac41909643c6703e8fc1621fad1Glenn Kasten return ERROR_BAD_VALUE; 11381b8f499a14a4340d3422d95c7f6fdc8c0c72b3a4Jean-Michel Trivi } else { 11398528ed43b41ff02535675c5da7425bef5195e73bAndy Hung channelCount = AudioFormat.channelCountFromOutChannelMask(channelConfig); 11401b8f499a14a4340d3422d95c7f6fdc8c0c72b3a4Jean-Michel Trivi } 11419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1142fb2ab9efc3805c81521afb9ff91a58ff5097a36eGlenn Kasten 1143cae346633321e237f824f3ca10d7e6fff2307b2fEric Laurent if (!AudioFormat.isPublicEncoding(audioFormat)) { 11449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project loge("getMinBufferSize(): Invalid audio format."); 1145df3cb5279857cac41909643c6703e8fc1621fad1Glenn Kasten return ERROR_BAD_VALUE; 11469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1147fb2ab9efc3805c81521afb9ff91a58ff5097a36eGlenn Kasten 11485c17a820f9e46e0756c11795b3e6f89105f2f539Glenn Kasten // sample rate, note these values are subject to change 1149ad67c9546494a7c4d9336b57889a7c19a7dbb945Glenn Kasten if ( (sampleRateInHz < SAMPLE_RATE_HZ_MIN) || (sampleRateInHz > SAMPLE_RATE_HZ_MAX) ) { 1150ad67c9546494a7c4d9336b57889a7c19a7dbb945Glenn Kasten loge("getMinBufferSize(): " + sampleRateInHz + " Hz is not a supported sample rate."); 1151df3cb5279857cac41909643c6703e8fc1621fad1Glenn Kasten return ERROR_BAD_VALUE; 11529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1153fb2ab9efc3805c81521afb9ff91a58ff5097a36eGlenn Kasten 11549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int size = native_get_min_buff_size(sampleRateInHz, channelCount, audioFormat); 1155a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten if (size <= 0) { 11569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project loge("getMinBufferSize(): error querying hardware"); 1157df3cb5279857cac41909643c6703e8fc1621fad1Glenn Kasten return ERROR; 11589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project else { 11609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return size; 11619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1164619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent /** 1165619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * Returns the audio session ID. 1166619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * 1167619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * @return the ID of the audio session this AudioTrack belongs to. 1168619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent */ 1169619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent public int getAudioSessionId() { 1170619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent return mSessionId; 1171619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent } 11729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1173948c2e6ff46d65942277f2e0e9ce0c038972b9d8Glenn Kasten /** 1174948c2e6ff46d65942277f2e0e9ce0c038972b9d8Glenn Kasten * Poll for a timestamp on demand. 1175486918b41584cd2589c46c5217b3fba1e7d18874Glenn Kasten * <p> 1176486918b41584cd2589c46c5217b3fba1e7d18874Glenn Kasten * If you need to track timestamps during initial warmup or after a routing or mode change, 117700908b6c6964346af4d2512ba161a109912d97b8Glenn Kasten * you should request a new timestamp periodically until the reported timestamps 117800908b6c6964346af4d2512ba161a109912d97b8Glenn Kasten * show that the frame position is advancing, or until it becomes clear that 117900908b6c6964346af4d2512ba161a109912d97b8Glenn Kasten * timestamps are unavailable for this route. 118000908b6c6964346af4d2512ba161a109912d97b8Glenn Kasten * <p> 118100908b6c6964346af4d2512ba161a109912d97b8Glenn Kasten * After the clock is advancing at a stable rate, 118200908b6c6964346af4d2512ba161a109912d97b8Glenn Kasten * query for a new timestamp approximately once every 10 seconds to once per minute. 1183486918b41584cd2589c46c5217b3fba1e7d18874Glenn Kasten * Calling this method more often is inefficient. 1184486918b41584cd2589c46c5217b3fba1e7d18874Glenn Kasten * It is also counter-productive to call this method more often than recommended, 1185486918b41584cd2589c46c5217b3fba1e7d18874Glenn Kasten * because the short-term differences between successive timestamp reports are not meaningful. 1186486918b41584cd2589c46c5217b3fba1e7d18874Glenn Kasten * If you need a high-resolution mapping between frame position and presentation time, 1187948c2e6ff46d65942277f2e0e9ce0c038972b9d8Glenn Kasten * consider implementing that at application level, based on low-resolution timestamps. 1188486918b41584cd2589c46c5217b3fba1e7d18874Glenn Kasten * <p> 1189948c2e6ff46d65942277f2e0e9ce0c038972b9d8Glenn Kasten * The audio data at the returned position may either already have been 1190948c2e6ff46d65942277f2e0e9ce0c038972b9d8Glenn Kasten * presented, or may have not yet been presented but is committed to be presented. 1191948c2e6ff46d65942277f2e0e9ce0c038972b9d8Glenn Kasten * It is not possible to request the time corresponding to a particular position, 1192948c2e6ff46d65942277f2e0e9ce0c038972b9d8Glenn Kasten * or to request the (fractional) position corresponding to a particular time. 1193948c2e6ff46d65942277f2e0e9ce0c038972b9d8Glenn Kasten * If you need such features, consider implementing them at application level. 1194948c2e6ff46d65942277f2e0e9ce0c038972b9d8Glenn Kasten * 1195948c2e6ff46d65942277f2e0e9ce0c038972b9d8Glenn Kasten * @param timestamp a reference to a non-null AudioTimestamp instance allocated 1196596fb8e7969cafdf7f25dfdc97372be4c0950cc3Glenn Kasten * and owned by caller. 1197596fb8e7969cafdf7f25dfdc97372be4c0950cc3Glenn Kasten * @return true if a timestamp is available, or false if no timestamp is available. 1198596fb8e7969cafdf7f25dfdc97372be4c0950cc3Glenn Kasten * If a timestamp if available, 1199948c2e6ff46d65942277f2e0e9ce0c038972b9d8Glenn Kasten * the AudioTimestamp instance is filled in with a position in frame units, together 1200948c2e6ff46d65942277f2e0e9ce0c038972b9d8Glenn Kasten * with the estimated time when that frame was presented or is committed to 1201948c2e6ff46d65942277f2e0e9ce0c038972b9d8Glenn Kasten * be presented. 1202948c2e6ff46d65942277f2e0e9ce0c038972b9d8Glenn Kasten * In the case that no timestamp is available, any supplied instance is left unaltered. 1203c52f4e25e21719d5d637a588e3200be941b9fe4dGlenn Kasten * A timestamp may be temporarily unavailable while the audio clock is stabilizing, 1204c52f4e25e21719d5d637a588e3200be941b9fe4dGlenn Kasten * or during and immediately after a route change. 120500908b6c6964346af4d2512ba161a109912d97b8Glenn Kasten * A timestamp is permanently unavailable for a given route if the route does not support 120600908b6c6964346af4d2512ba161a109912d97b8Glenn Kasten * timestamps. In this case, the approximate frame position can be obtained 120700908b6c6964346af4d2512ba161a109912d97b8Glenn Kasten * using {@link #getPlaybackHeadPosition}. 120800908b6c6964346af4d2512ba161a109912d97b8Glenn Kasten * However, it may be useful to continue to query for 120900908b6c6964346af4d2512ba161a109912d97b8Glenn Kasten * timestamps occasionally, to recover after a route change. 1210948c2e6ff46d65942277f2e0e9ce0c038972b9d8Glenn Kasten */ 1211486918b41584cd2589c46c5217b3fba1e7d18874Glenn Kasten // Add this text when the "on new timestamp" API is added: 1212486918b41584cd2589c46c5217b3fba1e7d18874Glenn Kasten // Use if you need to get the most recent timestamp outside of the event callback handler. 1213596fb8e7969cafdf7f25dfdc97372be4c0950cc3Glenn Kasten public boolean getTimestamp(AudioTimestamp timestamp) 1214948c2e6ff46d65942277f2e0e9ce0c038972b9d8Glenn Kasten { 1215596fb8e7969cafdf7f25dfdc97372be4c0950cc3Glenn Kasten if (timestamp == null) { 1216596fb8e7969cafdf7f25dfdc97372be4c0950cc3Glenn Kasten throw new IllegalArgumentException(); 1217596fb8e7969cafdf7f25dfdc97372be4c0950cc3Glenn Kasten } 1218948c2e6ff46d65942277f2e0e9ce0c038972b9d8Glenn Kasten // It's unfortunate, but we have to either create garbage every time or use synchronized 1219948c2e6ff46d65942277f2e0e9ce0c038972b9d8Glenn Kasten long[] longArray = new long[2]; 1220948c2e6ff46d65942277f2e0e9ce0c038972b9d8Glenn Kasten int ret = native_get_timestamp(longArray); 1221596fb8e7969cafdf7f25dfdc97372be4c0950cc3Glenn Kasten if (ret != SUCCESS) { 1222596fb8e7969cafdf7f25dfdc97372be4c0950cc3Glenn Kasten return false; 1223948c2e6ff46d65942277f2e0e9ce0c038972b9d8Glenn Kasten } 1224596fb8e7969cafdf7f25dfdc97372be4c0950cc3Glenn Kasten timestamp.framePosition = longArray[0]; 1225596fb8e7969cafdf7f25dfdc97372be4c0950cc3Glenn Kasten timestamp.nanoTime = longArray[1]; 1226596fb8e7969cafdf7f25dfdc97372be4c0950cc3Glenn Kasten return true; 1227948c2e6ff46d65942277f2e0e9ce0c038972b9d8Glenn Kasten } 1228948c2e6ff46d65942277f2e0e9ce0c038972b9d8Glenn Kasten 1229948c2e6ff46d65942277f2e0e9ce0c038972b9d8Glenn Kasten 12309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //-------------------------------------------------------------------------- 12319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Initialization / configuration 12329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //-------------------- 12339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 12344df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project * Sets the listener the AudioTrack notifies when a previously set marker is reached or 12354df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project * for each periodic playback head position update. 1236ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * Notifications will be received in the same thread as the one in which the AudioTrack 1237ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * instance was created. 12389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param listener 12399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 12404df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project public void setPlaybackPositionUpdateListener(OnPlaybackPositionUpdateListener listener) { 12414df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project setPlaybackPositionUpdateListener(listener, null); 12429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1243fb2ab9efc3805c81521afb9ff91a58ff5097a36eGlenn Kasten 1244ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi /** 1245ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * Sets the listener the AudioTrack notifies when a previously set marker is reached or 1246ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * for each periodic playback head position update. 1247ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * Use this method to receive AudioTrack events in the Handler associated with another 1248ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * thread than the one in which you created the AudioTrack instance. 1249ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * @param listener 1250ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * @param handler the Handler that will receive the event notification messages. 1251ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi */ 1252fb2ab9efc3805c81521afb9ff91a58ff5097a36eGlenn Kasten public void setPlaybackPositionUpdateListener(OnPlaybackPositionUpdateListener listener, 12534df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project Handler handler) { 12544df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project if (listener != null) { 1255d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean mEventHandlerDelegate = new NativePositionEventHandlerDelegate(this, listener, handler); 125695bd2329c6a36211f18be3e089eaa775ec62df62Glenn Kasten } else { 125795bd2329c6a36211f18be3e089eaa775ec62df62Glenn Kasten mEventHandlerDelegate = null; 12589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 126278cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten private static float clampGainOrLevel(float gainOrLevel) { 126378cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten if (Float.isNaN(gainOrLevel)) { 126478cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten throw new IllegalArgumentException(); 126578cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten } 126678cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten if (gainOrLevel < GAIN_MIN) { 126778cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten gainOrLevel = GAIN_MIN; 126878cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten } else if (gainOrLevel > GAIN_MAX) { 126978cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten gainOrLevel = GAIN_MAX; 127078cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten } 127178cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten return gainOrLevel; 127278cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten } 127378cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten 12744df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project 12759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 127678cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * Sets the specified left and right output gain values on the AudioTrack. 127778cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * <p>Gain values are clamped to the closed interval [0.0, max] where 127878cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * max is the value of {@link #getMaxVolume}. 127978cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * A value of 0.0 results in zero gain (silence), and 128078cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * a value of 1.0 means unity gain (signal unchanged). 128178cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * The default value is 1.0 meaning unity gain. 128278cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * <p>The word "volume" in the API name is historical; this is actually a linear gain. 128378cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * @param leftGain output gain for the left channel. 128478cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * @param rightGain output gain for the right channel 12859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return error code or success, see {@link #SUCCESS}, 12869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #ERROR_INVALID_OPERATION} 128778cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * @deprecated Applications should use {@link #setVolume} instead, as it 128878cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * more gracefully scales down to mono, and up to multi-channel content beyond stereo. 12899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 129078cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten public int setStereoVolume(float leftGain, float rightGain) { 12911af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlock if (isRestricted()) { 12921af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlock return SUCCESS; 12931af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlock } 12943b4df62704a6184878afd9272830cf3db7bd2d66Glenn Kasten if (mState == STATE_UNINITIALIZED) { 12959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return ERROR_INVALID_OPERATION; 12969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 129878cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten leftGain = clampGainOrLevel(leftGain); 129978cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten rightGain = clampGainOrLevel(rightGain); 13009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 130178cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten native_setVolume(leftGain, rightGain); 13029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return SUCCESS; 13049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 130878cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * Sets the specified output gain value on all channels of this track. 130978cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * <p>Gain values are clamped to the closed interval [0.0, max] where 131078cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * max is the value of {@link #getMaxVolume}. 131178cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * A value of 0.0 results in zero gain (silence), and 131278cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * a value of 1.0 means unity gain (signal unchanged). 131378cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * The default value is 1.0 meaning unity gain. 131478cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * <p>This API is preferred over {@link #setStereoVolume}, as it 131578cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * more gracefully scales down to mono, and up to multi-channel content beyond stereo. 131678cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * <p>The word "volume" in the API name is historical; this is actually a linear gain. 131778cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * @param gain output gain for all channels. 13183e21cc8140e42bdcd924590e5e12446b6c55ad2aGlenn Kasten * @return error code or success, see {@link #SUCCESS}, 13193e21cc8140e42bdcd924590e5e12446b6c55ad2aGlenn Kasten * {@link #ERROR_INVALID_OPERATION} 1320068225de0197df07a0247b2877666ea91c22c992Glenn Kasten */ 132178cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten public int setVolume(float gain) { 132278cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten return setStereoVolume(gain, gain); 1323068225de0197df07a0247b2877666ea91c22c992Glenn Kasten } 1324068225de0197df07a0247b2877666ea91c22c992Glenn Kasten 1325068225de0197df07a0247b2877666ea91c22c992Glenn Kasten 1326068225de0197df07a0247b2877666ea91c22c992Glenn Kasten /** 13279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets the playback sample rate for this track. This sets the sampling rate at which 13288d7fa137466c833ed422053204fb4c506b7bb209Glenn Kasten * the audio data will be consumed and played back 13298d7fa137466c833ed422053204fb4c506b7bb209Glenn Kasten * (as set by the sampleRateInHz parameter in the 13308d7fa137466c833ed422053204fb4c506b7bb209Glenn Kasten * {@link #AudioTrack(int, int, int, int, int, int)} constructor), 13318d7fa137466c833ed422053204fb4c506b7bb209Glenn Kasten * not the original sampling rate of the 1332e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * content. For example, setting it to half the sample rate of the content will cause the 1333e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * playback to last twice as long, but will also result in a pitch shift down by one octave. 1334e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * The valid sample rate range is from 1 Hz to twice the value returned by 133588e209dcf8c2ebddda5c272f46d1bd5478bc639cEric Laurent * {@link #getNativeOutputSampleRate(int)}. 13362d61e2b97c92ac2de80ebb3782b728ae5cdf5306Wei Jia * Use {@link #setPlaybackParams(PlaybackParams)} for speed control. 1337e90a0a88f4eabdc27c3ef033f38c91ea23362a1eAndy Hung * <p> This method may also be used to repurpose an existing <code>AudioTrack</code> 1338e90a0a88f4eabdc27c3ef033f38c91ea23362a1eAndy Hung * for playback of content of differing sample rate, 1339e90a0a88f4eabdc27c3ef033f38c91ea23362a1eAndy Hung * but with identical encoding and channel mask. 1340ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * @param sampleRateInHz the sample rate expressed in Hz 13419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return error code or success, see {@link #SUCCESS}, {@link #ERROR_BAD_VALUE}, 13429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #ERROR_INVALID_OPERATION} 13439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 13449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int setPlaybackRate(int sampleRateInHz) { 1345f19395db6343efdf80d064e0ba7c3b9aa4dbae75Glenn Kasten if (mState != STATE_INITIALIZED) { 13469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return ERROR_INVALID_OPERATION; 13479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (sampleRateInHz <= 0) { 13499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return ERROR_BAD_VALUE; 13509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 135188e209dcf8c2ebddda5c272f46d1bd5478bc639cEric Laurent return native_set_playback_rate(sampleRateInHz); 13529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 13565f68c7a3f8400bcef233bf02d9a722f6d21f5c34Glenn Kasten * Sets the playback parameters. 13575f68c7a3f8400bcef233bf02d9a722f6d21f5c34Glenn Kasten * This method returns failure if it cannot apply the playback parameters. 1358263b4c97823295c41900210515d0c769a236190cAndy Hung * One possible cause is that the parameters for speed or pitch are out of range. 1359263b4c97823295c41900210515d0c769a236190cAndy Hung * Another possible cause is that the <code>AudioTrack</code> is streaming 1360263b4c97823295c41900210515d0c769a236190cAndy Hung * (see {@link #MODE_STREAM}) and the 1361263b4c97823295c41900210515d0c769a236190cAndy Hung * buffer size is too small. For speeds greater than 1.0f, the <code>AudioTrack</code> buffer 1362263b4c97823295c41900210515d0c769a236190cAndy Hung * on configuration must be larger than the speed multiplied by the minimum size 1363263b4c97823295c41900210515d0c769a236190cAndy Hung * {@link #getMinBufferSize(int, int, int)}) to allow proper playback. 13642d61e2b97c92ac2de80ebb3782b728ae5cdf5306Wei Jia * @param params see {@link PlaybackParams}. In particular, 1365263b4c97823295c41900210515d0c769a236190cAndy Hung * speed, pitch, and audio mode should be set. 13665f68c7a3f8400bcef233bf02d9a722f6d21f5c34Glenn Kasten * @throws IllegalArgumentException if the parameters are invalid or not accepted. 1367263b4c97823295c41900210515d0c769a236190cAndy Hung * @throws IllegalStateException if track is not initialized. 1368263b4c97823295c41900210515d0c769a236190cAndy Hung */ 13692d61e2b97c92ac2de80ebb3782b728ae5cdf5306Wei Jia public void setPlaybackParams(@NonNull PlaybackParams params) { 13702d61e2b97c92ac2de80ebb3782b728ae5cdf5306Wei Jia if (params == null) { 13712d61e2b97c92ac2de80ebb3782b728ae5cdf5306Wei Jia throw new IllegalArgumentException("params is null"); 1372263b4c97823295c41900210515d0c769a236190cAndy Hung } 13732d61e2b97c92ac2de80ebb3782b728ae5cdf5306Wei Jia native_set_playback_params(params); 1374263b4c97823295c41900210515d0c769a236190cAndy Hung } 1375263b4c97823295c41900210515d0c769a236190cAndy Hung 1376263b4c97823295c41900210515d0c769a236190cAndy Hung 1377263b4c97823295c41900210515d0c769a236190cAndy Hung /** 1378e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * Sets the position of the notification marker. At most one marker can be active. 1379e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * @param markerInFrames marker position in wrapping frame units similar to 1380e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * {@link #getPlaybackHeadPosition}, or zero to disable the marker. 1381e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * To set a marker at a position which would appear as zero due to wraparound, 1382e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * a workaround is to use a non-zero position near zero, such as -1 or 1. 13839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return error code or success, see {@link #SUCCESS}, {@link #ERROR_BAD_VALUE}, 13849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #ERROR_INVALID_OPERATION} 13859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 13869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int setNotificationMarkerPosition(int markerInFrames) { 13873b4df62704a6184878afd9272830cf3db7bd2d66Glenn Kasten if (mState == STATE_UNINITIALIZED) { 13889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return ERROR_INVALID_OPERATION; 13899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return native_set_marker_pos(markerInFrames); 13919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1395ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * Sets the period for the periodic notification event. 1396ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * @param periodInFrames update period expressed in frames. 1397ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * Zero period means no position updates. A negative period is not allowed. 13989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return error code or success, see {@link #SUCCESS}, {@link #ERROR_INVALID_OPERATION} 13999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 14009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int setPositionNotificationPeriod(int periodInFrames) { 14013b4df62704a6184878afd9272830cf3db7bd2d66Glenn Kasten if (mState == STATE_UNINITIALIZED) { 14029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return ERROR_INVALID_OPERATION; 14039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return native_set_pos_update_period(periodInFrames); 14059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1409ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * Sets the playback head position within the static buffer. 1410a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten * The track must be stopped or paused for the position to be changed, 1411a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten * and must use the {@link #MODE_STATIC} mode. 1412ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * @param positionInFrames playback head position within buffer, expressed in frames. 1413e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * Zero corresponds to start of buffer. 1414e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * The position must not be greater than the buffer size in frames, or negative. 1415ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * Though this method and {@link #getPlaybackHeadPosition()} have similar names, 1416ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * the position values have different meanings. 1417ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * <br> 1418ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * If looping is currently enabled and the new position is greater than or equal to the 141935e576e79292122fad462ebccd8520822552a6d7Andy Hung * loop end marker, the behavior varies by API level: 142035e576e79292122fad462ebccd8520822552a6d7Andy Hung * as of {@link android.os.Build.VERSION_CODES#MNC}, 1421ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * the looping is first disabled and then the position is set. 1422ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * For earlier API levels, the behavior is unspecified. 14239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return error code or success, see {@link #SUCCESS}, {@link #ERROR_BAD_VALUE}, 14249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #ERROR_INVALID_OPERATION} 14259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 14269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int setPlaybackHeadPosition(int positionInFrames) { 142778bfa6322bf34e49d5e4426296c701a64f705e49Andy Hung if (mDataLoadMode == MODE_STREAM || mState == STATE_UNINITIALIZED || 1428a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten getPlayState() == PLAYSTATE_PLAYING) { 1429a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten return ERROR_INVALID_OPERATION; 14309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1431e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten if (!(0 <= positionInFrames && positionInFrames <= mNativeBufferSizeInFrames)) { 1432e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten return ERROR_BAD_VALUE; 1433e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten } 1434a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten return native_set_position(positionInFrames); 14359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 14389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets the loop points and the loop count. The loop can be infinite. 1439a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten * Similarly to setPlaybackHeadPosition, 1440e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * the track must be stopped or paused for the loop points to be changed, 1441a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten * and must use the {@link #MODE_STATIC} mode. 1442ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * @param startInFrames loop start marker expressed in frames. 1443e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * Zero corresponds to start of buffer. 1444e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * The start marker must not be greater than or equal to the buffer size in frames, or negative. 1445ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * @param endInFrames loop end marker expressed in frames. 1446e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * The total buffer size in frames corresponds to end of buffer. 1447e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * The end marker must not be greater than the buffer size in frames. 1448e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * For looping, the end marker must not be less than or equal to the start marker, 1449e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * but to disable looping 1450e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * it is permitted for start marker, end marker, and loop count to all be 0. 1451ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * If any input parameters are out of range, this method returns {@link #ERROR_BAD_VALUE}. 1452ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * If the loop period (endInFrames - startInFrames) is too small for the implementation to 1453ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * support, 1454ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * {@link #ERROR_BAD_VALUE} is returned. 1455ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * The loop range is the interval [startInFrames, endInFrames). 1456ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * <br> 145735e576e79292122fad462ebccd8520822552a6d7Andy Hung * As of {@link android.os.Build.VERSION_CODES#MNC}, the position is left unchanged, 1458ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * unless it is greater than or equal to the loop end marker, in which case 1459ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * it is forced to the loop start marker. 1460ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * For earlier API levels, the effect on position is unspecified. 1461ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * @param loopCount the number of times the loop is looped; must be greater than or equal to -1. 1462e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * A value of -1 means infinite looping, and 0 disables looping. 1463ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * A value of positive N means to "loop" (go back) N times. For example, 1464ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * a value of one means to play the region two times in total. 14659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return error code or success, see {@link #SUCCESS}, {@link #ERROR_BAD_VALUE}, 14669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #ERROR_INVALID_OPERATION} 14679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 14689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int setLoopPoints(int startInFrames, int endInFrames, int loopCount) { 146978bfa6322bf34e49d5e4426296c701a64f705e49Andy Hung if (mDataLoadMode == MODE_STREAM || mState == STATE_UNINITIALIZED || 1470a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten getPlayState() == PLAYSTATE_PLAYING) { 14719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return ERROR_INVALID_OPERATION; 14729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1473e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten if (loopCount == 0) { 1474e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten ; // explicitly allowed as an exception to the loop region range check 1475e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten } else if (!(0 <= startInFrames && startInFrames < mNativeBufferSizeInFrames && 1476e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten startInFrames < endInFrames && endInFrames <= mNativeBufferSizeInFrames)) { 1477e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten return ERROR_BAD_VALUE; 1478e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten } 14799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return native_set_loop(startInFrames, endInFrames, loopCount); 14809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 148355a3218f242a611afb3569d88970c0c5dbf8ce54Glenn Kasten * Sets the initialization state of the instance. This method was originally intended to be used 148455a3218f242a611afb3569d88970c0c5dbf8ce54Glenn Kasten * in an AudioTrack subclass constructor to set a subclass-specific post-initialization state. 148555a3218f242a611afb3569d88970c0c5dbf8ce54Glenn Kasten * However, subclasses of AudioTrack are no longer recommended, so this method is obsolete. 14869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param state the state of the AudioTrack instance 148755a3218f242a611afb3569d88970c0c5dbf8ce54Glenn Kasten * @deprecated Only accessible by subclasses, which are not recommended for AudioTrack. 14889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 148955a3218f242a611afb3569d88970c0c5dbf8ce54Glenn Kasten @Deprecated 14909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project protected void setState(int state) { 14919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mState = state; 14929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //--------------------------------------------------------- 14969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Transport control methods 14979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //-------------------- 14989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 14999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Starts playing an AudioTrack. 1500659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * <p> 1501ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * If track's creation mode is {@link #MODE_STATIC}, you must have called one of 1502659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * the write methods ({@link #write(byte[], int, int)}, {@link #write(byte[], int, int, int)}, 1503659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * {@link #write(short[], int, int)}, {@link #write(short[], int, int, int)}, 1504659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * {@link #write(float[], int, int, int)}, or {@link #write(ByteBuffer, int, int)}) prior to 1505659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * play(). 1506659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * <p> 1507659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * If the mode is {@link #MODE_STREAM}, you can optionally prime the data path prior to 1508659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * calling play(), by writing up to <code>bufferSizeInBytes</code> (from constructor). 1509e90a0a88f4eabdc27c3ef033f38c91ea23362a1eAndy Hung * If you don't call write() first, or if you call write() but with an insufficient amount of 1510659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * data, then the track will be in underrun state at play(). In this case, 1511659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * playback will not actually start playing until the data path is filled to a 1512659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * device-specific minimum level. This requirement for the path to be filled 1513659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * to a minimum level is also true when resuming audio playback after calling stop(). 1514659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * Similarly the buffer will need to be filled up again after 1515659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * the track underruns due to failure to call write() in a timely manner with sufficient data. 1516659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * For portability, an application should prime the data path to the maximum allowed 1517659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * by writing data until the write() method returns a short transfer count. 1518659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * This allows play() to start immediately, and reduces the chance of underrun. 151988bde0ce3799c47530ea42ae3665bfa12ae38d11Narayan Kamath * 1520659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * @throws IllegalStateException if the track isn't properly initialized 15219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 15229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void play() 15239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throws IllegalStateException { 15249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mState != STATE_INITIALIZED) { 1525f4e58051e22ad4e21c7cd436c37cc5665c194d1cGlenn Kasten throw new IllegalStateException("play() called on uninitialized AudioTrack."); 15269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15271af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlock if (isRestricted()) { 15281af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlock setVolume(0); 15291af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlock } 15309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project synchronized(mPlayStateLock) { 15319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project native_start(); 15329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mPlayState = PLAYSTATE_PLAYING; 15339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 15361af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlock private boolean isRestricted() { 1537d3969546a8bc4efe1e5e8a72bee07105055d18c2Jean-Michel Trivi if ((mAttributes.getAllFlags() & AudioAttributes.FLAG_BYPASS_INTERRUPTION_POLICY) != 0) { 1538bbfd31a5d4f126167e20fa8bd256c810cf8c2c85John Spurlock return false; 1539bbfd31a5d4f126167e20fa8bd256c810cf8c2c85John Spurlock } 15401af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlock try { 15417b41467704f941b11af6aace3e40993afc7f6c6fJohn Spurlock final int usage = AudioAttributes.usageForLegacyStreamType(mStreamType); 15427b41467704f941b11af6aace3e40993afc7f6c6fJohn Spurlock final int mode = mAppOps.checkAudioOperation(AppOpsManager.OP_PLAY_AUDIO, usage, 15431af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlock Process.myUid(), ActivityThread.currentPackageName()); 15441af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlock return mode != AppOpsManager.MODE_ALLOWED; 15451af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlock } catch (RemoteException e) { 15461af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlock return false; 15471af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlock } 15481af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlock } 15491af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlock 15509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 15519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Stops playing the audio data. 1552a701da8ebabb3d63ac57b7718055698abb21804aJean-Michel Trivi * When used on an instance created in {@link #MODE_STREAM} mode, audio will stop playing 1553a701da8ebabb3d63ac57b7718055698abb21804aJean-Michel Trivi * after the last buffer that was written has been played. For an immediate stop, use 1554a701da8ebabb3d63ac57b7718055698abb21804aJean-Michel Trivi * {@link #pause()}, followed by {@link #flush()} to discard audio data that hasn't been played 1555a701da8ebabb3d63ac57b7718055698abb21804aJean-Michel Trivi * back yet. 15569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws IllegalStateException 15579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 15589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void stop() 15599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throws IllegalStateException { 15609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mState != STATE_INITIALIZED) { 1561f4e58051e22ad4e21c7cd436c37cc5665c194d1cGlenn Kasten throw new IllegalStateException("stop() called on uninitialized AudioTrack."); 15629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 15649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // stop playing 15659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project synchronized(mPlayStateLock) { 15669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project native_stop(); 15679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mPlayState = PLAYSTATE_STOPPED; 1568cfe964a09ca05778e5dd84f2fd24119b89401696Rachad mAvSyncHeader = null; 1569cfe964a09ca05778e5dd84f2fd24119b89401696Rachad mAvSyncBytesRemaining = 0; 15709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 15739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 157488bde0ce3799c47530ea42ae3665bfa12ae38d11Narayan Kamath * Pauses the playback of the audio data. Data that has not been played 157588bde0ce3799c47530ea42ae3665bfa12ae38d11Narayan Kamath * back will not be discarded. Subsequent calls to {@link #play} will play 1576a701da8ebabb3d63ac57b7718055698abb21804aJean-Michel Trivi * this data back. See {@link #flush()} to discard this data. 157788bde0ce3799c47530ea42ae3665bfa12ae38d11Narayan Kamath * 15789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws IllegalStateException 15799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 15809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void pause() 15819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throws IllegalStateException { 15829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mState != STATE_INITIALIZED) { 1583f4e58051e22ad4e21c7cd436c37cc5665c194d1cGlenn Kasten throw new IllegalStateException("pause() called on uninitialized AudioTrack."); 15849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //logd("pause()"); 15869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 15879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // pause playback 15889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project synchronized(mPlayStateLock) { 15899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project native_pause(); 15909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mPlayState = PLAYSTATE_PAUSED; 15919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 15949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 15959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //--------------------------------------------------------- 15969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Audio data supply 15979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //-------------------- 15989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 15999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 160088bde0ce3799c47530ea42ae3665bfa12ae38d11Narayan Kamath * Flushes the audio data currently queued for playback. Any data that has 16017a121563d5c94ca0b88539afd8a7e86cc9118b60Glenn Kasten * been written but not yet presented will be discarded. No-op if not stopped or paused, 1602e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * or if the track's creation mode is not {@link #MODE_STREAM}. 16037a121563d5c94ca0b88539afd8a7e86cc9118b60Glenn Kasten * <BR> Note that although data written but not yet presented is discarded, there is no 16047a121563d5c94ca0b88539afd8a7e86cc9118b60Glenn Kasten * guarantee that all of the buffer space formerly used by that data 16057a121563d5c94ca0b88539afd8a7e86cc9118b60Glenn Kasten * is available for a subsequent write. 16067a121563d5c94ca0b88539afd8a7e86cc9118b60Glenn Kasten * For example, a call to {@link #write(byte[], int, int)} with <code>sizeInBytes</code> 16077a121563d5c94ca0b88539afd8a7e86cc9118b60Glenn Kasten * less than or equal to the total buffer size 16087a121563d5c94ca0b88539afd8a7e86cc9118b60Glenn Kasten * may return a short actual transfer count. 16099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 16109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void flush() { 16119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mState == STATE_INITIALIZED) { 16129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // flush the data in native layer 16139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project native_flush(); 1614cfe964a09ca05778e5dd84f2fd24119b89401696Rachad mAvSyncHeader = null; 1615cfe964a09ca05778e5dd84f2fd24119b89401696Rachad mAvSyncBytesRemaining = 0; 16169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 16179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 16189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 16199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 16209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1621e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * Writes the audio data to the audio sink for playback (streaming mode), 1622e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * or copies audio data for later playback (static buffer mode). 16234aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung * The format specified in the AudioTrack constructor should be 16244aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung * {@link AudioFormat#ENCODING_PCM_8BIT} to correspond to the data in the array. 1625659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * <p> 1626659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * In streaming mode, the write will normally block until all the data has been enqueued for 1627659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * playback, and will return a full transfer count. However, if the track is stopped or paused 1628659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * on entry, or another thread interrupts the write by calling stop or pause, or an I/O error 1629659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * occurs during the write, then the write may return a short transfer count. 1630659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * <p> 1631e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * In static buffer mode, copies the data to the buffer starting at offset 0. 1632659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * Note that the actual playback of this data might occur after this function returns. 163388bde0ce3799c47530ea42ae3665bfa12ae38d11Narayan Kamath * 16349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param audioData the array that holds the data to play. 163588bde0ce3799c47530ea42ae3665bfa12ae38d11Narayan Kamath * @param offsetInBytes the offset expressed in bytes in audioData where the data to play 1636ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * starts. 16379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param sizeInBytes the number of bytes to read in audioData after the offset. 1638659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * @return zero or the positive number of bytes that were written, or 1639659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * {@link #ERROR_INVALID_OPERATION} 1640659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * if the track isn't properly initialized, or {@link #ERROR_BAD_VALUE} if 1641ff0d9f098e51c54e1a030ed21fd980680cb7b405Eric Laurent * the parameters don't resolve to valid data and indexes, or 1642ff0d9f098e51c54e1a030ed21fd980680cb7b405Eric Laurent * {@link AudioManager#ERROR_DEAD_OBJECT} if the AudioTrack is not valid anymore and 1643ff0d9f098e51c54e1a030ed21fd980680cb7b405Eric Laurent * needs to be recreated. 1644659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * The dead object error code is not returned if some data was successfully transferred. 1645659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * In this case, the error is returned at the next write(). 1646659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * 1647659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * This is equivalent to {@link #write(byte[], int, int, int)} with <code>writeMode</code> 1648659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * set to {@link #WRITE_BLOCKING}. 16499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 16504aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung public int write(@NonNull byte[] audioData, int offsetInBytes, int sizeInBytes) { 16514aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung return write(audioData, offsetInBytes, sizeInBytes, WRITE_BLOCKING); 16524aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung } 16539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 16544aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung /** 16554aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung * Writes the audio data to the audio sink for playback (streaming mode), 16564aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung * or copies audio data for later playback (static buffer mode). 16574aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung * The format specified in the AudioTrack constructor should be 16584aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung * {@link AudioFormat#ENCODING_PCM_8BIT} to correspond to the data in the array. 1659659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * <p> 1660659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * In streaming mode, the blocking behavior depends on the write mode. If the write mode is 1661659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * {@link #WRITE_BLOCKING}, the write will normally block until all the data has been enqueued 1662659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * for playback, and will return a full transfer count. However, if the write mode is 1663659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * {@link #WRITE_NON_BLOCKING}, or the track is stopped or paused on entry, or another thread 1664659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * interrupts the write by calling stop or pause, or an I/O error 1665659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * occurs during the write, then the write may return a short transfer count. 1666659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * <p> 1667659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * In static buffer mode, copies the data to the buffer starting at offset 0, 1668659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * and the write mode is ignored. 1669659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * Note that the actual playback of this data might occur after this function returns. 16704aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung * 16714aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung * @param audioData the array that holds the data to play. 16724aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung * @param offsetInBytes the offset expressed in bytes in audioData where the data to play 16734aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung * starts. 16744aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung * @param sizeInBytes the number of bytes to read in audioData after the offset. 16754aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung * @param writeMode one of {@link #WRITE_BLOCKING}, {@link #WRITE_NON_BLOCKING}. It has no 16764aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung * effect in static mode. 16774aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung * <br>With {@link #WRITE_BLOCKING}, the write will block until all data has been written 16784aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung * to the audio sink. 16794aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung * <br>With {@link #WRITE_NON_BLOCKING}, the write will return immediately after 16804aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung * queuing as much audio data for playback as possible without blocking. 1681659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * @return zero or the positive number of bytes that were written, or 1682659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * {@link #ERROR_INVALID_OPERATION} 1683659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * if the track isn't properly initialized, or {@link #ERROR_BAD_VALUE} if 16844aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung * the parameters don't resolve to valid data and indexes, or 16854aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung * {@link AudioManager#ERROR_DEAD_OBJECT} if the AudioTrack is not valid anymore and 16864aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung * needs to be recreated. 1687659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * The dead object error code is not returned if some data was successfully transferred. 1688659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * In this case, the error is returned at the next write(). 16894aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung */ 16904aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung public int write(@NonNull byte[] audioData, int offsetInBytes, int sizeInBytes, 16914aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung @WriteMode int writeMode) { 16929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 169354955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten if (mState == STATE_UNINITIALIZED || mAudioFormat == AudioFormat.ENCODING_PCM_FLOAT) { 16949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return ERROR_INVALID_OPERATION; 16959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 16969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 16974aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung if ((writeMode != WRITE_BLOCKING) && (writeMode != WRITE_NON_BLOCKING)) { 16984aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung Log.e(TAG, "AudioTrack.write() called with invalid blocking mode"); 16994aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung return ERROR_BAD_VALUE; 17004aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung } 17014aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung 1702fb2ab9efc3805c81521afb9ff91a58ff5097a36eGlenn Kasten if ( (audioData == null) || (offsetInBytes < 0 ) || (sizeInBytes < 0) 1703a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten || (offsetInBytes + sizeInBytes < 0) // detect integer overflow 17049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project || (offsetInBytes + sizeInBytes > audioData.length)) { 17059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return ERROR_BAD_VALUE; 17069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 17079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 17087ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi int ret = native_write_byte(audioData, offsetInBytes, sizeInBytes, mAudioFormat, 17094aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung writeMode == WRITE_BLOCKING); 1710a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten 1711a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten if ((mDataLoadMode == MODE_STATIC) 1712a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten && (mState == STATE_NO_STATIC_DATA) 1713a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten && (ret > 0)) { 1714a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten // benign race with respect to other APIs that read mState 1715a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten mState = STATE_INITIALIZED; 1716a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten } 1717a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten 1718a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten return ret; 17199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 17209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 17219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1722e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * Writes the audio data to the audio sink for playback (streaming mode), 1723e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * or copies audio data for later playback (static buffer mode). 17244aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung * The format specified in the AudioTrack constructor should be 17254aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung * {@link AudioFormat#ENCODING_PCM_16BIT} to correspond to the data in the array. 1726659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * <p> 1727659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * In streaming mode, the write will normally block until all the data has been enqueued for 1728659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * playback, and will return a full transfer count. However, if the track is stopped or paused 1729659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * on entry, or another thread interrupts the write by calling stop or pause, or an I/O error 1730659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * occurs during the write, then the write may return a short transfer count. 1731659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * <p> 1732e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * In static buffer mode, copies the data to the buffer starting at offset 0. 1733659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * Note that the actual playback of this data might occur after this function returns. 173488bde0ce3799c47530ea42ae3665bfa12ae38d11Narayan Kamath * 17359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param audioData the array that holds the data to play. 1736ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * @param offsetInShorts the offset expressed in shorts in audioData where the data to play 1737ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * starts. 1738e8c82a37050e568f211d47951480b182a61d42b4Glenn Kasten * @param sizeInShorts the number of shorts to read in audioData after the offset. 1739659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * @return zero or the positive number of shorts that were written, or 1740659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * {@link #ERROR_INVALID_OPERATION} 1741659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * if the track isn't properly initialized, or {@link #ERROR_BAD_VALUE} if 1742136e006248e6416ee30d7af2e6de102d195b8fb6Jean-Michel Trivi * the parameters don't resolve to valid data and indexes, or 1743136e006248e6416ee30d7af2e6de102d195b8fb6Jean-Michel Trivi * {@link AudioManager#ERROR_DEAD_OBJECT} if the AudioTrack is not valid anymore and 1744136e006248e6416ee30d7af2e6de102d195b8fb6Jean-Michel Trivi * needs to be recreated. 1745659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * The dead object error code is not returned if some data was successfully transferred. 1746659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * In this case, the error is returned at the next write(). 1747659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * 1748659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * This is equivalent to {@link #write(short[], int, int, int)} with <code>writeMode</code> 1749659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * set to {@link #WRITE_BLOCKING}. 17509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 17514aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung public int write(@NonNull short[] audioData, int offsetInShorts, int sizeInShorts) { 17524aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung return write(audioData, offsetInShorts, sizeInShorts, WRITE_BLOCKING); 17534aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung } 17549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 17554aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung /** 17564aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung * Writes the audio data to the audio sink for playback (streaming mode), 17574aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung * or copies audio data for later playback (static buffer mode). 17584aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung * The format specified in the AudioTrack constructor should be 17594aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung * {@link AudioFormat#ENCODING_PCM_16BIT} to correspond to the data in the array. 1760659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * <p> 1761659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * In streaming mode, the blocking behavior depends on the write mode. If the write mode is 1762659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * {@link #WRITE_BLOCKING}, the write will normally block until all the data has been enqueued 1763659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * for playback, and will return a full transfer count. However, if the write mode is 1764659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * {@link #WRITE_NON_BLOCKING}, or the track is stopped or paused on entry, or another thread 1765659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * interrupts the write by calling stop or pause, or an I/O error 1766659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * occurs during the write, then the write may return a short transfer count. 1767659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * <p> 17684aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung * In static buffer mode, copies the data to the buffer starting at offset 0. 1769659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * Note that the actual playback of this data might occur after this function returns. 17704aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung * 17714aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung * @param audioData the array that holds the data to play. 17724aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung * @param offsetInShorts the offset expressed in shorts in audioData where the data to play 17734aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung * starts. 17744aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung * @param sizeInShorts the number of shorts to read in audioData after the offset. 17754aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung * @param writeMode one of {@link #WRITE_BLOCKING}, {@link #WRITE_NON_BLOCKING}. It has no 17764aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung * effect in static mode. 17774aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung * <br>With {@link #WRITE_BLOCKING}, the write will block until all data has been written 17784aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung * to the audio sink. 17794aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung * <br>With {@link #WRITE_NON_BLOCKING}, the write will return immediately after 17804aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung * queuing as much audio data for playback as possible without blocking. 1781659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * @return zero or the positive number of shorts that were written, or 1782659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * {@link #ERROR_INVALID_OPERATION} 1783659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * if the track isn't properly initialized, or {@link #ERROR_BAD_VALUE} if 17844aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung * the parameters don't resolve to valid data and indexes, or 17854aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung * {@link AudioManager#ERROR_DEAD_OBJECT} if the AudioTrack is not valid anymore and 17864aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung * needs to be recreated. 1787659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * The dead object error code is not returned if some data was successfully transferred. 1788659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * In this case, the error is returned at the next write(). 17894aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung */ 17904aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung public int write(@NonNull short[] audioData, int offsetInShorts, int sizeInShorts, 17914aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung @WriteMode int writeMode) { 1792fb2ab9efc3805c81521afb9ff91a58ff5097a36eGlenn Kasten 1793c56b8085919771b6f027dc64ed6a44915e392464Glenn Kasten if (mState == STATE_UNINITIALIZED || mAudioFormat == AudioFormat.ENCODING_PCM_FLOAT) { 17949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return ERROR_INVALID_OPERATION; 17959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 17969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 17974aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung if ((writeMode != WRITE_BLOCKING) && (writeMode != WRITE_NON_BLOCKING)) { 17984aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung Log.e(TAG, "AudioTrack.write() called with invalid blocking mode"); 17994aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung return ERROR_BAD_VALUE; 18004aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung } 18014aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung 1802fb2ab9efc3805c81521afb9ff91a58ff5097a36eGlenn Kasten if ( (audioData == null) || (offsetInShorts < 0 ) || (sizeInShorts < 0) 1803a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten || (offsetInShorts + sizeInShorts < 0) // detect integer overflow 18049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project || (offsetInShorts + sizeInShorts > audioData.length)) { 18059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return ERROR_BAD_VALUE; 18069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 18079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 18084aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung int ret = native_write_short(audioData, offsetInShorts, sizeInShorts, mAudioFormat, 18094aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung writeMode == WRITE_BLOCKING); 1810a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten 1811a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten if ((mDataLoadMode == MODE_STATIC) 1812a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten && (mState == STATE_NO_STATIC_DATA) 1813a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten && (ret > 0)) { 1814a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten // benign race with respect to other APIs that read mState 1815a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten mState = STATE_INITIALIZED; 1816a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten } 1817a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten 1818a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten return ret; 18199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 18209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 18219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 18227ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi * Writes the audio data to the audio sink for playback (streaming mode), 18237ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi * or copies audio data for later playback (static buffer mode). 18244aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung * The format specified in the AudioTrack constructor should be 18254aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung * {@link AudioFormat#ENCODING_PCM_FLOAT} to correspond to the data in the array. 182654955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten * <p> 1827659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * In streaming mode, the blocking behavior depends on the write mode. If the write mode is 1828659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * {@link #WRITE_BLOCKING}, the write will normally block until all the data has been enqueued 1829659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * for playback, and will return a full transfer count. However, if the write mode is 1830659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * {@link #WRITE_NON_BLOCKING}, or the track is stopped or paused on entry, or another thread 1831659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * interrupts the write by calling stop or pause, or an I/O error 1832659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * occurs during the write, then the write may return a short transfer count. 183354955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten * <p> 1834659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * In static buffer mode, copies the data to the buffer starting at offset 0, 1835659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * and the write mode is ignored. 1836659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * Note that the actual playback of this data might occur after this function returns. 1837659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * 183854955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten * @param audioData the array that holds the data to play. 183954955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten * The implementation does not clip for sample values within the nominal range 184054955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten * [-1.0f, 1.0f], provided that all gains in the audio pipeline are 184154955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten * less than or equal to unity (1.0f), and in the absence of post-processing effects 184254955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten * that could add energy, such as reverb. For the convenience of applications 184354955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten * that compute samples using filters with non-unity gain, 184454955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten * sample values +3 dB beyond the nominal range are permitted. 184554955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten * However such values may eventually be limited or clipped, depending on various gains 184654955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten * and later processing in the audio path. Therefore applications are encouraged 184754955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten * to provide samples values within the nominal range. 184854955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten * @param offsetInFloats the offset, expressed as a number of floats, 184954955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten * in audioData where the data to play starts. 185054955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten * @param sizeInFloats the number of floats to read in audioData after the offset. 185154955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten * @param writeMode one of {@link #WRITE_BLOCKING}, {@link #WRITE_NON_BLOCKING}. It has no 185254955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten * effect in static mode. 18534aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung * <br>With {@link #WRITE_BLOCKING}, the write will block until all data has been written 185454955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten * to the audio sink. 18554aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung * <br>With {@link #WRITE_NON_BLOCKING}, the write will return immediately after 185654955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten * queuing as much audio data for playback as possible without blocking. 1857659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * @return zero or the positive number of floats that were written, or 1858659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * {@link #ERROR_INVALID_OPERATION} 1859659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * if the track isn't properly initialized, or {@link #ERROR_BAD_VALUE} if 1860136e006248e6416ee30d7af2e6de102d195b8fb6Jean-Michel Trivi * the parameters don't resolve to valid data and indexes, or 1861136e006248e6416ee30d7af2e6de102d195b8fb6Jean-Michel Trivi * {@link AudioManager#ERROR_DEAD_OBJECT} if the AudioTrack is not valid anymore and 1862136e006248e6416ee30d7af2e6de102d195b8fb6Jean-Michel Trivi * needs to be recreated. 1863659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * The dead object error code is not returned if some data was successfully transferred. 1864659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * In this case, the error is returned at the next write(). 186554955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten */ 18664aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung public int write(@NonNull float[] audioData, int offsetInFloats, int sizeInFloats, 186754955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten @WriteMode int writeMode) { 186854955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten 186954955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten if (mState == STATE_UNINITIALIZED) { 187054955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten Log.e(TAG, "AudioTrack.write() called in invalid state STATE_UNINITIALIZED"); 187154955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten return ERROR_INVALID_OPERATION; 187254955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten } 187354955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten 187454955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten if (mAudioFormat != AudioFormat.ENCODING_PCM_FLOAT) { 187554955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten Log.e(TAG, "AudioTrack.write(float[] ...) requires format ENCODING_PCM_FLOAT"); 187654955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten return ERROR_INVALID_OPERATION; 187754955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten } 187854955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten 187954955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten if ((writeMode != WRITE_BLOCKING) && (writeMode != WRITE_NON_BLOCKING)) { 188054955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten Log.e(TAG, "AudioTrack.write() called with invalid blocking mode"); 188154955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten return ERROR_BAD_VALUE; 188254955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten } 188354955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten 188454955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten if ( (audioData == null) || (offsetInFloats < 0 ) || (sizeInFloats < 0) 188554955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten || (offsetInFloats + sizeInFloats < 0) // detect integer overflow 188654955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten || (offsetInFloats + sizeInFloats > audioData.length)) { 188754955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten Log.e(TAG, "AudioTrack.write() called with invalid array, offset, or size"); 188854955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten return ERROR_BAD_VALUE; 188954955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten } 189054955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten 189154955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten int ret = native_write_float(audioData, offsetInFloats, sizeInFloats, mAudioFormat, 189254955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten writeMode == WRITE_BLOCKING); 189354955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten 189454955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten if ((mDataLoadMode == MODE_STATIC) 189554955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten && (mState == STATE_NO_STATIC_DATA) 189654955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten && (ret > 0)) { 189754955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten // benign race with respect to other APIs that read mState 189854955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten mState = STATE_INITIALIZED; 189954955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten } 190054955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten 190154955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten return ret; 190254955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten } 190354955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten 190454955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten 190554955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten /** 190654955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten * Writes the audio data to the audio sink for playback (streaming mode), 190754955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten * or copies audio data for later playback (static buffer mode). 1908659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * The audioData in ByteBuffer should match the format specified in the AudioTrack constructor. 1909659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * <p> 1910659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * In streaming mode, the blocking behavior depends on the write mode. If the write mode is 1911659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * {@link #WRITE_BLOCKING}, the write will normally block until all the data has been enqueued 1912659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * for playback, and will return a full transfer count. However, if the write mode is 1913659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * {@link #WRITE_NON_BLOCKING}, or the track is stopped or paused on entry, or another thread 1914659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * interrupts the write by calling stop or pause, or an I/O error 1915659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * occurs during the write, then the write may return a short transfer count. 1916659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * <p> 1917659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * In static buffer mode, copies the data to the buffer starting at offset 0, 1918659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * and the write mode is ignored. 1919659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * Note that the actual playback of this data might occur after this function returns. 1920659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * 19217ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi * @param audioData the buffer that holds the data to play, starting at the position reported 19227ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi * by <code>audioData.position()</code>. 19235d21f679c58dbb13c8c931ffec6e06b6b8cd454fJean-Michel Trivi * <BR>Note that upon return, the buffer position (<code>audioData.position()</code>) will 19245d21f679c58dbb13c8c931ffec6e06b6b8cd454fJean-Michel Trivi * have been advanced to reflect the amount of data that was successfully written to 19255d21f679c58dbb13c8c931ffec6e06b6b8cd454fJean-Michel Trivi * the AudioTrack. 19265d21f679c58dbb13c8c931ffec6e06b6b8cd454fJean-Michel Trivi * @param sizeInBytes number of bytes to write. 19275d21f679c58dbb13c8c931ffec6e06b6b8cd454fJean-Michel Trivi * <BR>Note this may differ from <code>audioData.remaining()</code>, but cannot exceed it. 19287ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi * @param writeMode one of {@link #WRITE_BLOCKING}, {@link #WRITE_NON_BLOCKING}. It has no 19297ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi * effect in static mode. 19307ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi * <BR>With {@link #WRITE_BLOCKING}, the write will block until all data has been written 19317ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi * to the audio sink. 19327ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi * <BR>With {@link #WRITE_NON_BLOCKING}, the write will return immediately after 19337ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi * queuing as much audio data for playback as possible without blocking. 1934659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * @return zero or the positive number of bytes that were written, or 1935136e006248e6416ee30d7af2e6de102d195b8fb6Jean-Michel Trivi * {@link #ERROR_BAD_VALUE}, {@link #ERROR_INVALID_OPERATION}, or 1936136e006248e6416ee30d7af2e6de102d195b8fb6Jean-Michel Trivi * {@link AudioManager#ERROR_DEAD_OBJECT} if the AudioTrack is not valid anymore and 1937136e006248e6416ee30d7af2e6de102d195b8fb6Jean-Michel Trivi * needs to be recreated. 1938659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * The dead object error code is not returned if some data was successfully transferred. 1939659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * In this case, the error is returned at the next write(). 19407ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi */ 19414aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung public int write(@NonNull ByteBuffer audioData, int sizeInBytes, 19427ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi @WriteMode int writeMode) { 19437ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi 19447ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi if (mState == STATE_UNINITIALIZED) { 19457ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi Log.e(TAG, "AudioTrack.write() called in invalid state STATE_UNINITIALIZED"); 19467ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi return ERROR_INVALID_OPERATION; 19477ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi } 19487ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi 19497ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi if ((writeMode != WRITE_BLOCKING) && (writeMode != WRITE_NON_BLOCKING)) { 19507ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi Log.e(TAG, "AudioTrack.write() called with invalid blocking mode"); 19517ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi return ERROR_BAD_VALUE; 19527ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi } 19537ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi 19545d21f679c58dbb13c8c931ffec6e06b6b8cd454fJean-Michel Trivi if ( (audioData == null) || (sizeInBytes < 0) || (sizeInBytes > audioData.remaining())) { 19555d21f679c58dbb13c8c931ffec6e06b6b8cd454fJean-Michel Trivi Log.e(TAG, "AudioTrack.write() called with invalid size (" + sizeInBytes + ") value"); 19567ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi return ERROR_BAD_VALUE; 19577ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi } 19587ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi 19597ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi int ret = 0; 19607ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi if (audioData.isDirect()) { 19617ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi ret = native_write_native_bytes(audioData, 19625d21f679c58dbb13c8c931ffec6e06b6b8cd454fJean-Michel Trivi audioData.position(), sizeInBytes, mAudioFormat, 19637ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi writeMode == WRITE_BLOCKING); 19647ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi } else { 19657ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi ret = native_write_byte(NioUtils.unsafeArray(audioData), 19665d21f679c58dbb13c8c931ffec6e06b6b8cd454fJean-Michel Trivi NioUtils.unsafeArrayOffset(audioData) + audioData.position(), 19677ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi sizeInBytes, mAudioFormat, 19687ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi writeMode == WRITE_BLOCKING); 19697ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi } 19707ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi 19717ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi if ((mDataLoadMode == MODE_STATIC) 19727ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi && (mState == STATE_NO_STATIC_DATA) 19737ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi && (ret > 0)) { 19747ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi // benign race with respect to other APIs that read mState 19757ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi mState = STATE_INITIALIZED; 19767ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi } 19777ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi 19785d21f679c58dbb13c8c931ffec6e06b6b8cd454fJean-Michel Trivi if (ret > 0) { 19795d21f679c58dbb13c8c931ffec6e06b6b8cd454fJean-Michel Trivi audioData.position(audioData.position() + ret); 19805d21f679c58dbb13c8c931ffec6e06b6b8cd454fJean-Michel Trivi } 19815d21f679c58dbb13c8c931ffec6e06b6b8cd454fJean-Michel Trivi 19827ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi return ret; 19837ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi } 19847ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi 19857ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi /** 1986659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * Writes the audio data to the audio sink for playback in streaming mode on a HW_AV_SYNC track. 1987659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * The blocking behavior will depend on the write mode. 1988cfe964a09ca05778e5dd84f2fd24119b89401696Rachad * @param audioData the buffer that holds the data to play, starting at the position reported 1989cfe964a09ca05778e5dd84f2fd24119b89401696Rachad * by <code>audioData.position()</code>. 1990cfe964a09ca05778e5dd84f2fd24119b89401696Rachad * <BR>Note that upon return, the buffer position (<code>audioData.position()</code>) will 1991cfe964a09ca05778e5dd84f2fd24119b89401696Rachad * have been advanced to reflect the amount of data that was successfully written to 1992cfe964a09ca05778e5dd84f2fd24119b89401696Rachad * the AudioTrack. 1993cfe964a09ca05778e5dd84f2fd24119b89401696Rachad * @param sizeInBytes number of bytes to write. 1994cfe964a09ca05778e5dd84f2fd24119b89401696Rachad * <BR>Note this may differ from <code>audioData.remaining()</code>, but cannot exceed it. 1995cfe964a09ca05778e5dd84f2fd24119b89401696Rachad * @param writeMode one of {@link #WRITE_BLOCKING}, {@link #WRITE_NON_BLOCKING}. 1996cfe964a09ca05778e5dd84f2fd24119b89401696Rachad * <BR>With {@link #WRITE_BLOCKING}, the write will block until all data has been written 1997cfe964a09ca05778e5dd84f2fd24119b89401696Rachad * to the audio sink. 1998cfe964a09ca05778e5dd84f2fd24119b89401696Rachad * <BR>With {@link #WRITE_NON_BLOCKING}, the write will return immediately after 1999cfe964a09ca05778e5dd84f2fd24119b89401696Rachad * queuing as much audio data for playback as possible without blocking. 2000cfe964a09ca05778e5dd84f2fd24119b89401696Rachad * @param timestamp The timestamp of the first decodable audio frame in the provided audioData. 2001659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * @return zero or a positive number of bytes that were written, or 2002cfe964a09ca05778e5dd84f2fd24119b89401696Rachad * {@link #ERROR_BAD_VALUE}, {@link #ERROR_INVALID_OPERATION}, or 2003cfe964a09ca05778e5dd84f2fd24119b89401696Rachad * {@link AudioManager#ERROR_DEAD_OBJECT} if the AudioTrack is not valid anymore and 2004cfe964a09ca05778e5dd84f2fd24119b89401696Rachad * needs to be recreated. 2005659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * The dead object error code is not returned if some data was successfully transferred. 2006659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * In this case, the error is returned at the next write(). 2007cfe964a09ca05778e5dd84f2fd24119b89401696Rachad */ 200868d5ebd1da6bd4744314749d4fdbaf216414ea94Glenn Kasten public int write(@NonNull ByteBuffer audioData, int sizeInBytes, 2009cfe964a09ca05778e5dd84f2fd24119b89401696Rachad @WriteMode int writeMode, long timestamp) { 2010cfe964a09ca05778e5dd84f2fd24119b89401696Rachad 201168d5ebd1da6bd4744314749d4fdbaf216414ea94Glenn Kasten if (mState == STATE_UNINITIALIZED) { 201268d5ebd1da6bd4744314749d4fdbaf216414ea94Glenn Kasten Log.e(TAG, "AudioTrack.write() called in invalid state STATE_UNINITIALIZED"); 201368d5ebd1da6bd4744314749d4fdbaf216414ea94Glenn Kasten return ERROR_INVALID_OPERATION; 201468d5ebd1da6bd4744314749d4fdbaf216414ea94Glenn Kasten } 201568d5ebd1da6bd4744314749d4fdbaf216414ea94Glenn Kasten 201668d5ebd1da6bd4744314749d4fdbaf216414ea94Glenn Kasten if ((writeMode != WRITE_BLOCKING) && (writeMode != WRITE_NON_BLOCKING)) { 201768d5ebd1da6bd4744314749d4fdbaf216414ea94Glenn Kasten Log.e(TAG, "AudioTrack.write() called with invalid blocking mode"); 201868d5ebd1da6bd4744314749d4fdbaf216414ea94Glenn Kasten return ERROR_BAD_VALUE; 201968d5ebd1da6bd4744314749d4fdbaf216414ea94Glenn Kasten } 202068d5ebd1da6bd4744314749d4fdbaf216414ea94Glenn Kasten 202168d5ebd1da6bd4744314749d4fdbaf216414ea94Glenn Kasten if (mDataLoadMode != MODE_STREAM) { 202268d5ebd1da6bd4744314749d4fdbaf216414ea94Glenn Kasten Log.e(TAG, "AudioTrack.write() with timestamp called for non-streaming mode track"); 202368d5ebd1da6bd4744314749d4fdbaf216414ea94Glenn Kasten return ERROR_INVALID_OPERATION; 202468d5ebd1da6bd4744314749d4fdbaf216414ea94Glenn Kasten } 202568d5ebd1da6bd4744314749d4fdbaf216414ea94Glenn Kasten 2026cfe964a09ca05778e5dd84f2fd24119b89401696Rachad if ((mAttributes.getFlags() & AudioAttributes.FLAG_HW_AV_SYNC) == 0) { 2027cfe964a09ca05778e5dd84f2fd24119b89401696Rachad Log.d(TAG, "AudioTrack.write() called on a regular AudioTrack. Ignoring pts..."); 2028cfe964a09ca05778e5dd84f2fd24119b89401696Rachad return write(audioData, sizeInBytes, writeMode); 2029cfe964a09ca05778e5dd84f2fd24119b89401696Rachad } 2030cfe964a09ca05778e5dd84f2fd24119b89401696Rachad 2031cfe964a09ca05778e5dd84f2fd24119b89401696Rachad if ((audioData == null) || (sizeInBytes < 0) || (sizeInBytes > audioData.remaining())) { 2032cfe964a09ca05778e5dd84f2fd24119b89401696Rachad Log.e(TAG, "AudioTrack.write() called with invalid size (" + sizeInBytes + ") value"); 2033cfe964a09ca05778e5dd84f2fd24119b89401696Rachad return ERROR_BAD_VALUE; 2034cfe964a09ca05778e5dd84f2fd24119b89401696Rachad } 2035cfe964a09ca05778e5dd84f2fd24119b89401696Rachad 2036cfe964a09ca05778e5dd84f2fd24119b89401696Rachad // create timestamp header if none exists 2037cfe964a09ca05778e5dd84f2fd24119b89401696Rachad if (mAvSyncHeader == null) { 2038cfe964a09ca05778e5dd84f2fd24119b89401696Rachad mAvSyncHeader = ByteBuffer.allocate(16); 2039cfe964a09ca05778e5dd84f2fd24119b89401696Rachad mAvSyncHeader.order(ByteOrder.BIG_ENDIAN); 2040cfe964a09ca05778e5dd84f2fd24119b89401696Rachad mAvSyncHeader.putInt(0x55550001); 2041cfe964a09ca05778e5dd84f2fd24119b89401696Rachad mAvSyncHeader.putInt(sizeInBytes); 2042cfe964a09ca05778e5dd84f2fd24119b89401696Rachad mAvSyncHeader.putLong(timestamp); 2043cfe964a09ca05778e5dd84f2fd24119b89401696Rachad mAvSyncHeader.position(0); 2044cfe964a09ca05778e5dd84f2fd24119b89401696Rachad mAvSyncBytesRemaining = sizeInBytes; 2045cfe964a09ca05778e5dd84f2fd24119b89401696Rachad } 2046cfe964a09ca05778e5dd84f2fd24119b89401696Rachad 2047cfe964a09ca05778e5dd84f2fd24119b89401696Rachad // write timestamp header if not completely written already 2048cfe964a09ca05778e5dd84f2fd24119b89401696Rachad int ret = 0; 2049cfe964a09ca05778e5dd84f2fd24119b89401696Rachad if (mAvSyncHeader.remaining() != 0) { 2050cfe964a09ca05778e5dd84f2fd24119b89401696Rachad ret = write(mAvSyncHeader, mAvSyncHeader.remaining(), writeMode); 2051cfe964a09ca05778e5dd84f2fd24119b89401696Rachad if (ret < 0) { 2052cfe964a09ca05778e5dd84f2fd24119b89401696Rachad Log.e(TAG, "AudioTrack.write() could not write timestamp header!"); 2053cfe964a09ca05778e5dd84f2fd24119b89401696Rachad mAvSyncHeader = null; 2054cfe964a09ca05778e5dd84f2fd24119b89401696Rachad mAvSyncBytesRemaining = 0; 2055cfe964a09ca05778e5dd84f2fd24119b89401696Rachad return ret; 2056cfe964a09ca05778e5dd84f2fd24119b89401696Rachad } 2057cfe964a09ca05778e5dd84f2fd24119b89401696Rachad if (mAvSyncHeader.remaining() > 0) { 2058cfe964a09ca05778e5dd84f2fd24119b89401696Rachad Log.v(TAG, "AudioTrack.write() partial timestamp header written."); 2059cfe964a09ca05778e5dd84f2fd24119b89401696Rachad return 0; 2060cfe964a09ca05778e5dd84f2fd24119b89401696Rachad } 2061cfe964a09ca05778e5dd84f2fd24119b89401696Rachad } 2062cfe964a09ca05778e5dd84f2fd24119b89401696Rachad 2063cfe964a09ca05778e5dd84f2fd24119b89401696Rachad // write audio data 2064cfe964a09ca05778e5dd84f2fd24119b89401696Rachad int sizeToWrite = Math.min(mAvSyncBytesRemaining, sizeInBytes); 2065cfe964a09ca05778e5dd84f2fd24119b89401696Rachad ret = write(audioData, sizeToWrite, writeMode); 2066cfe964a09ca05778e5dd84f2fd24119b89401696Rachad if (ret < 0) { 2067cfe964a09ca05778e5dd84f2fd24119b89401696Rachad Log.e(TAG, "AudioTrack.write() could not write audio data!"); 2068cfe964a09ca05778e5dd84f2fd24119b89401696Rachad mAvSyncHeader = null; 2069cfe964a09ca05778e5dd84f2fd24119b89401696Rachad mAvSyncBytesRemaining = 0; 2070cfe964a09ca05778e5dd84f2fd24119b89401696Rachad return ret; 2071cfe964a09ca05778e5dd84f2fd24119b89401696Rachad } 2072cfe964a09ca05778e5dd84f2fd24119b89401696Rachad 2073cfe964a09ca05778e5dd84f2fd24119b89401696Rachad mAvSyncBytesRemaining -= ret; 2074cfe964a09ca05778e5dd84f2fd24119b89401696Rachad if (mAvSyncBytesRemaining == 0) { 2075cfe964a09ca05778e5dd84f2fd24119b89401696Rachad mAvSyncHeader = null; 2076cfe964a09ca05778e5dd84f2fd24119b89401696Rachad } 2077cfe964a09ca05778e5dd84f2fd24119b89401696Rachad 2078cfe964a09ca05778e5dd84f2fd24119b89401696Rachad return ret; 2079cfe964a09ca05778e5dd84f2fd24119b89401696Rachad } 2080cfe964a09ca05778e5dd84f2fd24119b89401696Rachad 2081cfe964a09ca05778e5dd84f2fd24119b89401696Rachad 2082cfe964a09ca05778e5dd84f2fd24119b89401696Rachad /** 2083ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * Sets the playback head position within the static buffer to zero, 2084ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * that is it rewinds to start of static buffer. 2085ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * The track must be stopped or paused, and 2086ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * the track's creation mode must be {@link #MODE_STATIC}. 2087ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * <p> 208835e576e79292122fad462ebccd8520822552a6d7Andy Hung * As of {@link android.os.Build.VERSION_CODES#MNC}, also resets the value returned by 2089ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * {@link #getPlaybackHeadPosition()} to zero. 2090ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * For earlier API levels, the reset behavior is unspecified. 2091ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * <p> 209235e576e79292122fad462ebccd8520822552a6d7Andy Hung * Use {@link #setPlaybackHeadPosition(int)} with a zero position 209335e576e79292122fad462ebccd8520822552a6d7Andy Hung * if the reset of <code>getPlaybackHeadPosition()</code> is not needed. 20949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return error code or success, see {@link #SUCCESS}, {@link #ERROR_BAD_VALUE}, 20959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #ERROR_INVALID_OPERATION} 20969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 20979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int reloadStaticData() { 2098a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten if (mDataLoadMode == MODE_STREAM || mState != STATE_INITIALIZED) { 20999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return ERROR_INVALID_OPERATION; 21009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 21019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return native_reload_static(); 21029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 21039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 21047070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent //-------------------------------------------------------------------------- 21057070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent // Audio effects management 21067070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent //-------------------- 21077070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent 21087070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent /** 21091a5149e5d7f2dddc8b324f7695e69fd89af73c52Eric Laurent * Attaches an auxiliary effect to the audio track. A typical auxiliary 21101a5149e5d7f2dddc8b324f7695e69fd89af73c52Eric Laurent * effect is a reverberation effect which can be applied on any sound source 21111a5149e5d7f2dddc8b324f7695e69fd89af73c52Eric Laurent * that directs a certain amount of its energy to this effect. This amount 21121a5149e5d7f2dddc8b324f7695e69fd89af73c52Eric Laurent * is defined by setAuxEffectSendLevel(). 21137070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent * {@see #setAuxEffectSendLevel(float)}. 21141a5149e5d7f2dddc8b324f7695e69fd89af73c52Eric Laurent * <p>After creating an auxiliary effect (e.g. 21151a5149e5d7f2dddc8b324f7695e69fd89af73c52Eric Laurent * {@link android.media.audiofx.EnvironmentalReverb}), retrieve its ID with 21161a5149e5d7f2dddc8b324f7695e69fd89af73c52Eric Laurent * {@link android.media.audiofx.AudioEffect#getId()} and use it when calling 21177070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent * this method to attach the audio track to the effect. 21181a5149e5d7f2dddc8b324f7695e69fd89af73c52Eric Laurent * <p>To detach the effect from the audio track, call this method with a 21191a5149e5d7f2dddc8b324f7695e69fd89af73c52Eric Laurent * null effect id. 21207070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent * 21217070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent * @param effectId system wide unique id of the effect to attach 21227070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent * @return error code or success, see {@link #SUCCESS}, 21237070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent * {@link #ERROR_INVALID_OPERATION}, {@link #ERROR_BAD_VALUE} 21247070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent */ 21257070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent public int attachAuxEffect(int effectId) { 21263b4df62704a6184878afd9272830cf3db7bd2d66Glenn Kasten if (mState == STATE_UNINITIALIZED) { 21277070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent return ERROR_INVALID_OPERATION; 21287070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent } 21297070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent return native_attachAuxEffect(effectId); 21307070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent } 21317070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent 21327070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent /** 21337070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent * Sets the send level of the audio track to the attached auxiliary effect 213478cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * {@link #attachAuxEffect(int)}. Effect levels 213578cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * are clamped to the closed interval [0.0, max] where 213678cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * max is the value of {@link #getMaxVolume}. 213778cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * A value of 0.0 results in no effect, and a value of 1.0 is full send. 2138e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * <p>By default the send level is 0.0f, so even if an effect is attached to the player 21397070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent * this method must be called for the effect to be applied. 214078cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * <p>Note that the passed level value is a linear scalar. UI controls should be scaled 214178cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * logarithmically: the gain applied by audio framework ranges from -72dB to at least 0dB, 21427070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent * so an appropriate conversion from linear UI input x to level is: 21435c17a820f9e46e0756c11795b3e6f89105f2f539Glenn Kasten * x == 0 -> level = 0 21445c17a820f9e46e0756c11795b3e6f89105f2f539Glenn Kasten * 0 < x <= R -> level = 10^(72*(x-R)/20/R) 21457070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent * 214678cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * @param level linear send level 21477070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent * @return error code or success, see {@link #SUCCESS}, 21483009f0b911e39d3b26c69bd7667d6444eacb9d11Glenn Kasten * {@link #ERROR_INVALID_OPERATION}, {@link #ERROR} 21497070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent */ 21507070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent public int setAuxEffectSendLevel(float level) { 21511af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlock if (isRestricted()) { 21521af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlock return SUCCESS; 21531af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlock } 21543b4df62704a6184878afd9272830cf3db7bd2d66Glenn Kasten if (mState == STATE_UNINITIALIZED) { 21557070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent return ERROR_INVALID_OPERATION; 21567070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent } 215778cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten level = clampGainOrLevel(level); 21583009f0b911e39d3b26c69bd7667d6444eacb9d11Glenn Kasten int err = native_setAuxEffectSendLevel(level); 21593009f0b911e39d3b26c69bd7667d6444eacb9d11Glenn Kasten return err == 0 ? SUCCESS : ERROR; 21607070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent } 21619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 216288e1d86a879d8802e775dd0566ffb64425e8e3c8Paul McLean //-------------------------------------------------------------------------- 216388e1d86a879d8802e775dd0566ffb64425e8e3c8Paul McLean // Explicit Routing 216488e1d86a879d8802e775dd0566ffb64425e8e3c8Paul McLean //-------------------- 216588e1d86a879d8802e775dd0566ffb64425e8e3c8Paul McLean private AudioDeviceInfo mPreferredDevice = null; 216688e1d86a879d8802e775dd0566ffb64425e8e3c8Paul McLean 216788e1d86a879d8802e775dd0566ffb64425e8e3c8Paul McLean /** 21682d6de4c38c899707e0596b7fa4dad9bbb3eb6b60Paul McLean * Specifies an audio device (via an {@link AudioDeviceInfo} object) to route 216988e1d86a879d8802e775dd0566ffb64425e8e3c8Paul McLean * the output from this AudioTrack. 21709e29086d5df800532e736d8f31e2b9159b102524Glenn Kasten * @param deviceInfo The {@link AudioDeviceInfo} specifying the audio sink. 21719e29086d5df800532e736d8f31e2b9159b102524Glenn Kasten * If deviceInfo is null, default routing is restored. 217288e1d86a879d8802e775dd0566ffb64425e8e3c8Paul McLean * @return true if succesful, false if the specified {@link AudioDeviceInfo} is non-null and 217388e1d86a879d8802e775dd0566ffb64425e8e3c8Paul McLean * does not correspond to a valid audio output device. 217488e1d86a879d8802e775dd0566ffb64425e8e3c8Paul McLean */ 2175e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean public boolean setPreferredDevice(AudioDeviceInfo deviceInfo) { 217688e1d86a879d8802e775dd0566ffb64425e8e3c8Paul McLean // Do some validation.... 21772d6de4c38c899707e0596b7fa4dad9bbb3eb6b60Paul McLean if (deviceInfo != null && !deviceInfo.isSink()) { 217888e1d86a879d8802e775dd0566ffb64425e8e3c8Paul McLean return false; 217988e1d86a879d8802e775dd0566ffb64425e8e3c8Paul McLean } 21804bcdba848449b33d7022de527c526943aff1f5fdEric Laurent int preferredDeviceId = deviceInfo != null ? deviceInfo.getId() : 0; 21814bcdba848449b33d7022de527c526943aff1f5fdEric Laurent boolean status = native_setOutputDevice(preferredDeviceId); 21824bcdba848449b33d7022de527c526943aff1f5fdEric Laurent if (status == true) { 21834bcdba848449b33d7022de527c526943aff1f5fdEric Laurent synchronized (this) { 21844bcdba848449b33d7022de527c526943aff1f5fdEric Laurent mPreferredDevice = deviceInfo; 21854bcdba848449b33d7022de527c526943aff1f5fdEric Laurent } 21864bcdba848449b33d7022de527c526943aff1f5fdEric Laurent } 21874bcdba848449b33d7022de527c526943aff1f5fdEric Laurent return status; 218888e1d86a879d8802e775dd0566ffb64425e8e3c8Paul McLean } 218988e1d86a879d8802e775dd0566ffb64425e8e3c8Paul McLean 219088e1d86a879d8802e775dd0566ffb64425e8e3c8Paul McLean /** 2191e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean * Returns the selected output specified by {@link #setPreferredDevice}. Note that this 21922d6de4c38c899707e0596b7fa4dad9bbb3eb6b60Paul McLean * is not guaranteed to correspond to the actual device being used for playback. 219388e1d86a879d8802e775dd0566ffb64425e8e3c8Paul McLean */ 2194e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean public AudioDeviceInfo getPreferredDevice() { 21954bcdba848449b33d7022de527c526943aff1f5fdEric Laurent synchronized (this) { 21964bcdba848449b33d7022de527c526943aff1f5fdEric Laurent return mPreferredDevice; 21974bcdba848449b33d7022de527c526943aff1f5fdEric Laurent } 219888e1d86a879d8802e775dd0566ffb64425e8e3c8Paul McLean } 219988e1d86a879d8802e775dd0566ffb64425e8e3c8Paul McLean 2200d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean //-------------------------------------------------------------------------- 2201d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean // (Re)Routing Info 2202d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean //-------------------- 22038e6c9f46172458624349755c9b1bc051f420d36dPaul McLean /** 22048e6c9f46172458624349755c9b1bc051f420d36dPaul McLean * Defines the interface by which applications can receive notifications of routing 22058e6c9f46172458624349755c9b1bc051f420d36dPaul McLean * changes for the associated {@link AudioTrack}. 22068e6c9f46172458624349755c9b1bc051f420d36dPaul McLean */ 2207e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean public interface OnRoutingChangedListener { 2208e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean /** 2209e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean * Called when the routing of an AudioTrack changes from either and explicit or 22108e6c9f46172458624349755c9b1bc051f420d36dPaul McLean * policy rerouting. Use {@link #getRoutedDevice()} to retrieve the newly routed-to 22118e6c9f46172458624349755c9b1bc051f420d36dPaul McLean * device. 2212e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean */ 2213e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean public void onRoutingChanged(AudioTrack audioTrack); 2214e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean } 2215e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean 2216d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean /** 2217d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean * Returns an {@link AudioDeviceInfo} identifying the current routing of this AudioTrack. 22188e6c9f46172458624349755c9b1bc051f420d36dPaul McLean * Note: The query is only valid if the AudioTrack is currently playing. If it is not, 22198e6c9f46172458624349755c9b1bc051f420d36dPaul McLean * <code>getRoutedDevice()</code> will return null. 2220d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean */ 2221d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean public AudioDeviceInfo getRoutedDevice() { 22224bcdba848449b33d7022de527c526943aff1f5fdEric Laurent int deviceId = native_getRoutedDeviceId(); 22234bcdba848449b33d7022de527c526943aff1f5fdEric Laurent if (deviceId == 0) { 22244bcdba848449b33d7022de527c526943aff1f5fdEric Laurent return null; 22254bcdba848449b33d7022de527c526943aff1f5fdEric Laurent } 22264bcdba848449b33d7022de527c526943aff1f5fdEric Laurent AudioDeviceInfo[] devices = 2227e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean AudioManager.getDevicesStatic(AudioManager.GET_DEVICES_OUTPUTS); 22284bcdba848449b33d7022de527c526943aff1f5fdEric Laurent for (int i = 0; i < devices.length; i++) { 22294bcdba848449b33d7022de527c526943aff1f5fdEric Laurent if (devices[i].getId() == deviceId) { 22304bcdba848449b33d7022de527c526943aff1f5fdEric Laurent return devices[i]; 22314bcdba848449b33d7022de527c526943aff1f5fdEric Laurent } 22324bcdba848449b33d7022de527c526943aff1f5fdEric Laurent } 2233d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean return null; 2234d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean } 2235d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean 2236d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean /** 22378e6c9f46172458624349755c9b1bc051f420d36dPaul McLean * The list of AudioTrack.OnRoutingChangedListener interfaces added (with 22388e6c9f46172458624349755c9b1bc051f420d36dPaul McLean * {@link AudioTrack#addOnRoutingChangedListener(OnRoutingChangedListener, android.os.Handler)} 22398e6c9f46172458624349755c9b1bc051f420d36dPaul McLean * by an app to receive (re)routing notifications. 2240d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean */ 2241e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean private ArrayMap<OnRoutingChangedListener, NativeRoutingEventHandlerDelegate> 2242d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean mRoutingChangeListeners = 2243e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean new ArrayMap<OnRoutingChangedListener, NativeRoutingEventHandlerDelegate>(); 2244d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean 2245d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean /** 2246e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean * Adds an {@link OnRoutingChangedListener} to receive notifications of routing changes 2247d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean * on this AudioTrack. 22488e6c9f46172458624349755c9b1bc051f420d36dPaul McLean * @param listener The {@link OnRoutingChangedListener} interface to receive notifications 22498e6c9f46172458624349755c9b1bc051f420d36dPaul McLean * of rerouting events. 22508e6c9f46172458624349755c9b1bc051f420d36dPaul McLean * @param handler Specifies the {@link Handler} object for the thread on which to execute 22518e6c9f46172458624349755c9b1bc051f420d36dPaul McLean * the callback. If <code>null</code>, the {@link Handler} associated with the main 22528e6c9f46172458624349755c9b1bc051f420d36dPaul McLean * {@link Looper} will be used. 2253d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean */ 2254e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean public void addOnRoutingChangedListener(OnRoutingChangedListener listener, 2255d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean android.os.Handler handler) { 2256d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean if (listener != null && !mRoutingChangeListeners.containsKey(listener)) { 2257d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean synchronized (mRoutingChangeListeners) { 22584bcdba848449b33d7022de527c526943aff1f5fdEric Laurent if (mRoutingChangeListeners.size() == 0) { 22594bcdba848449b33d7022de527c526943aff1f5fdEric Laurent native_enableDeviceCallback(); 22604bcdba848449b33d7022de527c526943aff1f5fdEric Laurent } 2261d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean mRoutingChangeListeners.put( 22625be68ede1943354371233ed2511e308f83b77932Paul McLean listener, new NativeRoutingEventHandlerDelegate(this, listener, 22635be68ede1943354371233ed2511e308f83b77932Paul McLean handler != null ? handler : new Handler(mInitializationLooper))); 2264d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean } 2265d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean } 2266d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean } 2267d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean 2268d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean /** 2269e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean * Removes an {@link OnRoutingChangedListener} which has been previously added 22708e6c9f46172458624349755c9b1bc051f420d36dPaul McLean * to receive rerouting notifications. 22718e6c9f46172458624349755c9b1bc051f420d36dPaul McLean * @param listener The previously added {@link OnRoutingChangedListener} interface to remove. 2272d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean */ 2273e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean public void removeOnRoutingChangedListener(OnRoutingChangedListener listener) { 2274d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean synchronized (mRoutingChangeListeners) { 2275d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean if (mRoutingChangeListeners.containsKey(listener)) { 2276d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean mRoutingChangeListeners.remove(listener); 2277d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean } 22784bcdba848449b33d7022de527c526943aff1f5fdEric Laurent if (mRoutingChangeListeners.size() == 0) { 22794bcdba848449b33d7022de527c526943aff1f5fdEric Laurent native_disableDeviceCallback(); 22804bcdba848449b33d7022de527c526943aff1f5fdEric Laurent } 2281d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean } 2282d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean } 2283d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean 2284d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean /** 2285d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean * Sends device list change notification to all listeners. 2286d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean */ 2287d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean private void broadcastRoutingChange() { 2288d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean Collection<NativeRoutingEventHandlerDelegate> values; 2289d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean synchronized (mRoutingChangeListeners) { 2290d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean values = mRoutingChangeListeners.values(); 2291d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean } 22924bcdba848449b33d7022de527c526943aff1f5fdEric Laurent AudioManager.resetAudioPortGeneration(); 2293d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean for(NativeRoutingEventHandlerDelegate delegate : values) { 2294d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean Handler handler = delegate.getHandler(); 2295d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean if (handler != null) { 22964bcdba848449b33d7022de527c526943aff1f5fdEric Laurent handler.sendEmptyMessage(AudioSystem.NATIVE_EVENT_ROUTING_CHANGE); 2297d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean } 2298d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean } 2299d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean } 2300d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean 23019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //--------------------------------------------------------- 23029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Interface definitions 23039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //-------------------- 23049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 23054df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project * Interface definition for a callback to be invoked when the playback head position of 23064df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project * an AudioTrack has reached a notification marker or has increased by a certain period. 23079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 23084df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project public interface OnPlaybackPositionUpdateListener { 23099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 23109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Called on the listener to notify it that the previously set marker has been reached 23119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * by the playback head. 23129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 23139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project void onMarkerReached(AudioTrack track); 2314fb2ab9efc3805c81521afb9ff91a58ff5097a36eGlenn Kasten 23159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 23169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Called on the listener to periodically notify it that the playback head has reached 23179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * a multiple of the notification period. 23189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 23199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project void onPeriodicNotification(AudioTrack track); 23209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 23219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 23229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //--------------------------------------------------------- 23239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Inner classes 23249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //-------------------- 23259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 23264df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project * Helper class to handle the forwarding of native events to the appropriate listener 23274df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project * (potentially) handled in a different thread 23285c17a820f9e46e0756c11795b3e6f89105f2f539Glenn Kasten */ 2329d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean private class NativePositionEventHandlerDelegate { 23304df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project private final Handler mHandler; 2331fb2ab9efc3805c81521afb9ff91a58ff5097a36eGlenn Kasten 2332d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean NativePositionEventHandlerDelegate(final AudioTrack track, 233395bd2329c6a36211f18be3e089eaa775ec62df62Glenn Kasten final OnPlaybackPositionUpdateListener listener, 233495bd2329c6a36211f18be3e089eaa775ec62df62Glenn Kasten Handler handler) { 23354df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project // find the looper for our new event handler 23364df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project Looper looper; 23374df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project if (handler != null) { 23384df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project looper = handler.getLooper(); 23394df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project } else { 2340105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project // no given handler, use the looper the AudioTrack was created in 2341105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project looper = mInitializationLooper; 23429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2343fb2ab9efc3805c81521afb9ff91a58ff5097a36eGlenn Kasten 23444df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project // construct the event handler with this looper 23454df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project if (looper != null) { 23464df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project // implement the event handler delegate 23474df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project mHandler = new Handler(looper) { 23484df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project @Override 23494df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project public void handleMessage(Message msg) { 235095bd2329c6a36211f18be3e089eaa775ec62df62Glenn Kasten if (track == null) { 23514df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project return; 23524df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project } 23534df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project switch(msg.what) { 23544df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project case NATIVE_EVENT_MARKER: 23554df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project if (listener != null) { 235695bd2329c6a36211f18be3e089eaa775ec62df62Glenn Kasten listener.onMarkerReached(track); 23574df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project } 23584df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project break; 23594df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project case NATIVE_EVENT_NEW_POS: 23604df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project if (listener != null) { 236195bd2329c6a36211f18be3e089eaa775ec62df62Glenn Kasten listener.onPeriodicNotification(track); 23624df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project } 23634df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project break; 23644df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project default: 23651f61d01508651b4475397414e1fe06af1ab8fadaGlenn Kasten loge("Unknown native event type: " + msg.what); 23664df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project break; 23674df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project } 23684df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project } 23694df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project }; 23704df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project } else { 23714df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project mHandler = null; 2372fb2ab9efc3805c81521afb9ff91a58ff5097a36eGlenn Kasten } 23734df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project } 2374fb2ab9efc3805c81521afb9ff91a58ff5097a36eGlenn Kasten 23754df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project Handler getHandler() { 23764df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project return mHandler; 23779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 23789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 23799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2380d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean /** 2381d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean * Helper class to handle the forwarding of native events to the appropriate listener 2382d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean * (potentially) handled in a different thread 2383d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean */ 2384d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean private class NativeRoutingEventHandlerDelegate { 2385d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean private final Handler mHandler; 2386d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean 2387d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean NativeRoutingEventHandlerDelegate(final AudioTrack track, 2388e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean final OnRoutingChangedListener listener, 2389d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean Handler handler) { 2390d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean // find the looper for our new event handler 2391d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean Looper looper; 2392d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean if (handler != null) { 2393d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean looper = handler.getLooper(); 2394d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean } else { 2395d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean // no given handler, use the looper the AudioTrack was created in 2396d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean looper = mInitializationLooper; 2397d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean } 2398d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean 2399d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean // construct the event handler with this looper 2400d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean if (looper != null) { 2401d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean // implement the event handler delegate 2402d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean mHandler = new Handler(looper) { 2403d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean @Override 2404d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean public void handleMessage(Message msg) { 2405d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean if (track == null) { 2406d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean return; 2407d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean } 2408d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean switch(msg.what) { 24094bcdba848449b33d7022de527c526943aff1f5fdEric Laurent case AudioSystem.NATIVE_EVENT_ROUTING_CHANGE: 2410d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean if (listener != null) { 2411e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean listener.onRoutingChanged(track); 2412d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean } 2413d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean break; 2414d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean default: 2415d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean loge("Unknown native event type: " + msg.what); 2416d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean break; 2417d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean } 2418d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean } 2419d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean }; 2420d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean } else { 2421d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean mHandler = null; 2422d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean } 2423d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean } 2424d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean 2425d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean Handler getHandler() { 2426d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean return mHandler; 2427d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean } 2428d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean } 24299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 24309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //--------------------------------------------------------- 24319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Java methods called from the native side 24329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //-------------------- 24339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @SuppressWarnings("unused") 24349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static void postEventFromNative(Object audiotrack_ref, 24359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int what, int arg1, int arg2, Object obj) { 24369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //logd("Event posted from the native side: event="+ what + " args="+ arg1+" "+arg2); 24379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project AudioTrack track = (AudioTrack)((WeakReference)audiotrack_ref).get(); 24389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (track == null) { 24399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return; 24409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 24419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 24424bcdba848449b33d7022de527c526943aff1f5fdEric Laurent if (what == AudioSystem.NATIVE_EVENT_ROUTING_CHANGE) { 24434bcdba848449b33d7022de527c526943aff1f5fdEric Laurent track.broadcastRoutingChange(); 24444bcdba848449b33d7022de527c526943aff1f5fdEric Laurent return; 24454bcdba848449b33d7022de527c526943aff1f5fdEric Laurent } 2446d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean NativePositionEventHandlerDelegate delegate = track.mEventHandlerDelegate; 244795bd2329c6a36211f18be3e089eaa775ec62df62Glenn Kasten if (delegate != null) { 244895bd2329c6a36211f18be3e089eaa775ec62df62Glenn Kasten Handler handler = delegate.getHandler(); 244995bd2329c6a36211f18be3e089eaa775ec62df62Glenn Kasten if (handler != null) { 245095bd2329c6a36211f18be3e089eaa775ec62df62Glenn Kasten Message m = handler.obtainMessage(what, arg1, arg2, obj); 245195bd2329c6a36211f18be3e089eaa775ec62df62Glenn Kasten handler.sendMessage(m); 245295bd2329c6a36211f18be3e089eaa775ec62df62Glenn Kasten } 24539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 24549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 24559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 24569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 24579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //--------------------------------------------------------- 24589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Native methods called from the Java side 24599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //-------------------- 24609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2461a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi // post-condition: mStreamType is overwritten with a value 2462a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi // that reflects the audio attributes (e.g. an AudioAttributes object with a usage of 2463a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi // AudioAttributes.USAGE_MEDIA will map to AudioManager.STREAM_MUSIC 2464a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi private native final int native_setup(Object /*WeakReference<AudioTrack>*/ audiotrack_this, 2465a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi Object /*AudioAttributes*/ attributes, 246630d794360f35592554403922bcc07835fea4737bAndy Hung int sampleRate, int channelMask, int channelIndexMask, int audioFormat, 2467619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent int buffSizeInBytes, int mode, int[] sessionId); 24689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 24699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private native final void native_finalize(); 24709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 24719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private native final void native_release(); 24729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 24739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private native final void native_start(); 24749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 24759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private native final void native_stop(); 24769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 24779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private native final void native_pause(); 24789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 24799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private native final void native_flush(); 24809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 24819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private native final int native_write_byte(byte[] audioData, 24827ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi int offsetInBytes, int sizeInBytes, int format, 24837ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi boolean isBlocking); 24849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 24859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private native final int native_write_short(short[] audioData, 24864aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung int offsetInShorts, int sizeInShorts, int format, 24874aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung boolean isBlocking); 24889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 248954955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten private native final int native_write_float(float[] audioData, 249054955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten int offsetInFloats, int sizeInFloats, int format, 249154955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten boolean isBlocking); 249254955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten 24937ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi private native final int native_write_native_bytes(Object audioData, 24945d21f679c58dbb13c8c931ffec6e06b6b8cd454fJean-Michel Trivi int positionInBytes, int sizeInBytes, int format, boolean blocking); 24957ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi 24969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private native final int native_reload_static(); 24979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 24989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private native final int native_get_native_frame_count(); 24999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 25009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private native final void native_setVolume(float leftVolume, float rightVolume); 25019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 250288e209dcf8c2ebddda5c272f46d1bd5478bc639cEric Laurent private native final int native_set_playback_rate(int sampleRateInHz); 250388e209dcf8c2ebddda5c272f46d1bd5478bc639cEric Laurent private native final int native_get_playback_rate(); 25049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 25052d61e2b97c92ac2de80ebb3782b728ae5cdf5306Wei Jia private native final void native_set_playback_params(@NonNull PlaybackParams params); 25062d61e2b97c92ac2de80ebb3782b728ae5cdf5306Wei Jia private native final @NonNull PlaybackParams native_get_playback_params(); 2507263b4c97823295c41900210515d0c769a236190cAndy Hung 25089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private native final int native_set_marker_pos(int marker); 25099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private native final int native_get_marker_pos(); 25109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 25119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private native final int native_set_pos_update_period(int updatePeriod); 25129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private native final int native_get_pos_update_period(); 25139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 25149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private native final int native_set_position(int position); 25159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private native final int native_get_position(); 25169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 251761dcdf3764b614c6f01e77cb4342d192e3101f8aOliver Woodman private native final int native_get_latency(); 251861dcdf3764b614c6f01e77cb4342d192e3101f8aOliver Woodman 2519948c2e6ff46d65942277f2e0e9ce0c038972b9d8Glenn Kasten // longArray must be a non-null array of length >= 2 2520948c2e6ff46d65942277f2e0e9ce0c038972b9d8Glenn Kasten // [0] is assigned the frame position 2521948c2e6ff46d65942277f2e0e9ce0c038972b9d8Glenn Kasten // [1] is assigned the time in CLOCK_MONOTONIC nanoseconds 2522948c2e6ff46d65942277f2e0e9ce0c038972b9d8Glenn Kasten private native final int native_get_timestamp(long[] longArray); 2523948c2e6ff46d65942277f2e0e9ce0c038972b9d8Glenn Kasten 25249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private native final int native_set_loop(int start, int end, int loopCount); 25259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 25269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project static private native final int native_get_output_sample_rate(int streamType); 25279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project static private native final int native_get_min_buff_size( 25289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int sampleRateInHz, int channelConfig, int audioFormat); 25299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 25307070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent private native final int native_attachAuxEffect(int effectId); 25313009f0b911e39d3b26c69bd7667d6444eacb9d11Glenn Kasten private native final int native_setAuxEffectSendLevel(float level); 25327070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent 253388e1d86a879d8802e775dd0566ffb64425e8e3c8Paul McLean private native final boolean native_setOutputDevice(int deviceId); 25344bcdba848449b33d7022de527c526943aff1f5fdEric Laurent private native final int native_getRoutedDeviceId(); 25354bcdba848449b33d7022de527c526943aff1f5fdEric Laurent private native final void native_enableDeviceCallback(); 25364bcdba848449b33d7022de527c526943aff1f5fdEric Laurent private native final void native_disableDeviceCallback(); 253788e1d86a879d8802e775dd0566ffb64425e8e3c8Paul McLean 25389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //--------------------------------------------------------- 25399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Utility methods 25409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //------------------ 25419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 25429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static void logd(String msg) { 25431f61d01508651b4475397414e1fe06af1ab8fadaGlenn Kasten Log.d(TAG, msg); 25449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 25459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 25469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static void loge(String msg) { 25471f61d01508651b4475397414e1fe06af1ab8fadaGlenn Kasten Log.e(TAG, msg); 25489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 25499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project} 2550