AudioTrack.java revision 4bd513e6ed168811c97dbc83cd5a7c7cc43caffe
19066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/* 29066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Copyright (C) 2008 The Android Open Source Project 39066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 49066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Licensed under the Apache License, Version 2.0 (the "License"); 59066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * you may not use this file except in compliance with the License. 69066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * You may obtain a copy of the License at 79066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 89066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * http://www.apache.org/licenses/LICENSE-2.0 99066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Unless required by applicable law or agreed to in writing, software 119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * distributed under the License is distributed on an "AS IS" BASIS, 129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * See the License for the specific language governing permissions and 149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * limitations under the License. 159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpackage android.media; 189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 197ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Triviimport java.lang.annotation.Retention; 207ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Triviimport java.lang.annotation.RetentionPolicy; 219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport java.lang.ref.WeakReference; 227ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Triviimport java.nio.ByteBuffer; 237ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Triviimport java.nio.NioUtils; 2435ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi 257ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Triviimport android.annotation.IntDef; 2635ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Triviimport android.annotation.NonNull; 2735ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Triviimport android.annotation.SystemApi; 281af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlockimport android.app.ActivityThread; 291af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlockimport android.app.AppOpsManager; 301af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlockimport android.content.Context; 319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.Handler; 321af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlockimport android.os.IBinder; 339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.Looper; 349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.Message; 351af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlockimport android.os.Process; 361af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlockimport android.os.RemoteException; 371af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlockimport android.os.ServiceManager; 389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.util.Log; 399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 401af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlockimport com.android.internal.app.IAppOpsService; 411af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlock 429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/** 449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The AudioTrack class manages and plays a single audio resource for Java applications. 45e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * It allows streaming of PCM audio buffers to the audio sink for playback. This is 469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * achieved by "pushing" the data to the AudioTrack object using one of the 477d60bcd2d950e3571c00ce9f1c492c6bd58334c9Glenn Kasten * {@link #write(byte[], int, int)}, {@link #write(short[], int, int)}, 487d60bcd2d950e3571c00ce9f1c492c6bd58334c9Glenn Kasten * and {@link #write(float[], int, int, int)} methods. 4988bde0ce3799c47530ea42ae3665bfa12ae38d11Narayan Kamath * 50ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * <p>An AudioTrack instance can operate under two modes: static or streaming.<br> 51ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * In Streaming mode, the application writes a continuous stream of data to the AudioTrack, using 5288bde0ce3799c47530ea42ae3665bfa12ae38d11Narayan Kamath * one of the {@code write()} methods. These are blocking and return when the data has been 5388bde0ce3799c47530ea42ae3665bfa12ae38d11Narayan Kamath * transferred from the Java layer to the native layer and queued for playback. The streaming 5488bde0ce3799c47530ea42ae3665bfa12ae38d11Narayan Kamath * mode is most useful when playing blocks of audio data that for instance are: 5588bde0ce3799c47530ea42ae3665bfa12ae38d11Narayan Kamath * 569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <ul> 579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>too big to fit in memory because of the duration of the sound to play,</li> 589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>too big to fit in memory because of the characteristics of the audio data 599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * (high sampling rate, bits per sample ...)</li> 60ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * <li>received or generated while previously queued audio is playing.</li> 619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * </ul> 6288bde0ce3799c47530ea42ae3665bfa12ae38d11Narayan Kamath * 635c17a820f9e46e0756c11795b3e6f89105f2f539Glenn Kasten * The static mode should be chosen when dealing with short sounds that fit in memory and 6488bde0ce3799c47530ea42ae3665bfa12ae38d11Narayan Kamath * that need to be played with the smallest latency possible. The static mode will 6588bde0ce3799c47530ea42ae3665bfa12ae38d11Narayan Kamath * therefore be preferred for UI and game sounds that are played often, and with the 6688bde0ce3799c47530ea42ae3665bfa12ae38d11Narayan Kamath * smallest overhead possible. 6788bde0ce3799c47530ea42ae3665bfa12ae38d11Narayan Kamath * 689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>Upon creation, an AudioTrack object initializes its associated audio buffer. 699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The size of this buffer, specified during the construction, determines how long an AudioTrack 709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * can play before running out of data.<br> 719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * For an AudioTrack using the static mode, this size is the maximum size of the sound that can 729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * be played from it.<br> 73e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * For the streaming mode, data will be written to the audio sink in chunks of 745c17a820f9e46e0756c11795b3e6f89105f2f539Glenn Kasten * sizes less than or equal to the total buffer size. 7555a3218f242a611afb3569d88970c0c5dbf8ce54Glenn Kasten * 7655a3218f242a611afb3569d88970c0c5dbf8ce54Glenn Kasten * AudioTrack is not final and thus permits subclasses, but such use is not recommended. 779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpublic class AudioTrack 799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project{ 809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //--------------------------------------------------------- 819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Constants 829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //-------------------- 8378cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten /** Minimum value for a linear gain or auxiliary effect level. 8478cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * This value must be exactly equal to 0.0f; do not change it. 8578cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten */ 8678cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten private static final float GAIN_MIN = 0.0f; 8778cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten /** Maximum value for a linear gain or auxiliary effect level. 8878cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * This value must be greater than or equal to 1.0f. 8978cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten */ 9078cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten private static final float GAIN_MAX = 1.0f; 919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 92ad67c9546494a7c4d9336b57889a7c19a7dbb945Glenn Kasten /** Minimum value for sample rate */ 93ad67c9546494a7c4d9336b57889a7c19a7dbb945Glenn Kasten private static final int SAMPLE_RATE_HZ_MIN = 4000; 94ad67c9546494a7c4d9336b57889a7c19a7dbb945Glenn Kasten /** Maximum value for sample rate */ 9570b395e8c1d06ca9288afd418b9e889df4060eabAndy Hung private static final int SAMPLE_RATE_HZ_MAX = 96000; 96ad67c9546494a7c4d9336b57889a7c19a7dbb945Glenn Kasten 97ad720aeea741d9058a7b4d326c9ab1b3ebcd7c62Andy Hung /** Maximum value for AudioTrack channel count */ 98ad720aeea741d9058a7b4d326c9ab1b3ebcd7c62Andy Hung private static final int CHANNEL_COUNT_MAX = 8; 99ad720aeea741d9058a7b4d326c9ab1b3ebcd7c62Andy Hung 100ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi /** indicates AudioTrack state is stopped */ 1019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int PLAYSTATE_STOPPED = 1; // matches SL_PLAYSTATE_STOPPED 102ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi /** indicates AudioTrack state is paused */ 1039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int PLAYSTATE_PAUSED = 2; // matches SL_PLAYSTATE_PAUSED 104ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi /** indicates AudioTrack state is playing */ 1059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int PLAYSTATE_PLAYING = 3; // matches SL_PLAYSTATE_PLAYING 1069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1075c17a820f9e46e0756c11795b3e6f89105f2f539Glenn Kasten // keep these values in sync with android_media_AudioTrack.cpp 1089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Creation mode where audio data is transferred from Java to the native layer 1109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * only once before the audio starts playing. 1119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int MODE_STATIC = 0; 1139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Creation mode where audio data is streamed from Java to the native layer 1159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * as the audio is playing. 1169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int MODE_STREAM = 1; 1189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11935ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi /** @hide */ 12035ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi @IntDef({ 12135ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi MODE_STATIC, 12235ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi MODE_STREAM 12335ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi }) 12435ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi @Retention(RetentionPolicy.SOURCE) 12535ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi public @interface TransferMode {} 12635ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi 1279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 128ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * State of an AudioTrack that was not successfully initialized upon creation. 1299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int STATE_UNINITIALIZED = 0; 1319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * State of an AudioTrack that is ready to be used. 1339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int STATE_INITIALIZED = 1; 1359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * State of a successfully initialized AudioTrack that uses static data, 1379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * but that hasn't received that data yet. 1389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int STATE_NO_STATIC_DATA = 2; 1409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Denotes a successful operation. 1439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 144bc11a696f6856624de532a6830d5db9dbbe2384cEric Laurent public static final int SUCCESS = AudioSystem.SUCCESS; 1459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Denotes a generic operation failure. 1479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 148bc11a696f6856624de532a6830d5db9dbbe2384cEric Laurent public static final int ERROR = AudioSystem.ERROR; 1499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Denotes a failure due to the use of an invalid value. 1519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 152bc11a696f6856624de532a6830d5db9dbbe2384cEric Laurent public static final int ERROR_BAD_VALUE = AudioSystem.BAD_VALUE; 1539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Denotes a failure due to the improper use of a method. 1559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 156bc11a696f6856624de532a6830d5db9dbbe2384cEric Laurent public static final int ERROR_INVALID_OPERATION = AudioSystem.INVALID_OPERATION; 1579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 158bc11a696f6856624de532a6830d5db9dbbe2384cEric Laurent // Error codes: 159bc11a696f6856624de532a6830d5db9dbbe2384cEric Laurent // to keep in sync with frameworks/base/core/jni/android_media_AudioTrack.cpp 1609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final int ERROR_NATIVESETUP_AUDIOSYSTEM = -16; 161a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent private static final int ERROR_NATIVESETUP_INVALIDCHANNELMASK = -17; 1629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final int ERROR_NATIVESETUP_INVALIDFORMAT = -18; 1639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final int ERROR_NATIVESETUP_INVALIDSTREAMTYPE = -19; 1649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final int ERROR_NATIVESETUP_NATIVEINITFAILED = -20; 1659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Events: 167e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten // to keep in sync with frameworks/av/include/media/AudioTrack.h 1689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 169ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * Event id denotes when playback head has reached a previously set marker. 1709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final int NATIVE_EVENT_MARKER = 3; 1729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 173ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * Event id denotes when previously set update period has elapsed during playback. 1749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final int NATIVE_EVENT_NEW_POS = 4; 1769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1771f61d01508651b4475397414e1fe06af1ab8fadaGlenn Kasten private final static String TAG = "android.media.AudioTrack"; 1789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1807ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi /** @hide */ 1817ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi @IntDef({ 1827ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi WRITE_BLOCKING, 1837ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi WRITE_NON_BLOCKING 1847ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi }) 1857ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi @Retention(RetentionPolicy.SOURCE) 1867ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi public @interface WriteMode {} 1877ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi 1887ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi /** 1897ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi * The write mode indicating the write operation will block until all data has been written, 1908b520c8f8e176f07ed496a171ddae75e66b3bc4fJean-Michel Trivi * to be used in {@link #write(ByteBuffer, int, int)} 1917ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi */ 1927ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi public final static int WRITE_BLOCKING = 0; 1937ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi /** 1947ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi * The write mode indicating the write operation will return immediately after 1957ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi * queuing as much audio data for playback as possible without blocking, to be used in 1968b520c8f8e176f07ed496a171ddae75e66b3bc4fJean-Michel Trivi * {@link #write(ByteBuffer, int, int)}. 1977ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi */ 1987ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi public final static int WRITE_NON_BLOCKING = 1; 1997ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi 2009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //-------------------------------------------------------------------------- 2019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Member variables 2029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //-------------------- 2039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 204ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * Indicates the state of the AudioTrack instance. 2059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private int mState = STATE_UNINITIALIZED; 2079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 208ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * Indicates the play state of the AudioTrack instance. 2099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private int mPlayState = PLAYSTATE_STOPPED; 2119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Lock to make sure mPlayState updates are reflecting the actual state of the object. 2139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private final Object mPlayStateLock = new Object(); 2159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 216e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * Sizes of the native audio buffer. 2174bd513e6ed168811c97dbc83cd5a7c7cc43caffeAndy Hung * These values are set during construction and can be stale. 2184bd513e6ed168811c97dbc83cd5a7c7cc43caffeAndy Hung * To obtain the current native audio buffer frame count use {@link #getNativeFrameCount()}. 2199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private int mNativeBufferSizeInBytes = 0; 221e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten private int mNativeBufferSizeInFrames = 0; 2229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 22386fad47e68e344b19fabeab1156c5e6742d8dfadGlenn Kasten * Handler for events coming from the native code. 2249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 22595bd2329c6a36211f18be3e089eaa775ec62df62Glenn Kasten private NativeEventHandlerDelegate mEventHandlerDelegate; 2269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 227ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * Looper associated with the thread that creates the AudioTrack instance. 228105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project */ 229b09707a041957f055cee3d290c85763cfef8d986Glenn Kasten private final Looper mInitializationLooper; 230105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project /** 2318d7fa137466c833ed422053204fb4c506b7bb209Glenn Kasten * The audio data source sampling rate in Hz. 2329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2335c17a820f9e46e0756c11795b3e6f89105f2f539Glenn Kasten private int mSampleRate; // initialized by all constructors 2349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2353026a023b8979b7ddcb3fe97bbc45531c89fda92Eric Laurent * The number of audio output channels (1 is mono, 2 is stereo). 2369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private int mChannelCount = 1; 2389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 239a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung * The audio channel mask used for calling native AudioTrack 2403026a023b8979b7ddcb3fe97bbc45531c89fda92Eric Laurent */ 2413026a023b8979b7ddcb3fe97bbc45531c89fda92Eric Laurent private int mChannels = AudioFormat.CHANNEL_OUT_MONO; 2423026a023b8979b7ddcb3fe97bbc45531c89fda92Eric Laurent 2433026a023b8979b7ddcb3fe97bbc45531c89fda92Eric Laurent /** 2449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The type of the audio stream to play. See 2459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link AudioManager#STREAM_VOICE_CALL}, {@link AudioManager#STREAM_SYSTEM}, 2465c17a820f9e46e0756c11795b3e6f89105f2f539Glenn Kasten * {@link AudioManager#STREAM_RING}, {@link AudioManager#STREAM_MUSIC}, 247b282e08ab641d4fc74d0324b7a0ce30926638dd5Glenn Kasten * {@link AudioManager#STREAM_ALARM}, {@link AudioManager#STREAM_NOTIFICATION}, and 248b282e08ab641d4fc74d0324b7a0ce30926638dd5Glenn Kasten * {@link AudioManager#STREAM_DTMF}. 2499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private int mStreamType = AudioManager.STREAM_MUSIC; 251a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi 252a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi private final AudioAttributes mAttributes; 2539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 254e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * The way audio is consumed by the audio sink, streaming or static. 2559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private int mDataLoadMode = MODE_STREAM; 2579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 258a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung * The current channel position mask, as specified on AudioTrack creation. 259a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung * Can be set simultaneously with channel index mask {@link #mChannelIndexMask}. 260a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung * May be set to {@link AudioFormat#CHANNEL_INVALID} if a channel index mask is specified. 2619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 262a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent private int mChannelConfiguration = AudioFormat.CHANNEL_OUT_MONO; 2639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 264a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung * The current audio channel index configuration (if specified). 265a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung */ 266a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung private int mChannelIndexMask = 0; 267a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung /** 2689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The encoding of the audio samples. 2699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see AudioFormat#ENCODING_PCM_8BIT 2709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see AudioFormat#ENCODING_PCM_16BIT 2717d60bcd2d950e3571c00ce9f1c492c6bd58334c9Glenn Kasten * @see AudioFormat#ENCODING_PCM_FLOAT 2729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private int mAudioFormat = AudioFormat.ENCODING_PCM_16BIT; 274619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent /** 275619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * Audio session ID 276619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent */ 27760bd67f7b1b85ed0ee19f77b056b90350a3d5343Glenn Kasten private int mSessionId = AudioSystem.AUDIO_SESSION_ALLOCATE; 2781af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlock /** 2791af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlock * Reference to the app-ops service. 2801af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlock */ 2811af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlock private final IAppOpsService mAppOps; 2829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //-------------------------------- 2849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Used exclusively by native code 2859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //-------------------- 2869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 287ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * Accessed by native methods: provides access to C++ AudioTrack object. 2889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @SuppressWarnings("unused") 290075e9a19ce645752f8282bc19c91b25978a7dc52Ashok Bhat private long mNativeTrackInJavaObj; 2919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Accessed by native methods: provides access to the JNI data (i.e. resources used by 2939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the native AudioTrack object, but not stored in it). 2949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @SuppressWarnings("unused") 296075e9a19ce645752f8282bc19c91b25978a7dc52Ashok Bhat private long mJniData; 2979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //-------------------------------------------------------------------------- 3009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Constructor, Finalize 3019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //-------------------- 3029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Class constructor. 3049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param streamType the type of the audio stream. See 3059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link AudioManager#STREAM_VOICE_CALL}, {@link AudioManager#STREAM_SYSTEM}, 3065c17a820f9e46e0756c11795b3e6f89105f2f539Glenn Kasten * {@link AudioManager#STREAM_RING}, {@link AudioManager#STREAM_MUSIC}, 3075c17a820f9e46e0756c11795b3e6f89105f2f539Glenn Kasten * {@link AudioManager#STREAM_ALARM}, and {@link AudioManager#STREAM_NOTIFICATION}. 3088d7fa137466c833ed422053204fb4c506b7bb209Glenn Kasten * @param sampleRateInHz the initial source sample rate expressed in Hz. 3099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param channelConfig describes the configuration of the audio channels. 310a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * See {@link AudioFormat#CHANNEL_OUT_MONO} and 311a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * {@link AudioFormat#CHANNEL_OUT_STEREO} 3129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param audioFormat the format in which the audio data is represented. 3137d60bcd2d950e3571c00ce9f1c492c6bd58334c9Glenn Kasten * See {@link AudioFormat#ENCODING_PCM_16BIT}, 3147d60bcd2d950e3571c00ce9f1c492c6bd58334c9Glenn Kasten * {@link AudioFormat#ENCODING_PCM_8BIT}, 3157d60bcd2d950e3571c00ce9f1c492c6bd58334c9Glenn Kasten * and {@link AudioFormat#ENCODING_PCM_FLOAT}. 316e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * @param bufferSizeInBytes the total size (in bytes) of the internal buffer where audio data is 3174bd513e6ed168811c97dbc83cd5a7c7cc43caffeAndy Hung * read from for playback. This should be a multiple of the frame size in bytes. 3184bd513e6ed168811c97dbc83cd5a7c7cc43caffeAndy Hung * <p> If the track's creation mode is {@link #MODE_STATIC}, 319e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * this is the maximum length sample, or audio clip, that can be played by this instance. 3204bd513e6ed168811c97dbc83cd5a7c7cc43caffeAndy Hung * <p> If the track's creation mode is {@link #MODE_STREAM}, 3214bd513e6ed168811c97dbc83cd5a7c7cc43caffeAndy Hung * this should be the desired buffer size 3224bd513e6ed168811c97dbc83cd5a7c7cc43caffeAndy Hung * for the <code>AudioTrack</code> to satisfy the application's 3234bd513e6ed168811c97dbc83cd5a7c7cc43caffeAndy Hung * natural latency requirements. 3244bd513e6ed168811c97dbc83cd5a7c7cc43caffeAndy Hung * If <code>bufferSizeInBytes</code> is less than the 3254bd513e6ed168811c97dbc83cd5a7c7cc43caffeAndy Hung * minimum buffer size for the output sink, it is automatically increased to the minimum 3264bd513e6ed168811c97dbc83cd5a7c7cc43caffeAndy Hung * buffer size. 3274bd513e6ed168811c97dbc83cd5a7c7cc43caffeAndy Hung * The method {@link #getNativeFrameCount()} returns the 3284bd513e6ed168811c97dbc83cd5a7c7cc43caffeAndy Hung * actual size in frames of the native buffer created, which 3294bd513e6ed168811c97dbc83cd5a7c7cc43caffeAndy Hung * determines the frequency to write 3304bd513e6ed168811c97dbc83cd5a7c7cc43caffeAndy Hung * to the streaming <code>AudioTrack</code> to avoid underrun. 3319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param mode streaming or static buffer. See {@link #MODE_STATIC} and {@link #MODE_STREAM} 3329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws java.lang.IllegalArgumentException 3339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public AudioTrack(int streamType, int sampleRateInHz, int channelConfig, int audioFormat, 3359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int bufferSizeInBytes, int mode) 3369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throws IllegalArgumentException { 337619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent this(streamType, sampleRateInHz, channelConfig, audioFormat, 33860bd67f7b1b85ed0ee19f77b056b90350a3d5343Glenn Kasten bufferSizeInBytes, mode, AudioSystem.AUDIO_SESSION_ALLOCATE); 339619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent } 340619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent 341619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent /** 342619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * Class constructor with audio session. Use this constructor when the AudioTrack must be 343619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * attached to a particular audio session. The primary use of the audio session ID is to 344619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * associate audio effects to a particular instance of AudioTrack: if an audio session ID 345619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * is provided when creating an AudioEffect, this effect will be applied only to audio tracks 346619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * and media players in the same session and not to the output mix. 347619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * When an AudioTrack is created without specifying a session, it will create its own session 3488d7fa137466c833ed422053204fb4c506b7bb209Glenn Kasten * which can be retrieved by calling the {@link #getAudioSessionId()} method. 3495c17a820f9e46e0756c11795b3e6f89105f2f539Glenn Kasten * If a non-zero session ID is provided, this AudioTrack will share effects attached to this 3505c17a820f9e46e0756c11795b3e6f89105f2f539Glenn Kasten * session 3515c17a820f9e46e0756c11795b3e6f89105f2f539Glenn Kasten * with all other media players or audio tracks in the same session, otherwise a new session 3525c17a820f9e46e0756c11795b3e6f89105f2f539Glenn Kasten * will be created for this track if none is supplied. 353619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * @param streamType the type of the audio stream. See 354619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * {@link AudioManager#STREAM_VOICE_CALL}, {@link AudioManager#STREAM_SYSTEM}, 3555c17a820f9e46e0756c11795b3e6f89105f2f539Glenn Kasten * {@link AudioManager#STREAM_RING}, {@link AudioManager#STREAM_MUSIC}, 3565c17a820f9e46e0756c11795b3e6f89105f2f539Glenn Kasten * {@link AudioManager#STREAM_ALARM}, and {@link AudioManager#STREAM_NOTIFICATION}. 3578d7fa137466c833ed422053204fb4c506b7bb209Glenn Kasten * @param sampleRateInHz the initial source sample rate expressed in Hz. 358619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * @param channelConfig describes the configuration of the audio channels. 359619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * See {@link AudioFormat#CHANNEL_OUT_MONO} and 360619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * {@link AudioFormat#CHANNEL_OUT_STEREO} 361619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * @param audioFormat the format in which the audio data is represented. 362619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * See {@link AudioFormat#ENCODING_PCM_16BIT} and 3637d60bcd2d950e3571c00ce9f1c492c6bd58334c9Glenn Kasten * {@link AudioFormat#ENCODING_PCM_8BIT}, 3647d60bcd2d950e3571c00ce9f1c492c6bd58334c9Glenn Kasten * and {@link AudioFormat#ENCODING_PCM_FLOAT}. 365619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * @param bufferSizeInBytes the total size (in bytes) of the buffer where audio data is read 366619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * from for playback. If using the AudioTrack in streaming mode, you can write data into 367619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * this buffer in smaller chunks than this size. If using the AudioTrack in static mode, 368619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * this is the maximum size of the sound that will be played for this instance. 369619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * See {@link #getMinBufferSize(int, int, int)} to determine the minimum required buffer size 370619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * for the successful creation of an AudioTrack instance in streaming mode. Using values 371619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * smaller than getMinBufferSize() will result in an initialization failure. 372619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * @param mode streaming or static buffer. See {@link #MODE_STATIC} and {@link #MODE_STREAM} 373619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * @param sessionId Id of audio session the AudioTrack must be attached to 374619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * @throws java.lang.IllegalArgumentException 375619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent */ 376619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent public AudioTrack(int streamType, int sampleRateInHz, int channelConfig, int audioFormat, 377619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent int bufferSizeInBytes, int mode, int sessionId) 378619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent throws IllegalArgumentException { 379a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten // mState already == STATE_UNINITIALIZED 380a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi this((new AudioAttributes.Builder()) 381a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi .setLegacyStreamType(streamType) 382a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi .build(), 383a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi (new AudioFormat.Builder()) 384a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi .setChannelMask(channelConfig) 385a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi .setEncoding(audioFormat) 386a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi .setSampleRate(sampleRateInHz) 387a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi .build(), 388a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi bufferSizeInBytes, 389a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi mode, sessionId); 390a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi } 391a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi 392a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi /** 3937f6ee760b0aee76bdb9fe61ac7ed1465c0da3489Jean-Michel Trivi * Class constructor with {@link AudioAttributes} and {@link AudioFormat}. 3947f6ee760b0aee76bdb9fe61ac7ed1465c0da3489Jean-Michel Trivi * @param attributes a non-null {@link AudioAttributes} instance. 3957f6ee760b0aee76bdb9fe61ac7ed1465c0da3489Jean-Michel Trivi * @param format a non-null {@link AudioFormat} instance describing the format of the data 3967f6ee760b0aee76bdb9fe61ac7ed1465c0da3489Jean-Michel Trivi * that will be played through this AudioTrack. See {@link AudioFormat.Builder} for 3977f6ee760b0aee76bdb9fe61ac7ed1465c0da3489Jean-Michel Trivi * configuring the audio format parameters such as encoding, channel mask and sample rate. 3987f6ee760b0aee76bdb9fe61ac7ed1465c0da3489Jean-Michel Trivi * @param bufferSizeInBytes the total size (in bytes) of the buffer where audio data is read 3997f6ee760b0aee76bdb9fe61ac7ed1465c0da3489Jean-Michel Trivi * from for playback. If using the AudioTrack in streaming mode, you can write data into 4007f6ee760b0aee76bdb9fe61ac7ed1465c0da3489Jean-Michel Trivi * this buffer in smaller chunks than this size. If using the AudioTrack in static mode, 4017f6ee760b0aee76bdb9fe61ac7ed1465c0da3489Jean-Michel Trivi * this is the maximum size of the sound that will be played for this instance. 4027f6ee760b0aee76bdb9fe61ac7ed1465c0da3489Jean-Michel Trivi * See {@link #getMinBufferSize(int, int, int)} to determine the minimum required buffer size 4037f6ee760b0aee76bdb9fe61ac7ed1465c0da3489Jean-Michel Trivi * for the successful creation of an AudioTrack instance in streaming mode. Using values 4047f6ee760b0aee76bdb9fe61ac7ed1465c0da3489Jean-Michel Trivi * smaller than getMinBufferSize() will result in an initialization failure. 4057f6ee760b0aee76bdb9fe61ac7ed1465c0da3489Jean-Michel Trivi * @param mode streaming or static buffer. See {@link #MODE_STATIC} and {@link #MODE_STREAM}. 406289cc8e887f786f557faab226a1e01abb9a632a6Jean-Michel Trivi * @param sessionId ID of audio session the AudioTrack must be attached to, or 407289cc8e887f786f557faab226a1e01abb9a632a6Jean-Michel Trivi * {@link AudioManager#AUDIO_SESSION_ID_GENERATE} if the session isn't known at construction 408289cc8e887f786f557faab226a1e01abb9a632a6Jean-Michel Trivi * time. See also {@link AudioManager#generateAudioSessionId()} to obtain a session ID before 409289cc8e887f786f557faab226a1e01abb9a632a6Jean-Michel Trivi * construction. 4107f6ee760b0aee76bdb9fe61ac7ed1465c0da3489Jean-Michel Trivi * @throws IllegalArgumentException 411a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi */ 412a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi public AudioTrack(AudioAttributes attributes, AudioFormat format, int bufferSizeInBytes, 413a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi int mode, int sessionId) 414a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi throws IllegalArgumentException { 415a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi // mState already == STATE_UNINITIALIZED 4165c17a820f9e46e0756c11795b3e6f89105f2f539Glenn Kasten 4177f6ee760b0aee76bdb9fe61ac7ed1465c0da3489Jean-Michel Trivi if (attributes == null) { 4187f6ee760b0aee76bdb9fe61ac7ed1465c0da3489Jean-Michel Trivi throw new IllegalArgumentException("Illegal null AudioAttributes"); 4197f6ee760b0aee76bdb9fe61ac7ed1465c0da3489Jean-Michel Trivi } 4207f6ee760b0aee76bdb9fe61ac7ed1465c0da3489Jean-Michel Trivi if (format == null) { 4217f6ee760b0aee76bdb9fe61ac7ed1465c0da3489Jean-Michel Trivi throw new IllegalArgumentException("Illegal null AudioFormat"); 4227f6ee760b0aee76bdb9fe61ac7ed1465c0da3489Jean-Michel Trivi } 4237f6ee760b0aee76bdb9fe61ac7ed1465c0da3489Jean-Michel Trivi 4245c17a820f9e46e0756c11795b3e6f89105f2f539Glenn Kasten // remember which looper is associated with the AudioTrack instantiation 425b09707a041957f055cee3d290c85763cfef8d986Glenn Kasten Looper looper; 426b09707a041957f055cee3d290c85763cfef8d986Glenn Kasten if ((looper = Looper.myLooper()) == null) { 427b09707a041957f055cee3d290c85763cfef8d986Glenn Kasten looper = Looper.getMainLooper(); 428105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project } 4299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 430a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi int rate = 0; 431a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi if ((format.getPropertySetMask() & AudioFormat.AUDIO_FORMAT_HAS_PROPERTY_SAMPLE_RATE) != 0) 432a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi { 433a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi rate = format.getSampleRate(); 434a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi } else { 435a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi rate = AudioSystem.getPrimaryOutputSamplingRate(); 436a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi if (rate <= 0) { 437a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi rate = 44100; 438a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi } 439a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi } 440a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung int channelIndexMask = 0; 441a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung if ((format.getPropertySetMask() 442a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung & AudioFormat.AUDIO_FORMAT_HAS_PROPERTY_CHANNEL_INDEX_MASK) != 0) { 443a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung channelIndexMask = format.getChannelIndexMask(); 444a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung } 445a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung int channelMask = 0; 446a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung if ((format.getPropertySetMask() 447a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung & AudioFormat.AUDIO_FORMAT_HAS_PROPERTY_CHANNEL_MASK) != 0) { 448a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi channelMask = format.getChannelMask(); 449a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung } else if (channelIndexMask == 0) { // if no masks at all, use stereo 450a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung channelMask = AudioFormat.CHANNEL_OUT_FRONT_LEFT 451a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung | AudioFormat.CHANNEL_OUT_FRONT_RIGHT; 452a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi } 453a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi int encoding = AudioFormat.ENCODING_DEFAULT; 454a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi if ((format.getPropertySetMask() & AudioFormat.AUDIO_FORMAT_HAS_PROPERTY_ENCODING) != 0) { 455a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi encoding = format.getEncoding(); 456a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi } 457a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung audioParamCheck(rate, channelMask, channelIndexMask, encoding, mode); 458a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi mStreamType = AudioSystem.STREAM_DEFAULT; 4599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project audioBuffSizeCheck(bufferSizeInBytes); 4619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 462a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi mInitializationLooper = looper; 4631af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlock IBinder b = ServiceManager.getService(Context.APP_OPS_SERVICE); 4641af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlock mAppOps = IAppOpsService.Stub.asInterface(b); 4651af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlock 466a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi mAttributes = (new AudioAttributes.Builder(attributes).build()); 467a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi 468619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent if (sessionId < 0) { 469f4e58051e22ad4e21c7cd436c37cc5665c194d1cGlenn Kasten throw new IllegalArgumentException("Invalid audio session ID: "+sessionId); 470619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent } 471619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent 472619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent int[] session = new int[1]; 473619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent session[0] = sessionId; 4749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // native initialization 475a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi int initResult = native_setup(new WeakReference<AudioTrack>(this), mAttributes, 476a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi mSampleRate, mChannels, mAudioFormat, 477619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent mNativeBufferSizeInBytes, mDataLoadMode, session); 4789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (initResult != SUCCESS) { 4799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project loge("Error code "+initResult+" when initializing AudioTrack."); 4809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return; // with mState == STATE_UNINITIALIZED 4819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 483619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent mSessionId = session[0]; 484619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent 4859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mDataLoadMode == MODE_STATIC) { 4869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mState = STATE_NO_STATIC_DATA; 4879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 4889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mState = STATE_INITIALIZED; 4899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 49235ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi /** 49335ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * Builder class for {@link AudioTrack} objects. 49435ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * Use this class to configure and create an <code>AudioTrack</code> instance. By setting audio 49535ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * attributes and audio format parameters, you indicate which of those vary from the default 49635ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * behavior on the device. 49735ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * <p> Here is an example where <code>Builder</code> is used to specify all {@link AudioFormat} 49835ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * parameters, to be used by a new <code>AudioTrack</code> instance: 49935ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * 50035ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * <pre class="prettyprint"> 50135ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * AudioTrack player = new AudioTrack.Builder() 50235ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * .setAudioAttributes(new AudioAttributes.Builder() 50335ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * .setUsage(AudioAttributes.USAGE_ALARM) 50435ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * .setContentType(CONTENT_TYPE_MUSIC) 50535ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * .build()) 50635ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * .setAudioFormat(new AudioFormat.Builder() 50735ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * .setEncoding(AudioFormat.ENCODING_PCM_16BIT) 50835ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * .setSampleRate(441000) 50935ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * .setChannelMask(AudioFormat.CHANNEL_OUT_STEREO) 51035ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * .build()) 51135ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * .setBufferSize(minBuffSize) 51235ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * .build(); 51335ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * </pre> 51435ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * <p> 51535ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * If the audio attributes are not set with {@link #setAudioAttributes(AudioAttributes)}, 51635ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * attributes comprising {@link AudioAttributes#USAGE_MEDIA} will be used. 51735ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * <br>If the audio format is not specified or is incomplete, its sample rate will be the 51835ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * default output sample rate of the device (see 51935ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * {@link AudioManager#PROPERTY_OUTPUT_SAMPLE_RATE}), its channel configuration will be 52035ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * {@link AudioFormat#CHANNEL_OUT_STEREO} and the encoding will be 52135ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * {@link AudioFormat#ENCODING_PCM_16BIT}. 5224bd513e6ed168811c97dbc83cd5a7c7cc43caffeAndy Hung * <br>If the buffer size is not specified with {@link #setBufferSizeInBytes(int)}, 5234bd513e6ed168811c97dbc83cd5a7c7cc43caffeAndy Hung * and the mode is {@link AudioTrack#MODE_STREAM}, the minimum buffer size is used. 52435ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * <br>If the transfer mode is not specified with {@link #setTransferMode(int)}, 5254bd513e6ed168811c97dbc83cd5a7c7cc43caffeAndy Hung * <code>MODE_STREAM</code> will be used. 52635ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * <br>If the session ID is not specified with {@link #setSessionId(int)}, a new one will 52735ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * be generated. 52835ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi */ 52935ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi public static class Builder { 53035ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi private AudioAttributes mAttributes; 53135ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi private AudioFormat mFormat; 53235ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi private int mBufferSizeInBytes; 53335ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi private int mSessionId = AudioManager.AUDIO_SESSION_ID_GENERATE; 53435ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi private int mMode = MODE_STREAM; 53535ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi 53635ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi /** 53735ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * Constructs a new Builder with the default values as described above. 53835ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi */ 53935ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi public Builder() { 54035ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi } 54135ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi 54235ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi /** 54335ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * Sets the {@link AudioAttributes}. 54435ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * @param attributes a non-null {@link AudioAttributes} instance that describes the audio 54535ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * data to be played. 54635ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * @return the same Builder instance. 54735ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * @throws IllegalArgumentException 54835ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi */ 54935ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi public @NonNull Builder setAudioAttributes(@NonNull AudioAttributes attributes) 55035ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi throws IllegalArgumentException { 55135ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi if (attributes == null) { 55235ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi throw new IllegalArgumentException("Illegal null AudioAttributes argument"); 55335ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi } 55435ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi // keep reference, we only copy the data when building 55535ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi mAttributes = attributes; 55635ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi return this; 55735ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi } 55835ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi 55935ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi /** 56035ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * Sets the format of the audio data to be played by the {@link AudioTrack}. 56135ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * See {@link AudioFormat.Builder} for configuring the audio format parameters such 56235ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * as encoding, channel mask and sample rate. 56335ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * @param format a non-null {@link AudioFormat} instance. 56435ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * @return the same Builder instance. 56535ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * @throws IllegalArgumentException 56635ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi */ 56735ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi public @NonNull Builder setAudioFormat(@NonNull AudioFormat format) 56835ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi throws IllegalArgumentException { 56935ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi if (format == null) { 57035ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi throw new IllegalArgumentException("Illegal null AudioFormat argument"); 57135ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi } 57235ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi // keep reference, we only copy the data when building 57335ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi mFormat = format; 57435ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi return this; 57535ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi } 57635ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi 57735ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi /** 57835ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * Sets the total size (in bytes) of the buffer where audio data is read from for playback. 57935ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * If using the {@link AudioTrack} in streaming mode 58035ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * (see {@link AudioTrack#MODE_STREAM}, you can write data into this buffer in smaller 58135ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * chunks than this size. See {@link #getMinBufferSize(int, int, int)} to determine 58235ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * the minimum required buffer size for the successful creation of an AudioTrack instance 58335ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * in streaming mode. Using values smaller than <code>getMinBufferSize()</code> will result 58435ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * in an exception when trying to build the <code>AudioTrack</code>. 58535ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * <br>If using the <code>AudioTrack</code> in static mode (see 58635ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * {@link AudioTrack#MODE_STATIC}), this is the maximum size of the sound that will be 58735ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * played by this instance. 58835ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * @param bufferSizeInBytes 58935ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * @return the same Builder instance. 59035ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * @throws IllegalArgumentException 59135ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi */ 59235ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi public @NonNull Builder setBufferSizeInBytes(int bufferSizeInBytes) 59335ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi throws IllegalArgumentException { 59435ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi if (bufferSizeInBytes <= 0) { 59535ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi throw new IllegalArgumentException("Invalid buffer size " + bufferSizeInBytes); 59635ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi } 59735ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi mBufferSizeInBytes = bufferSizeInBytes; 59835ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi return this; 59935ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi } 60035ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi 60135ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi /** 60235ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * Sets the mode under which buffers of audio data are transferred from the 60335ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * {@link AudioTrack} to the framework. 60435ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * @param mode one of {@link AudioTrack#MODE_STREAM}, {@link AudioTrack#MODE_STATIC}. 60535ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * @return the same Builder instance. 60635ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * @throws IllegalArgumentException 60735ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi */ 60835ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi public @NonNull Builder setTransferMode(@TransferMode int mode) 60935ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi throws IllegalArgumentException { 61035ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi switch(mode) { 61135ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi case MODE_STREAM: 61235ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi case MODE_STATIC: 61335ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi mMode = mode; 61435ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi break; 61535ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi default: 61635ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi throw new IllegalArgumentException("Invalid transfer mode " + mode); 61735ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi } 61835ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi return this; 61935ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi } 62035ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi 62135ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi /** 62235ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * Sets the session ID the {@link AudioTrack} will be attached to. 62335ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * @param sessionId a strictly positive ID number retrieved from another 62435ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * <code>AudioTrack</code> via {@link AudioTrack#getAudioSessionId()} or allocated by 62535ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * {@link AudioManager} via {@link AudioManager#generateAudioSessionId()}, or 62635ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * {@link AudioManager#AUDIO_SESSION_ID_GENERATE}. 62735ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * @return the same Builder instance. 62835ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * @throws IllegalArgumentException 62935ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi */ 63035ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi public @NonNull Builder setSessionId(int sessionId) 63135ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi throws IllegalArgumentException { 63235ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi if ((sessionId != AudioManager.AUDIO_SESSION_ID_GENERATE) && (sessionId < 1)) { 63335ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi throw new IllegalArgumentException("Invalid audio session ID " + sessionId); 63435ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi } 63535ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi mSessionId = sessionId; 63635ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi return this; 63735ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi } 63835ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi 63935ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi /** 64035ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * Builds an {@link AudioTrack} instance initialized with all the parameters set 64135ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * on this <code>Builder</code>. 64235ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * @return a new {@link AudioTrack} instance. 64335ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * @throws UnsupportedOperationException if the parameters set on the <code>Builder</code> 64435ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * were incompatible, or if they are not supported by the device. 64535ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi */ 64635ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi public @NonNull AudioTrack build() throws UnsupportedOperationException { 64735ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi if (mAttributes == null) { 64835ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi mAttributes = new AudioAttributes.Builder() 64935ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi .setUsage(AudioAttributes.USAGE_MEDIA) 65035ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi .build(); 65135ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi } 65235ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi if (mFormat == null) { 65335ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi mFormat = new AudioFormat.Builder() 65435ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi .setChannelMask(AudioFormat.CHANNEL_OUT_STEREO) 65535ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi .setSampleRate(AudioSystem.getPrimaryOutputSamplingRate()) 65635ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi .setEncoding(AudioFormat.ENCODING_DEFAULT) 65735ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi .build(); 65835ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi } 65935ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi try { 6604bd513e6ed168811c97dbc83cd5a7c7cc43caffeAndy Hung // If the buffer size is not specified in streaming mode, 6614bd513e6ed168811c97dbc83cd5a7c7cc43caffeAndy Hung // use a single frame for the buffer size and let the 6624bd513e6ed168811c97dbc83cd5a7c7cc43caffeAndy Hung // native code figure out the minimum buffer size. 6634bd513e6ed168811c97dbc83cd5a7c7cc43caffeAndy Hung if (mMode == MODE_STREAM && mBufferSizeInBytes == 0) { 6644bd513e6ed168811c97dbc83cd5a7c7cc43caffeAndy Hung mBufferSizeInBytes = mFormat.getChannelCount() 6654bd513e6ed168811c97dbc83cd5a7c7cc43caffeAndy Hung * mFormat.getBytesPerSample(mFormat.getEncoding()); 6664bd513e6ed168811c97dbc83cd5a7c7cc43caffeAndy Hung } 66735ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi return new AudioTrack(mAttributes, mFormat, mBufferSizeInBytes, mMode, mSessionId); 66835ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi } catch (IllegalArgumentException e) { 66935ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi throw new UnsupportedOperationException(e.getMessage()); 67035ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi } 67135ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi } 67235ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi } 67335ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi 6741b8f499a14a4340d3422d95c7f6fdc8c0c72b3a4Jean-Michel Trivi // mask of all the channels supported by this implementation 6751b8f499a14a4340d3422d95c7f6fdc8c0c72b3a4Jean-Michel Trivi private static final int SUPPORTED_OUT_CHANNELS = 6761b8f499a14a4340d3422d95c7f6fdc8c0c72b3a4Jean-Michel Trivi AudioFormat.CHANNEL_OUT_FRONT_LEFT | 6771b8f499a14a4340d3422d95c7f6fdc8c0c72b3a4Jean-Michel Trivi AudioFormat.CHANNEL_OUT_FRONT_RIGHT | 6781b8f499a14a4340d3422d95c7f6fdc8c0c72b3a4Jean-Michel Trivi AudioFormat.CHANNEL_OUT_FRONT_CENTER | 6791b8f499a14a4340d3422d95c7f6fdc8c0c72b3a4Jean-Michel Trivi AudioFormat.CHANNEL_OUT_LOW_FREQUENCY | 6801b8f499a14a4340d3422d95c7f6fdc8c0c72b3a4Jean-Michel Trivi AudioFormat.CHANNEL_OUT_BACK_LEFT | 6811b8f499a14a4340d3422d95c7f6fdc8c0c72b3a4Jean-Michel Trivi AudioFormat.CHANNEL_OUT_BACK_RIGHT | 682ad720aeea741d9058a7b4d326c9ab1b3ebcd7c62Andy Hung AudioFormat.CHANNEL_OUT_BACK_CENTER | 683ad720aeea741d9058a7b4d326c9ab1b3ebcd7c62Andy Hung AudioFormat.CHANNEL_OUT_SIDE_LEFT | 684ad720aeea741d9058a7b4d326c9ab1b3ebcd7c62Andy Hung AudioFormat.CHANNEL_OUT_SIDE_RIGHT; 6859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 686a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung // Java channel mask definitions below match those 687a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung // in /system/core/include/system/audio.h in the JNI code of AudioTrack. 688a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung 689a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung // internal maximum size for bits parameter, not part of public API 690a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung private static final int AUDIO_CHANNEL_BITS_LOG2 = 30; 691a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung 692a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung // log(2) of maximum number of representations, not part of public API 693a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung private static final int AUDIO_CHANNEL_REPRESENTATION_LOG2 = 2; 694a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung 695a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung // used to create a channel index mask or channel position mask 696a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung // with getChannelMaskFromRepresentationAndBits(); 697a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung private static final int CHANNEL_OUT_REPRESENTATION_POSITION = 0; 698a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung private static final int CHANNEL_OUT_REPRESENTATION_INDEX = 2; 699a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung 700a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung /** 701a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung * Return the channel mask from its representation and bits. 702a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung * 703a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung * This creates a channel mask for mChannels which combines a 704a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung * representation field and a bits field. This is for internal 705a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung * communication to native code, not part of the public API. 706a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung * 707a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung * @param representation the type of channel mask, 708a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung * either CHANNEL_OUT_REPRESENTATION_POSITION 709a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung * or CHANNEL_OUT_REPRESENTATION_INDEX 710a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung * @param bits is the channel bits specifying occupancy 711a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung * @return the channel mask 712a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung * @throws java.lang.IllegalArgumentException if representation is not recognized or 713a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung * the bits field is not acceptable for that representation 714a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung */ 715a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung private static int getChannelMaskFromRepresentationAndBits(int representation, int bits) { 716a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung switch (representation) { 717a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung case CHANNEL_OUT_REPRESENTATION_POSITION: 718a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung case CHANNEL_OUT_REPRESENTATION_INDEX: 719a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung if ((bits & ~((1 << AUDIO_CHANNEL_BITS_LOG2) - 1)) != 0) { 720a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung throw new IllegalArgumentException("invalid bits " + bits); 721a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung } 722a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung return representation << AUDIO_CHANNEL_BITS_LOG2 | bits; 723a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung default: 724a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung throw new IllegalArgumentException("invalid representation " + representation); 725a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung } 726a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung } 727a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung 7289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Convenience method for the constructor's parameter checks. 7299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // This is where constructor IllegalArgumentException-s are thrown 7309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // postconditions: 7319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // mChannelCount is valid 7323026a023b8979b7ddcb3fe97bbc45531c89fda92Eric Laurent // mChannels is valid 7339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // mAudioFormat is valid 7349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // mSampleRate is valid 7359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // mDataLoadMode is valid 736a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung private void audioParamCheck(int sampleRateInHz, int channelConfig, int channelIndexMask, 737a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung int audioFormat, int mode) { 7389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //-------------- 7395c17a820f9e46e0756c11795b3e6f89105f2f539Glenn Kasten // sample rate, note these values are subject to change 7409e4a66d69673adcf5f32e4b121809322d9ffd97cAndy Hung if (sampleRateInHz < SAMPLE_RATE_HZ_MIN || sampleRateInHz > SAMPLE_RATE_HZ_MAX) { 741f4e58051e22ad4e21c7cd436c37cc5665c194d1cGlenn Kasten throw new IllegalArgumentException(sampleRateInHz 742f4e58051e22ad4e21c7cd436c37cc5665c194d1cGlenn Kasten + "Hz is not a supported sample rate."); 7439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 744896a7f5fee46c24d31e9403abdf5813e4bb84ca5Glenn Kasten mSampleRate = sampleRateInHz; 7459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //-------------- 7479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // channel config 7483026a023b8979b7ddcb3fe97bbc45531c89fda92Eric Laurent mChannelConfiguration = channelConfig; 7493026a023b8979b7ddcb3fe97bbc45531c89fda92Eric Laurent 7509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project switch (channelConfig) { 7513026a023b8979b7ddcb3fe97bbc45531c89fda92Eric Laurent case AudioFormat.CHANNEL_OUT_DEFAULT: //AudioFormat.CHANNEL_CONFIGURATION_DEFAULT 752a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent case AudioFormat.CHANNEL_OUT_MONO: 7533026a023b8979b7ddcb3fe97bbc45531c89fda92Eric Laurent case AudioFormat.CHANNEL_CONFIGURATION_MONO: 7549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mChannelCount = 1; 7553026a023b8979b7ddcb3fe97bbc45531c89fda92Eric Laurent mChannels = AudioFormat.CHANNEL_OUT_MONO; 7569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project break; 757a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent case AudioFormat.CHANNEL_OUT_STEREO: 7583026a023b8979b7ddcb3fe97bbc45531c89fda92Eric Laurent case AudioFormat.CHANNEL_CONFIGURATION_STEREO: 7599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mChannelCount = 2; 7603026a023b8979b7ddcb3fe97bbc45531c89fda92Eric Laurent mChannels = AudioFormat.CHANNEL_OUT_STEREO; 7619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project break; 7629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project default: 763a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung if (channelConfig == AudioFormat.CHANNEL_INVALID && channelIndexMask != 0) { 764a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung mChannelCount = 0; 765a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung break; // channel index configuration only 766a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung } 767d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi if (!isMultichannelConfigSupported(channelConfig)) { 7681b8f499a14a4340d3422d95c7f6fdc8c0c72b3a4Jean-Michel Trivi // input channel configuration features unsupported channels 769f4e58051e22ad4e21c7cd436c37cc5665c194d1cGlenn Kasten throw new IllegalArgumentException("Unsupported channel configuration."); 7701b8f499a14a4340d3422d95c7f6fdc8c0c72b3a4Jean-Michel Trivi } 771896a7f5fee46c24d31e9403abdf5813e4bb84ca5Glenn Kasten mChannels = channelConfig; 7728528ed43b41ff02535675c5da7425bef5195e73bAndy Hung mChannelCount = AudioFormat.channelCountFromOutChannelMask(channelConfig); 7739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 774a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung // check the channel index configuration (if present) 775a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung mChannelIndexMask = channelIndexMask; 776a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung if (mChannelIndexMask != 0) { 777a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung // restrictive: indexMask could allow up to AUDIO_CHANNEL_BITS_LOG2 778a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung final int indexMask = (1 << CHANNEL_COUNT_MAX) - 1; 779a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung if ((channelIndexMask & ~indexMask) != 0) { 780a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung throw new IllegalArgumentException("Unsupported channel index configuration " 781a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung + channelIndexMask); 782a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung } 783a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung int channelIndexCount = Integer.bitCount(channelIndexMask); 784a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung if (mChannelCount == 0) { 785a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung mChannelCount = channelIndexCount; 786a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung } else if (mChannelCount != channelIndexCount) { 787a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung throw new IllegalArgumentException("Channel count must match"); 788a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung } 789a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung 790a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung // AudioTrack prefers to use the channel index configuration 791a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung // over the channel position configuration if both are specified. 792a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung mChannels = getChannelMaskFromRepresentationAndBits( 793a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung CHANNEL_OUT_REPRESENTATION_INDEX, mChannelIndexMask); 794a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung } 7959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //-------------- 7979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // audio format 798ff0d9f098e51c54e1a030ed21fd980680cb7b405Eric Laurent if (audioFormat == AudioFormat.ENCODING_DEFAULT) { 799ff0d9f098e51c54e1a030ed21fd980680cb7b405Eric Laurent audioFormat = AudioFormat.ENCODING_PCM_16BIT; 800ff0d9f098e51c54e1a030ed21fd980680cb7b405Eric Laurent } 801ff0d9f098e51c54e1a030ed21fd980680cb7b405Eric Laurent 802ff0d9f098e51c54e1a030ed21fd980680cb7b405Eric Laurent if (!AudioFormat.isValidEncoding(audioFormat)) { 803ff0d9f098e51c54e1a030ed21fd980680cb7b405Eric Laurent throw new IllegalArgumentException("Unsupported audio encoding."); 8049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 805ff0d9f098e51c54e1a030ed21fd980680cb7b405Eric Laurent mAudioFormat = audioFormat; 8069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //-------------- 8089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // audio load mode 809ff0d9f098e51c54e1a030ed21fd980680cb7b405Eric Laurent if (((mode != MODE_STREAM) && (mode != MODE_STATIC)) || 810ff0d9f098e51c54e1a030ed21fd980680cb7b405Eric Laurent ((mode != MODE_STREAM) && !AudioFormat.isEncodingLinearPcm(mAudioFormat))) { 811f4e58051e22ad4e21c7cd436c37cc5665c194d1cGlenn Kasten throw new IllegalArgumentException("Invalid mode."); 8129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 813896a7f5fee46c24d31e9403abdf5813e4bb84ca5Glenn Kasten mDataLoadMode = mode; 8149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 816d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi /** 817d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi * Convenience method to check that the channel configuration (a.k.a channel mask) is supported 818d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi * @param channelConfig the mask to validate 819d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi * @return false if the AudioTrack can't be used with such a mask 820d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi */ 821d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi private static boolean isMultichannelConfigSupported(int channelConfig) { 822d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi // check for unsupported channels 823d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi if ((channelConfig & SUPPORTED_OUT_CHANNELS) != channelConfig) { 8241f61d01508651b4475397414e1fe06af1ab8fadaGlenn Kasten loge("Channel configuration features unsupported channels"); 825d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi return false; 826d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi } 8278528ed43b41ff02535675c5da7425bef5195e73bAndy Hung final int channelCount = AudioFormat.channelCountFromOutChannelMask(channelConfig); 828ad720aeea741d9058a7b4d326c9ab1b3ebcd7c62Andy Hung if (channelCount > CHANNEL_COUNT_MAX) { 829ad720aeea741d9058a7b4d326c9ab1b3ebcd7c62Andy Hung loge("Channel configuration contains too many channels " + 830ad720aeea741d9058a7b4d326c9ab1b3ebcd7c62Andy Hung channelCount + ">" + CHANNEL_COUNT_MAX); 831ad720aeea741d9058a7b4d326c9ab1b3ebcd7c62Andy Hung return false; 832ad720aeea741d9058a7b4d326c9ab1b3ebcd7c62Andy Hung } 833d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi // check for unsupported multichannel combinations: 834d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi // - FL/FR must be present 835d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi // - L/R channels must be paired (e.g. no single L channel) 836d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi final int frontPair = 837d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi AudioFormat.CHANNEL_OUT_FRONT_LEFT | AudioFormat.CHANNEL_OUT_FRONT_RIGHT; 838d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi if ((channelConfig & frontPair) != frontPair) { 8391f61d01508651b4475397414e1fe06af1ab8fadaGlenn Kasten loge("Front channels must be present in multichannel configurations"); 840d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi return false; 841d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi } 842d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi final int backPair = 843d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi AudioFormat.CHANNEL_OUT_BACK_LEFT | AudioFormat.CHANNEL_OUT_BACK_RIGHT; 844d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi if ((channelConfig & backPair) != 0) { 845d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi if ((channelConfig & backPair) != backPair) { 8461f61d01508651b4475397414e1fe06af1ab8fadaGlenn Kasten loge("Rear channels can't be used independently"); 847d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi return false; 848d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi } 849d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi } 850ad720aeea741d9058a7b4d326c9ab1b3ebcd7c62Andy Hung final int sidePair = 851ad720aeea741d9058a7b4d326c9ab1b3ebcd7c62Andy Hung AudioFormat.CHANNEL_OUT_SIDE_LEFT | AudioFormat.CHANNEL_OUT_SIDE_RIGHT; 852ad720aeea741d9058a7b4d326c9ab1b3ebcd7c62Andy Hung if ((channelConfig & sidePair) != 0 853ad720aeea741d9058a7b4d326c9ab1b3ebcd7c62Andy Hung && (channelConfig & sidePair) != sidePair) { 854ad720aeea741d9058a7b4d326c9ab1b3ebcd7c62Andy Hung loge("Side channels can't be used independently"); 855ad720aeea741d9058a7b4d326c9ab1b3ebcd7c62Andy Hung return false; 856ad720aeea741d9058a7b4d326c9ab1b3ebcd7c62Andy Hung } 857d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi return true; 858d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi } 859d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi 8609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 861e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten // Convenience method for the constructor's audio buffer size check. 8629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // preconditions: 8639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // mChannelCount is valid 8649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // mAudioFormat is valid 8659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // postcondition: 8669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // mNativeBufferSizeInBytes is valid (multiple of frame size, positive) 8679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private void audioBuffSizeCheck(int audioBufferSize) { 8689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // NB: this section is only valid with PCM data. 8699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // To update when supporting compressed formats 870ff0d9f098e51c54e1a030ed21fd980680cb7b405Eric Laurent int frameSizeInBytes; 871ff0d9f098e51c54e1a030ed21fd980680cb7b405Eric Laurent if (AudioFormat.isEncodingLinearPcm(mAudioFormat)) { 872ff0d9f098e51c54e1a030ed21fd980680cb7b405Eric Laurent frameSizeInBytes = mChannelCount 873ff0d9f098e51c54e1a030ed21fd980680cb7b405Eric Laurent * (AudioFormat.getBytesPerSample(mAudioFormat)); 874ff0d9f098e51c54e1a030ed21fd980680cb7b405Eric Laurent } else { 875ff0d9f098e51c54e1a030ed21fd980680cb7b405Eric Laurent frameSizeInBytes = 1; 876ff0d9f098e51c54e1a030ed21fd980680cb7b405Eric Laurent } 8779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if ((audioBufferSize % frameSizeInBytes != 0) || (audioBufferSize < 1)) { 878f4e58051e22ad4e21c7cd436c37cc5665c194d1cGlenn Kasten throw new IllegalArgumentException("Invalid audio buffer size."); 8799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mNativeBufferSizeInBytes = audioBufferSize; 882e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten mNativeBufferSizeInFrames = audioBufferSize / frameSizeInBytes; 8839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Releases the native AudioTrack resources. 8889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void release() { 8909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // even though native_release() stops the native AudioTrack, we need to stop 8919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // AudioTrack subclasses too. 8929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 8939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project stop(); 894fb2ab9efc3805c81521afb9ff91a58ff5097a36eGlenn Kasten } catch(IllegalStateException ise) { 8959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // don't raise an exception, we're releasing the resources. 8969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project native_release(); 8989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mState = STATE_UNINITIALIZED; 8999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 9029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project protected void finalize() { 9039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project native_finalize(); 9049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //-------------------------------------------------------------------------- 9079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Getters 9089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //-------------------- 9099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 91078cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * Returns the minimum gain value, which is the constant 0.0. 91178cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * Gain values less than 0.0 will be clamped to 0.0. 91278cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * <p>The word "volume" in the API name is historical; this is actually a linear gain. 91378cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * @return the minimum value, which is the constant 0.0. 9149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project static public float getMinVolume() { 91678cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten return GAIN_MIN; 9179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 92078cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * Returns the maximum gain value, which is greater than or equal to 1.0. 92178cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * Gain values greater than the maximum will be clamped to the maximum. 92278cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * <p>The word "volume" in the API name is historical; this is actually a gain. 92378cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * expressed as a linear multiplier on sample values, where a maximum value of 1.0 92478cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * corresponds to a gain of 0 dB (sample values left unmodified). 92578cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * @return the maximum value, which is greater than or equal to 1.0. 9269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project static public float getMaxVolume() { 92878cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten return GAIN_MAX; 9299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the configured audio data sample rate in Hz 9339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getSampleRate() { 9359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mSampleRate; 9369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 937fb2ab9efc3805c81521afb9ff91a58ff5097a36eGlenn Kasten 9389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 93988e209dcf8c2ebddda5c272f46d1bd5478bc639cEric Laurent * Returns the current playback rate in Hz. 9409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getPlaybackRate() { 9429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return native_get_playback_rate(); 9439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the configured audio data format. See {@link AudioFormat#ENCODING_PCM_16BIT} 9479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * and {@link AudioFormat#ENCODING_PCM_8BIT}. 9489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getAudioFormat() { 9509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mAudioFormat; 9519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the type of audio stream this AudioTrack is configured for. 9559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Compare the result against {@link AudioManager#STREAM_VOICE_CALL}, 9569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link AudioManager#STREAM_SYSTEM}, {@link AudioManager#STREAM_RING}, 9575c17a820f9e46e0756c11795b3e6f89105f2f539Glenn Kasten * {@link AudioManager#STREAM_MUSIC}, {@link AudioManager#STREAM_ALARM}, 958b282e08ab641d4fc74d0324b7a0ce30926638dd5Glenn Kasten * {@link AudioManager#STREAM_NOTIFICATION}, or {@link AudioManager#STREAM_DTMF}. 9599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getStreamType() { 9619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mStreamType; 9629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 965a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung * Returns the configured channel position mask. 966a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung * For example, refer to {@link AudioFormat#CHANNEL_OUT_MONO}, 967a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung * {@link AudioFormat#CHANNEL_OUT_STEREO}, {@link AudioFormat#CHANNEL_OUT_5POINT1}. 9689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getChannelConfiguration() { 9709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mChannelConfiguration; 9719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the configured number of channels. 9759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getChannelCount() { 9779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mChannelCount; 9789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the state of the AudioTrack instance. This is useful after the 9829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * AudioTrack instance has been created to check if it was initialized 983e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * properly. This ensures that the appropriate resources have been acquired. 984ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * @see #STATE_INITIALIZED 985ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * @see #STATE_NO_STATIC_DATA 986ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * @see #STATE_UNINITIALIZED 9879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getState() { 9899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mState; 9909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the playback state of the AudioTrack instance. 9949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #PLAYSTATE_STOPPED 9959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #PLAYSTATE_PAUSED 9969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #PLAYSTATE_PLAYING 9979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getPlayState() { 99906e0333c7eb50533cc6e0f7b61812d2840844296Narayan Kamath synchronized (mPlayStateLock) { 100006e0333c7eb50533cc6e0f7b61812d2840844296Narayan Kamath return mPlayState; 100106e0333c7eb50533cc6e0f7b61812d2840844296Narayan Kamath } 10029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 10054bd513e6ed168811c97dbc83cd5a7c7cc43caffeAndy Hung * Returns the "native frame count" of the <code>AudioTrack</code> buffer. 10064bd513e6ed168811c97dbc83cd5a7c7cc43caffeAndy Hung * <p> If the track's creation mode is {@link #MODE_STATIC}, 10074bd513e6ed168811c97dbc83cd5a7c7cc43caffeAndy Hung * it is equal to the specified bufferSizeInBytes on construction, converted to frame units. 10084bd513e6ed168811c97dbc83cd5a7c7cc43caffeAndy Hung * A static track's native frame count will not change. 10094bd513e6ed168811c97dbc83cd5a7c7cc43caffeAndy Hung * <p> If the track's creation mode is {@link #MODE_STREAM}, 10104bd513e6ed168811c97dbc83cd5a7c7cc43caffeAndy Hung * it is greater than or equal to the specified bufferSizeInBytes converted to frame units. 10114bd513e6ed168811c97dbc83cd5a7c7cc43caffeAndy Hung * For streaming tracks, this value may be rounded up to a larger value if needed by 10124bd513e6ed168811c97dbc83cd5a7c7cc43caffeAndy Hung * the target output sink, and 10134bd513e6ed168811c97dbc83cd5a7c7cc43caffeAndy Hung * if the track is subsequently routed to a different output sink, the native 10144bd513e6ed168811c97dbc83cd5a7c7cc43caffeAndy Hung * frame count may enlarge to accommodate. 10154bd513e6ed168811c97dbc83cd5a7c7cc43caffeAndy Hung * See also {@link AudioManager#getProperty(String)} for key 101655a3218f242a611afb3569d88970c0c5dbf8ce54Glenn Kasten * {@link AudioManager#PROPERTY_OUTPUT_FRAMES_PER_BUFFER}. 10174bd513e6ed168811c97dbc83cd5a7c7cc43caffeAndy Hung * @return current size in frames of the audio track buffer. 10184bd513e6ed168811c97dbc83cd5a7c7cc43caffeAndy Hung * @throws IllegalStateException 10199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 10204bd513e6ed168811c97dbc83cd5a7c7cc43caffeAndy Hung public int getNativeFrameCount() throws IllegalStateException { 10219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return native_get_native_frame_count(); 10229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1025ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * Returns marker position expressed in frames. 1026e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * @return marker position in wrapping frame units similar to {@link #getPlaybackHeadPosition}, 1027e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * or zero if marker is disabled. 10289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 10299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getNotificationMarkerPosition() { 10309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return native_get_marker_pos(); 10319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1034ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * Returns the notification update period expressed in frames. 1035e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * Zero means that no position update notifications are being delivered. 10369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 10379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getPositionNotificationPeriod() { 10389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return native_get_pos_update_period(); 10399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1042e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * Returns the playback head position expressed in frames. 1043e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * Though the "int" type is signed 32-bits, the value should be reinterpreted as if it is 1044e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * unsigned 32-bits. That is, the next position after 0x7FFFFFFF is (int) 0x80000000. 1045e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * This is a continuously advancing counter. It will wrap (overflow) periodically, 1046e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * for example approximately once every 27:03:11 hours:minutes:seconds at 44.1 kHz. 1047ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * It is reset to zero by {@link #flush()}, {@link #reloadStaticData()}, and {@link #stop()}. 1048ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * If the track's creation mode is {@link #MODE_STATIC}, the return value indicates 1049ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * the total number of frames played since reset, 1050ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * <i>not</i> the current offset within the buffer. 10519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 10529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getPlaybackHeadPosition() { 10539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return native_get_position(); 10549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 105761dcdf3764b614c6f01e77cb4342d192e3101f8aOliver Woodman * Returns this track's estimated latency in milliseconds. This includes the latency due 105861dcdf3764b614c6f01e77cb4342d192e3101f8aOliver Woodman * to AudioTrack buffer size, AudioMixer (if any) and audio hardware driver. 105961dcdf3764b614c6f01e77cb4342d192e3101f8aOliver Woodman * 106061dcdf3764b614c6f01e77cb4342d192e3101f8aOliver Woodman * DO NOT UNHIDE. The existing approach for doing A/V sync has too many problems. We need 106161dcdf3764b614c6f01e77cb4342d192e3101f8aOliver Woodman * a better solution. 106261dcdf3764b614c6f01e77cb4342d192e3101f8aOliver Woodman * @hide 106361dcdf3764b614c6f01e77cb4342d192e3101f8aOliver Woodman */ 106461dcdf3764b614c6f01e77cb4342d192e3101f8aOliver Woodman public int getLatency() { 106561dcdf3764b614c6f01e77cb4342d192e3101f8aOliver Woodman return native_get_latency(); 106661dcdf3764b614c6f01e77cb4342d192e3101f8aOliver Woodman } 106761dcdf3764b614c6f01e77cb4342d192e3101f8aOliver Woodman 106861dcdf3764b614c6f01e77cb4342d192e3101f8aOliver Woodman /** 1069e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * Returns the output sample rate in Hz for the specified stream type. 10709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 10719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project static public int getNativeOutputSampleRate(int streamType) { 10729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return native_get_output_sample_rate(streamType); 10739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1074fb2ab9efc3805c81521afb9ff91a58ff5097a36eGlenn Kasten 10759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 10769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the minimum buffer size required for the successful creation of an AudioTrack 1077ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * object to be created in the {@link #MODE_STREAM} mode. Note that this size doesn't 1078ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * guarantee a smooth playback under load, and higher values should be chosen according to 1079fb2ab9efc3805c81521afb9ff91a58ff5097a36eGlenn Kasten * the expected frequency at which the buffer will be refilled with additional data to play. 10808d7fa137466c833ed422053204fb4c506b7bb209Glenn Kasten * For example, if you intend to dynamically set the source sample rate of an AudioTrack 10818d7fa137466c833ed422053204fb4c506b7bb209Glenn Kasten * to a higher value than the initial source sample rate, be sure to configure the buffer size 10828d7fa137466c833ed422053204fb4c506b7bb209Glenn Kasten * based on the highest planned sample rate. 10838d7fa137466c833ed422053204fb4c506b7bb209Glenn Kasten * @param sampleRateInHz the source sample rate expressed in Hz. 1084fb2ab9efc3805c81521afb9ff91a58ff5097a36eGlenn Kasten * @param channelConfig describes the configuration of the audio channels. 1085a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * See {@link AudioFormat#CHANNEL_OUT_MONO} and 1086a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * {@link AudioFormat#CHANNEL_OUT_STEREO} 1087fb2ab9efc3805c81521afb9ff91a58ff5097a36eGlenn Kasten * @param audioFormat the format in which the audio data is represented. 1088fb2ab9efc3805c81521afb9ff91a58ff5097a36eGlenn Kasten * See {@link AudioFormat#ENCODING_PCM_16BIT} and 10897d60bcd2d950e3571c00ce9f1c492c6bd58334c9Glenn Kasten * {@link AudioFormat#ENCODING_PCM_8BIT}, 10907d60bcd2d950e3571c00ce9f1c492c6bd58334c9Glenn Kasten * and {@link AudioFormat#ENCODING_PCM_FLOAT}. 10919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return {@link #ERROR_BAD_VALUE} if an invalid parameter was passed, 1092e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * or {@link #ERROR} if unable to query for output properties, 1093ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * or the minimum buffer size expressed in bytes. 10949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 10959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project static public int getMinBufferSize(int sampleRateInHz, int channelConfig, int audioFormat) { 10969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int channelCount = 0; 10979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project switch(channelConfig) { 1098a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent case AudioFormat.CHANNEL_OUT_MONO: 10993026a023b8979b7ddcb3fe97bbc45531c89fda92Eric Laurent case AudioFormat.CHANNEL_CONFIGURATION_MONO: 11009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project channelCount = 1; 11019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project break; 1102a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent case AudioFormat.CHANNEL_OUT_STEREO: 11033026a023b8979b7ddcb3fe97bbc45531c89fda92Eric Laurent case AudioFormat.CHANNEL_CONFIGURATION_STEREO: 11049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project channelCount = 2; 11059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project break; 11069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project default: 1107a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung if (!isMultichannelConfigSupported(channelConfig)) { 11081b8f499a14a4340d3422d95c7f6fdc8c0c72b3a4Jean-Michel Trivi loge("getMinBufferSize(): Invalid channel configuration."); 1109df3cb5279857cac41909643c6703e8fc1621fad1Glenn Kasten return ERROR_BAD_VALUE; 11101b8f499a14a4340d3422d95c7f6fdc8c0c72b3a4Jean-Michel Trivi } else { 11118528ed43b41ff02535675c5da7425bef5195e73bAndy Hung channelCount = AudioFormat.channelCountFromOutChannelMask(channelConfig); 11121b8f499a14a4340d3422d95c7f6fdc8c0c72b3a4Jean-Michel Trivi } 11139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1114fb2ab9efc3805c81521afb9ff91a58ff5097a36eGlenn Kasten 1115ff0d9f098e51c54e1a030ed21fd980680cb7b405Eric Laurent if (!AudioFormat.isValidEncoding(audioFormat)) { 11169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project loge("getMinBufferSize(): Invalid audio format."); 1117df3cb5279857cac41909643c6703e8fc1621fad1Glenn Kasten return ERROR_BAD_VALUE; 11189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1119fb2ab9efc3805c81521afb9ff91a58ff5097a36eGlenn Kasten 11205c17a820f9e46e0756c11795b3e6f89105f2f539Glenn Kasten // sample rate, note these values are subject to change 1121ad67c9546494a7c4d9336b57889a7c19a7dbb945Glenn Kasten if ( (sampleRateInHz < SAMPLE_RATE_HZ_MIN) || (sampleRateInHz > SAMPLE_RATE_HZ_MAX) ) { 1122ad67c9546494a7c4d9336b57889a7c19a7dbb945Glenn Kasten loge("getMinBufferSize(): " + sampleRateInHz + " Hz is not a supported sample rate."); 1123df3cb5279857cac41909643c6703e8fc1621fad1Glenn Kasten return ERROR_BAD_VALUE; 11249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1125fb2ab9efc3805c81521afb9ff91a58ff5097a36eGlenn Kasten 11269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int size = native_get_min_buff_size(sampleRateInHz, channelCount, audioFormat); 1127a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten if (size <= 0) { 11289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project loge("getMinBufferSize(): error querying hardware"); 1129df3cb5279857cac41909643c6703e8fc1621fad1Glenn Kasten return ERROR; 11309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project else { 11329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return size; 11339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1136619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent /** 1137619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * Returns the audio session ID. 1138619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * 1139619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * @return the ID of the audio session this AudioTrack belongs to. 1140619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent */ 1141619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent public int getAudioSessionId() { 1142619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent return mSessionId; 1143619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent } 11449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1145948c2e6ff46d65942277f2e0e9ce0c038972b9d8Glenn Kasten /** 1146948c2e6ff46d65942277f2e0e9ce0c038972b9d8Glenn Kasten * Poll for a timestamp on demand. 1147486918b41584cd2589c46c5217b3fba1e7d18874Glenn Kasten * <p> 1148486918b41584cd2589c46c5217b3fba1e7d18874Glenn Kasten * If you need to track timestamps during initial warmup or after a routing or mode change, 1149486918b41584cd2589c46c5217b3fba1e7d18874Glenn Kasten * you should request a new timestamp once per second until the reported timestamps 1150486918b41584cd2589c46c5217b3fba1e7d18874Glenn Kasten * show that the audio clock is stable. 1151486918b41584cd2589c46c5217b3fba1e7d18874Glenn Kasten * Thereafter, query for a new timestamp approximately once every 10 seconds to once per minute. 1152486918b41584cd2589c46c5217b3fba1e7d18874Glenn Kasten * Calling this method more often is inefficient. 1153486918b41584cd2589c46c5217b3fba1e7d18874Glenn Kasten * It is also counter-productive to call this method more often than recommended, 1154486918b41584cd2589c46c5217b3fba1e7d18874Glenn Kasten * because the short-term differences between successive timestamp reports are not meaningful. 1155486918b41584cd2589c46c5217b3fba1e7d18874Glenn Kasten * If you need a high-resolution mapping between frame position and presentation time, 1156948c2e6ff46d65942277f2e0e9ce0c038972b9d8Glenn Kasten * consider implementing that at application level, based on low-resolution timestamps. 1157486918b41584cd2589c46c5217b3fba1e7d18874Glenn Kasten * <p> 1158948c2e6ff46d65942277f2e0e9ce0c038972b9d8Glenn Kasten * The audio data at the returned position may either already have been 1159948c2e6ff46d65942277f2e0e9ce0c038972b9d8Glenn Kasten * presented, or may have not yet been presented but is committed to be presented. 1160948c2e6ff46d65942277f2e0e9ce0c038972b9d8Glenn Kasten * It is not possible to request the time corresponding to a particular position, 1161948c2e6ff46d65942277f2e0e9ce0c038972b9d8Glenn Kasten * or to request the (fractional) position corresponding to a particular time. 1162948c2e6ff46d65942277f2e0e9ce0c038972b9d8Glenn Kasten * If you need such features, consider implementing them at application level. 1163948c2e6ff46d65942277f2e0e9ce0c038972b9d8Glenn Kasten * 1164948c2e6ff46d65942277f2e0e9ce0c038972b9d8Glenn Kasten * @param timestamp a reference to a non-null AudioTimestamp instance allocated 1165596fb8e7969cafdf7f25dfdc97372be4c0950cc3Glenn Kasten * and owned by caller. 1166596fb8e7969cafdf7f25dfdc97372be4c0950cc3Glenn Kasten * @return true if a timestamp is available, or false if no timestamp is available. 1167596fb8e7969cafdf7f25dfdc97372be4c0950cc3Glenn Kasten * If a timestamp if available, 1168948c2e6ff46d65942277f2e0e9ce0c038972b9d8Glenn Kasten * the AudioTimestamp instance is filled in with a position in frame units, together 1169948c2e6ff46d65942277f2e0e9ce0c038972b9d8Glenn Kasten * with the estimated time when that frame was presented or is committed to 1170948c2e6ff46d65942277f2e0e9ce0c038972b9d8Glenn Kasten * be presented. 1171948c2e6ff46d65942277f2e0e9ce0c038972b9d8Glenn Kasten * In the case that no timestamp is available, any supplied instance is left unaltered. 1172c52f4e25e21719d5d637a588e3200be941b9fe4dGlenn Kasten * A timestamp may be temporarily unavailable while the audio clock is stabilizing, 1173c52f4e25e21719d5d637a588e3200be941b9fe4dGlenn Kasten * or during and immediately after a route change. 1174948c2e6ff46d65942277f2e0e9ce0c038972b9d8Glenn Kasten */ 1175486918b41584cd2589c46c5217b3fba1e7d18874Glenn Kasten // Add this text when the "on new timestamp" API is added: 1176486918b41584cd2589c46c5217b3fba1e7d18874Glenn Kasten // Use if you need to get the most recent timestamp outside of the event callback handler. 1177596fb8e7969cafdf7f25dfdc97372be4c0950cc3Glenn Kasten public boolean getTimestamp(AudioTimestamp timestamp) 1178948c2e6ff46d65942277f2e0e9ce0c038972b9d8Glenn Kasten { 1179596fb8e7969cafdf7f25dfdc97372be4c0950cc3Glenn Kasten if (timestamp == null) { 1180596fb8e7969cafdf7f25dfdc97372be4c0950cc3Glenn Kasten throw new IllegalArgumentException(); 1181596fb8e7969cafdf7f25dfdc97372be4c0950cc3Glenn Kasten } 1182948c2e6ff46d65942277f2e0e9ce0c038972b9d8Glenn Kasten // It's unfortunate, but we have to either create garbage every time or use synchronized 1183948c2e6ff46d65942277f2e0e9ce0c038972b9d8Glenn Kasten long[] longArray = new long[2]; 1184948c2e6ff46d65942277f2e0e9ce0c038972b9d8Glenn Kasten int ret = native_get_timestamp(longArray); 1185596fb8e7969cafdf7f25dfdc97372be4c0950cc3Glenn Kasten if (ret != SUCCESS) { 1186596fb8e7969cafdf7f25dfdc97372be4c0950cc3Glenn Kasten return false; 1187948c2e6ff46d65942277f2e0e9ce0c038972b9d8Glenn Kasten } 1188596fb8e7969cafdf7f25dfdc97372be4c0950cc3Glenn Kasten timestamp.framePosition = longArray[0]; 1189596fb8e7969cafdf7f25dfdc97372be4c0950cc3Glenn Kasten timestamp.nanoTime = longArray[1]; 1190596fb8e7969cafdf7f25dfdc97372be4c0950cc3Glenn Kasten return true; 1191948c2e6ff46d65942277f2e0e9ce0c038972b9d8Glenn Kasten } 1192948c2e6ff46d65942277f2e0e9ce0c038972b9d8Glenn Kasten 1193948c2e6ff46d65942277f2e0e9ce0c038972b9d8Glenn Kasten 11949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //-------------------------------------------------------------------------- 11959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Initialization / configuration 11969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //-------------------- 11979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11984df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project * Sets the listener the AudioTrack notifies when a previously set marker is reached or 11994df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project * for each periodic playback head position update. 1200ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * Notifications will be received in the same thread as the one in which the AudioTrack 1201ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * instance was created. 12029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param listener 12039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 12044df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project public void setPlaybackPositionUpdateListener(OnPlaybackPositionUpdateListener listener) { 12054df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project setPlaybackPositionUpdateListener(listener, null); 12069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1207fb2ab9efc3805c81521afb9ff91a58ff5097a36eGlenn Kasten 1208ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi /** 1209ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * Sets the listener the AudioTrack notifies when a previously set marker is reached or 1210ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * for each periodic playback head position update. 1211ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * Use this method to receive AudioTrack events in the Handler associated with another 1212ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * thread than the one in which you created the AudioTrack instance. 1213ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * @param listener 1214ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * @param handler the Handler that will receive the event notification messages. 1215ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi */ 1216fb2ab9efc3805c81521afb9ff91a58ff5097a36eGlenn Kasten public void setPlaybackPositionUpdateListener(OnPlaybackPositionUpdateListener listener, 12174df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project Handler handler) { 12184df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project if (listener != null) { 121995bd2329c6a36211f18be3e089eaa775ec62df62Glenn Kasten mEventHandlerDelegate = new NativeEventHandlerDelegate(this, listener, handler); 122095bd2329c6a36211f18be3e089eaa775ec62df62Glenn Kasten } else { 122195bd2329c6a36211f18be3e089eaa775ec62df62Glenn Kasten mEventHandlerDelegate = null; 12229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 122678cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten private static float clampGainOrLevel(float gainOrLevel) { 122778cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten if (Float.isNaN(gainOrLevel)) { 122878cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten throw new IllegalArgumentException(); 122978cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten } 123078cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten if (gainOrLevel < GAIN_MIN) { 123178cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten gainOrLevel = GAIN_MIN; 123278cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten } else if (gainOrLevel > GAIN_MAX) { 123378cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten gainOrLevel = GAIN_MAX; 123478cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten } 123578cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten return gainOrLevel; 123678cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten } 123778cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten 12384df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project 12399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 124078cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * Sets the specified left and right output gain values on the AudioTrack. 124178cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * <p>Gain values are clamped to the closed interval [0.0, max] where 124278cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * max is the value of {@link #getMaxVolume}. 124378cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * A value of 0.0 results in zero gain (silence), and 124478cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * a value of 1.0 means unity gain (signal unchanged). 124578cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * The default value is 1.0 meaning unity gain. 124678cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * <p>The word "volume" in the API name is historical; this is actually a linear gain. 124778cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * @param leftGain output gain for the left channel. 124878cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * @param rightGain output gain for the right channel 12499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return error code or success, see {@link #SUCCESS}, 12509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #ERROR_INVALID_OPERATION} 125178cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * @deprecated Applications should use {@link #setVolume} instead, as it 125278cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * more gracefully scales down to mono, and up to multi-channel content beyond stereo. 12539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 125478cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten public int setStereoVolume(float leftGain, float rightGain) { 12551af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlock if (isRestricted()) { 12561af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlock return SUCCESS; 12571af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlock } 12583b4df62704a6184878afd9272830cf3db7bd2d66Glenn Kasten if (mState == STATE_UNINITIALIZED) { 12599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return ERROR_INVALID_OPERATION; 12609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 126278cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten leftGain = clampGainOrLevel(leftGain); 126378cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten rightGain = clampGainOrLevel(rightGain); 12649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 126578cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten native_setVolume(leftGain, rightGain); 12669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return SUCCESS; 12689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 127278cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * Sets the specified output gain value on all channels of this track. 127378cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * <p>Gain values are clamped to the closed interval [0.0, max] where 127478cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * max is the value of {@link #getMaxVolume}. 127578cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * A value of 0.0 results in zero gain (silence), and 127678cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * a value of 1.0 means unity gain (signal unchanged). 127778cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * The default value is 1.0 meaning unity gain. 127878cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * <p>This API is preferred over {@link #setStereoVolume}, as it 127978cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * more gracefully scales down to mono, and up to multi-channel content beyond stereo. 128078cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * <p>The word "volume" in the API name is historical; this is actually a linear gain. 128178cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * @param gain output gain for all channels. 12823e21cc8140e42bdcd924590e5e12446b6c55ad2aGlenn Kasten * @return error code or success, see {@link #SUCCESS}, 12833e21cc8140e42bdcd924590e5e12446b6c55ad2aGlenn Kasten * {@link #ERROR_INVALID_OPERATION} 1284068225de0197df07a0247b2877666ea91c22c992Glenn Kasten */ 128578cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten public int setVolume(float gain) { 128678cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten return setStereoVolume(gain, gain); 1287068225de0197df07a0247b2877666ea91c22c992Glenn Kasten } 1288068225de0197df07a0247b2877666ea91c22c992Glenn Kasten 1289068225de0197df07a0247b2877666ea91c22c992Glenn Kasten 1290068225de0197df07a0247b2877666ea91c22c992Glenn Kasten /** 12919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets the playback sample rate for this track. This sets the sampling rate at which 12928d7fa137466c833ed422053204fb4c506b7bb209Glenn Kasten * the audio data will be consumed and played back 12938d7fa137466c833ed422053204fb4c506b7bb209Glenn Kasten * (as set by the sampleRateInHz parameter in the 12948d7fa137466c833ed422053204fb4c506b7bb209Glenn Kasten * {@link #AudioTrack(int, int, int, int, int, int)} constructor), 12958d7fa137466c833ed422053204fb4c506b7bb209Glenn Kasten * not the original sampling rate of the 1296e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * content. For example, setting it to half the sample rate of the content will cause the 1297e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * playback to last twice as long, but will also result in a pitch shift down by one octave. 1298e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * The valid sample rate range is from 1 Hz to twice the value returned by 129988e209dcf8c2ebddda5c272f46d1bd5478bc639cEric Laurent * {@link #getNativeOutputSampleRate(int)}. 1300ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * @param sampleRateInHz the sample rate expressed in Hz 13019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return error code or success, see {@link #SUCCESS}, {@link #ERROR_BAD_VALUE}, 13029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #ERROR_INVALID_OPERATION} 13039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 13049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int setPlaybackRate(int sampleRateInHz) { 1305f19395db6343efdf80d064e0ba7c3b9aa4dbae75Glenn Kasten if (mState != STATE_INITIALIZED) { 13069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return ERROR_INVALID_OPERATION; 13079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (sampleRateInHz <= 0) { 13099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return ERROR_BAD_VALUE; 13109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 131188e209dcf8c2ebddda5c272f46d1bd5478bc639cEric Laurent return native_set_playback_rate(sampleRateInHz); 13129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1316e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * Sets the position of the notification marker. At most one marker can be active. 1317e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * @param markerInFrames marker position in wrapping frame units similar to 1318e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * {@link #getPlaybackHeadPosition}, or zero to disable the marker. 1319e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * To set a marker at a position which would appear as zero due to wraparound, 1320e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * a workaround is to use a non-zero position near zero, such as -1 or 1. 13219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return error code or success, see {@link #SUCCESS}, {@link #ERROR_BAD_VALUE}, 13229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #ERROR_INVALID_OPERATION} 13239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 13249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int setNotificationMarkerPosition(int markerInFrames) { 13253b4df62704a6184878afd9272830cf3db7bd2d66Glenn Kasten if (mState == STATE_UNINITIALIZED) { 13269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return ERROR_INVALID_OPERATION; 13279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return native_set_marker_pos(markerInFrames); 13299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1333ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * Sets the period for the periodic notification event. 1334ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * @param periodInFrames update period expressed in frames. 1335ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * Zero period means no position updates. A negative period is not allowed. 13369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return error code or success, see {@link #SUCCESS}, {@link #ERROR_INVALID_OPERATION} 13379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 13389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int setPositionNotificationPeriod(int periodInFrames) { 13393b4df62704a6184878afd9272830cf3db7bd2d66Glenn Kasten if (mState == STATE_UNINITIALIZED) { 13409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return ERROR_INVALID_OPERATION; 13419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return native_set_pos_update_period(periodInFrames); 13439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1347ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * Sets the playback head position within the static buffer. 1348a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten * The track must be stopped or paused for the position to be changed, 1349a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten * and must use the {@link #MODE_STATIC} mode. 1350ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * @param positionInFrames playback head position within buffer, expressed in frames. 1351e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * Zero corresponds to start of buffer. 1352e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * The position must not be greater than the buffer size in frames, or negative. 1353ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * Though this method and {@link #getPlaybackHeadPosition()} have similar names, 1354ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * the position values have different meanings. 1355ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * <br> 1356ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * If looping is currently enabled and the new position is greater than or equal to the 1357ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * loop end marker, the behavior varies by API level: for API level 22 and above, 1358ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * the looping is first disabled and then the position is set. 1359ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * For earlier API levels, the behavior is unspecified. 13609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return error code or success, see {@link #SUCCESS}, {@link #ERROR_BAD_VALUE}, 13619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #ERROR_INVALID_OPERATION} 13629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 13639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int setPlaybackHeadPosition(int positionInFrames) { 136478bfa6322bf34e49d5e4426296c701a64f705e49Andy Hung if (mDataLoadMode == MODE_STREAM || mState == STATE_UNINITIALIZED || 1365a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten getPlayState() == PLAYSTATE_PLAYING) { 1366a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten return ERROR_INVALID_OPERATION; 13679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1368e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten if (!(0 <= positionInFrames && positionInFrames <= mNativeBufferSizeInFrames)) { 1369e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten return ERROR_BAD_VALUE; 1370e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten } 1371a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten return native_set_position(positionInFrames); 13729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 13759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets the loop points and the loop count. The loop can be infinite. 1376a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten * Similarly to setPlaybackHeadPosition, 1377e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * the track must be stopped or paused for the loop points to be changed, 1378a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten * and must use the {@link #MODE_STATIC} mode. 1379ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * @param startInFrames loop start marker expressed in frames. 1380e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * Zero corresponds to start of buffer. 1381e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * The start marker must not be greater than or equal to the buffer size in frames, or negative. 1382ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * @param endInFrames loop end marker expressed in frames. 1383e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * The total buffer size in frames corresponds to end of buffer. 1384e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * The end marker must not be greater than the buffer size in frames. 1385e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * For looping, the end marker must not be less than or equal to the start marker, 1386e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * but to disable looping 1387e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * it is permitted for start marker, end marker, and loop count to all be 0. 1388ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * If any input parameters are out of range, this method returns {@link #ERROR_BAD_VALUE}. 1389ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * If the loop period (endInFrames - startInFrames) is too small for the implementation to 1390ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * support, 1391ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * {@link #ERROR_BAD_VALUE} is returned. 1392ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * The loop range is the interval [startInFrames, endInFrames). 1393ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * <br> 1394ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * For API level 22 and above, the position is left unchanged, 1395ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * unless it is greater than or equal to the loop end marker, in which case 1396ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * it is forced to the loop start marker. 1397ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * For earlier API levels, the effect on position is unspecified. 1398ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * @param loopCount the number of times the loop is looped; must be greater than or equal to -1. 1399e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * A value of -1 means infinite looping, and 0 disables looping. 1400ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * A value of positive N means to "loop" (go back) N times. For example, 1401ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * a value of one means to play the region two times in total. 14029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return error code or success, see {@link #SUCCESS}, {@link #ERROR_BAD_VALUE}, 14039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #ERROR_INVALID_OPERATION} 14049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 14059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int setLoopPoints(int startInFrames, int endInFrames, int loopCount) { 140678bfa6322bf34e49d5e4426296c701a64f705e49Andy Hung if (mDataLoadMode == MODE_STREAM || mState == STATE_UNINITIALIZED || 1407a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten getPlayState() == PLAYSTATE_PLAYING) { 14089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return ERROR_INVALID_OPERATION; 14099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1410e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten if (loopCount == 0) { 1411e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten ; // explicitly allowed as an exception to the loop region range check 1412e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten } else if (!(0 <= startInFrames && startInFrames < mNativeBufferSizeInFrames && 1413e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten startInFrames < endInFrames && endInFrames <= mNativeBufferSizeInFrames)) { 1414e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten return ERROR_BAD_VALUE; 1415e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten } 14169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return native_set_loop(startInFrames, endInFrames, loopCount); 14179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 142055a3218f242a611afb3569d88970c0c5dbf8ce54Glenn Kasten * Sets the initialization state of the instance. This method was originally intended to be used 142155a3218f242a611afb3569d88970c0c5dbf8ce54Glenn Kasten * in an AudioTrack subclass constructor to set a subclass-specific post-initialization state. 142255a3218f242a611afb3569d88970c0c5dbf8ce54Glenn Kasten * However, subclasses of AudioTrack are no longer recommended, so this method is obsolete. 14239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param state the state of the AudioTrack instance 142455a3218f242a611afb3569d88970c0c5dbf8ce54Glenn Kasten * @deprecated Only accessible by subclasses, which are not recommended for AudioTrack. 14259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 142655a3218f242a611afb3569d88970c0c5dbf8ce54Glenn Kasten @Deprecated 14279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project protected void setState(int state) { 14289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mState = state; 14299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //--------------------------------------------------------- 14339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Transport control methods 14349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //-------------------- 14359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 14369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Starts playing an AudioTrack. 1437ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * If track's creation mode is {@link #MODE_STATIC}, you must have called one of 1438ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * the {@link #write(byte[], int, int)}, {@link #write(short[], int, int)}, 1439ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * or {@link #write(float[], int, int, int)} methods. 1440b5e5efbab87aae79eb1902de8ed53eb2b5bb1f69Glenn Kasten * If the mode is {@link #MODE_STREAM}, you can optionally prime the 1441ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * output buffer by writing up to bufferSizeInBytes (from constructor) before starting. 1442ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * This priming will avoid an immediate underrun, but is not required. 144388bde0ce3799c47530ea42ae3665bfa12ae38d11Narayan Kamath * 14449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws IllegalStateException 14459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 14469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void play() 14479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throws IllegalStateException { 14489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mState != STATE_INITIALIZED) { 1449f4e58051e22ad4e21c7cd436c37cc5665c194d1cGlenn Kasten throw new IllegalStateException("play() called on uninitialized AudioTrack."); 14509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14511af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlock if (isRestricted()) { 14521af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlock setVolume(0); 14531af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlock } 14549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project synchronized(mPlayStateLock) { 14559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project native_start(); 14569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mPlayState = PLAYSTATE_PLAYING; 14579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14601af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlock private boolean isRestricted() { 1461bbfd31a5d4f126167e20fa8bd256c810cf8c2c85John Spurlock if ((mAttributes.getFlags() & AudioAttributes.FLAG_BYPASS_INTERRUPTION_POLICY) != 0) { 1462bbfd31a5d4f126167e20fa8bd256c810cf8c2c85John Spurlock return false; 1463bbfd31a5d4f126167e20fa8bd256c810cf8c2c85John Spurlock } 14641af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlock try { 14657b41467704f941b11af6aace3e40993afc7f6c6fJohn Spurlock final int usage = AudioAttributes.usageForLegacyStreamType(mStreamType); 14667b41467704f941b11af6aace3e40993afc7f6c6fJohn Spurlock final int mode = mAppOps.checkAudioOperation(AppOpsManager.OP_PLAY_AUDIO, usage, 14671af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlock Process.myUid(), ActivityThread.currentPackageName()); 14681af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlock return mode != AppOpsManager.MODE_ALLOWED; 14691af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlock } catch (RemoteException e) { 14701af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlock return false; 14711af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlock } 14721af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlock } 14731af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlock 14749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 14759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Stops playing the audio data. 1476a701da8ebabb3d63ac57b7718055698abb21804aJean-Michel Trivi * When used on an instance created in {@link #MODE_STREAM} mode, audio will stop playing 1477a701da8ebabb3d63ac57b7718055698abb21804aJean-Michel Trivi * after the last buffer that was written has been played. For an immediate stop, use 1478a701da8ebabb3d63ac57b7718055698abb21804aJean-Michel Trivi * {@link #pause()}, followed by {@link #flush()} to discard audio data that hasn't been played 1479a701da8ebabb3d63ac57b7718055698abb21804aJean-Michel Trivi * back yet. 14809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws IllegalStateException 14819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 14829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void stop() 14839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throws IllegalStateException { 14849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mState != STATE_INITIALIZED) { 1485f4e58051e22ad4e21c7cd436c37cc5665c194d1cGlenn Kasten throw new IllegalStateException("stop() called on uninitialized AudioTrack."); 14869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // stop playing 14899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project synchronized(mPlayStateLock) { 14909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project native_stop(); 14919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mPlayState = PLAYSTATE_STOPPED; 14929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 149688bde0ce3799c47530ea42ae3665bfa12ae38d11Narayan Kamath * Pauses the playback of the audio data. Data that has not been played 149788bde0ce3799c47530ea42ae3665bfa12ae38d11Narayan Kamath * back will not be discarded. Subsequent calls to {@link #play} will play 1498a701da8ebabb3d63ac57b7718055698abb21804aJean-Michel Trivi * this data back. See {@link #flush()} to discard this data. 149988bde0ce3799c47530ea42ae3665bfa12ae38d11Narayan Kamath * 15009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws IllegalStateException 15019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 15029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void pause() 15039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throws IllegalStateException { 15049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mState != STATE_INITIALIZED) { 1505f4e58051e22ad4e21c7cd436c37cc5665c194d1cGlenn Kasten throw new IllegalStateException("pause() called on uninitialized AudioTrack."); 15069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //logd("pause()"); 15089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 15099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // pause playback 15109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project synchronized(mPlayStateLock) { 15119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project native_pause(); 15129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mPlayState = PLAYSTATE_PAUSED; 15139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 15169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 15179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //--------------------------------------------------------- 15189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Audio data supply 15199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //-------------------- 15209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 15219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 152288bde0ce3799c47530ea42ae3665bfa12ae38d11Narayan Kamath * Flushes the audio data currently queued for playback. Any data that has 15237a121563d5c94ca0b88539afd8a7e86cc9118b60Glenn Kasten * been written but not yet presented will be discarded. No-op if not stopped or paused, 1524e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * or if the track's creation mode is not {@link #MODE_STREAM}. 15257a121563d5c94ca0b88539afd8a7e86cc9118b60Glenn Kasten * <BR> Note that although data written but not yet presented is discarded, there is no 15267a121563d5c94ca0b88539afd8a7e86cc9118b60Glenn Kasten * guarantee that all of the buffer space formerly used by that data 15277a121563d5c94ca0b88539afd8a7e86cc9118b60Glenn Kasten * is available for a subsequent write. 15287a121563d5c94ca0b88539afd8a7e86cc9118b60Glenn Kasten * For example, a call to {@link #write(byte[], int, int)} with <code>sizeInBytes</code> 15297a121563d5c94ca0b88539afd8a7e86cc9118b60Glenn Kasten * less than or equal to the total buffer size 15307a121563d5c94ca0b88539afd8a7e86cc9118b60Glenn Kasten * may return a short actual transfer count. 15319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 15329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void flush() { 15339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mState == STATE_INITIALIZED) { 15349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // flush the data in native layer 15359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project native_flush(); 15369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 15389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 15409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1541e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * Writes the audio data to the audio sink for playback (streaming mode), 1542e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * or copies audio data for later playback (static buffer mode). 1543e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * In streaming mode, will block until all data has been written to the audio sink. 1544e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * In static buffer mode, copies the data to the buffer starting at offset 0. 154588bde0ce3799c47530ea42ae3665bfa12ae38d11Narayan Kamath * Note that the actual playback of this data might occur after this function 154688bde0ce3799c47530ea42ae3665bfa12ae38d11Narayan Kamath * returns. This function is thread safe with respect to {@link #stop} calls, 1547e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * in which case all of the specified data might not be written to the audio sink. 154888bde0ce3799c47530ea42ae3665bfa12ae38d11Narayan Kamath * 15499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param audioData the array that holds the data to play. 155088bde0ce3799c47530ea42ae3665bfa12ae38d11Narayan Kamath * @param offsetInBytes the offset expressed in bytes in audioData where the data to play 1551ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * starts. 15529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param sizeInBytes the number of bytes to read in audioData after the offset. 15539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return the number of bytes that were written or {@link #ERROR_INVALID_OPERATION} 15549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * if the object wasn't properly initialized, or {@link #ERROR_BAD_VALUE} if 1555ff0d9f098e51c54e1a030ed21fd980680cb7b405Eric Laurent * the parameters don't resolve to valid data and indexes, or 1556ff0d9f098e51c54e1a030ed21fd980680cb7b405Eric Laurent * {@link AudioManager#ERROR_DEAD_OBJECT} if the AudioTrack is not valid anymore and 1557ff0d9f098e51c54e1a030ed21fd980680cb7b405Eric Laurent * needs to be recreated. 15589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 15599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 15605c17a820f9e46e0756c11795b3e6f89105f2f539Glenn Kasten public int write(byte[] audioData, int offsetInBytes, int sizeInBytes) { 15619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 156254955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten if (mState == STATE_UNINITIALIZED || mAudioFormat == AudioFormat.ENCODING_PCM_FLOAT) { 15639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return ERROR_INVALID_OPERATION; 15649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1566fb2ab9efc3805c81521afb9ff91a58ff5097a36eGlenn Kasten if ( (audioData == null) || (offsetInBytes < 0 ) || (sizeInBytes < 0) 1567a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten || (offsetInBytes + sizeInBytes < 0) // detect integer overflow 15689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project || (offsetInBytes + sizeInBytes > audioData.length)) { 15699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return ERROR_BAD_VALUE; 15709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 15727ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi int ret = native_write_byte(audioData, offsetInBytes, sizeInBytes, mAudioFormat, 15737ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi true /*isBlocking*/); 1574a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten 1575a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten if ((mDataLoadMode == MODE_STATIC) 1576a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten && (mState == STATE_NO_STATIC_DATA) 1577a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten && (ret > 0)) { 1578a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten // benign race with respect to other APIs that read mState 1579a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten mState = STATE_INITIALIZED; 1580a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten } 1581a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten 1582a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten return ret; 15839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 15859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 15869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1587e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * Writes the audio data to the audio sink for playback (streaming mode), 1588e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * or copies audio data for later playback (static buffer mode). 1589e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * In streaming mode, will block until all data has been written to the audio sink. 1590e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * In static buffer mode, copies the data to the buffer starting at offset 0. 159188bde0ce3799c47530ea42ae3665bfa12ae38d11Narayan Kamath * Note that the actual playback of this data might occur after this function 159288bde0ce3799c47530ea42ae3665bfa12ae38d11Narayan Kamath * returns. This function is thread safe with respect to {@link #stop} calls, 1593e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * in which case all of the specified data might not be written to the audio sink. 159488bde0ce3799c47530ea42ae3665bfa12ae38d11Narayan Kamath * 15959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param audioData the array that holds the data to play. 1596ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * @param offsetInShorts the offset expressed in shorts in audioData where the data to play 1597ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * starts. 1598e8c82a37050e568f211d47951480b182a61d42b4Glenn Kasten * @param sizeInShorts the number of shorts to read in audioData after the offset. 15999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return the number of shorts that were written or {@link #ERROR_INVALID_OPERATION} 160054955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten * if the object wasn't properly initialized, or {@link #ERROR_BAD_VALUE} if 1601136e006248e6416ee30d7af2e6de102d195b8fb6Jean-Michel Trivi * the parameters don't resolve to valid data and indexes, or 1602136e006248e6416ee30d7af2e6de102d195b8fb6Jean-Michel Trivi * {@link AudioManager#ERROR_DEAD_OBJECT} if the AudioTrack is not valid anymore and 1603136e006248e6416ee30d7af2e6de102d195b8fb6Jean-Michel Trivi * needs to be recreated. 16049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 16059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 16069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int write(short[] audioData, int offsetInShorts, int sizeInShorts) { 1607fb2ab9efc3805c81521afb9ff91a58ff5097a36eGlenn Kasten 1608c56b8085919771b6f027dc64ed6a44915e392464Glenn Kasten if (mState == STATE_UNINITIALIZED || mAudioFormat == AudioFormat.ENCODING_PCM_FLOAT) { 16099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return ERROR_INVALID_OPERATION; 16109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 16119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1612fb2ab9efc3805c81521afb9ff91a58ff5097a36eGlenn Kasten if ( (audioData == null) || (offsetInShorts < 0 ) || (sizeInShorts < 0) 1613a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten || (offsetInShorts + sizeInShorts < 0) // detect integer overflow 16149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project || (offsetInShorts + sizeInShorts > audioData.length)) { 16159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return ERROR_BAD_VALUE; 16169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 16179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1618a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten int ret = native_write_short(audioData, offsetInShorts, sizeInShorts, mAudioFormat); 1619a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten 1620a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten if ((mDataLoadMode == MODE_STATIC) 1621a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten && (mState == STATE_NO_STATIC_DATA) 1622a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten && (ret > 0)) { 1623a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten // benign race with respect to other APIs that read mState 1624a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten mState = STATE_INITIALIZED; 1625a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten } 1626a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten 1627a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten return ret; 16289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 16299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 16309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 16319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 16327ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi * Writes the audio data to the audio sink for playback (streaming mode), 16337ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi * or copies audio data for later playback (static buffer mode). 163454955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten * In static buffer mode, copies the data to the buffer starting at offset 0, 163554955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten * and the write mode is ignored. 163654955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten * In streaming mode, the blocking behavior will depend on the write mode. 163754955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten * <p> 163854955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten * Note that the actual playback of this data might occur after this function 163954955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten * returns. This function is thread safe with respect to {@link #stop} calls, 164054955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten * in which case all of the specified data might not be written to the audio sink. 164154955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten * <p> 164254955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten * @param audioData the array that holds the data to play. 164354955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten * The implementation does not clip for sample values within the nominal range 164454955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten * [-1.0f, 1.0f], provided that all gains in the audio pipeline are 164554955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten * less than or equal to unity (1.0f), and in the absence of post-processing effects 164654955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten * that could add energy, such as reverb. For the convenience of applications 164754955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten * that compute samples using filters with non-unity gain, 164854955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten * sample values +3 dB beyond the nominal range are permitted. 164954955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten * However such values may eventually be limited or clipped, depending on various gains 165054955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten * and later processing in the audio path. Therefore applications are encouraged 165154955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten * to provide samples values within the nominal range. 165254955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten * @param offsetInFloats the offset, expressed as a number of floats, 165354955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten * in audioData where the data to play starts. 165454955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten * @param sizeInFloats the number of floats to read in audioData after the offset. 165554955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten * @param writeMode one of {@link #WRITE_BLOCKING}, {@link #WRITE_NON_BLOCKING}. It has no 165654955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten * effect in static mode. 165754955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten * <BR>With {@link #WRITE_BLOCKING}, the write will block until all data has been written 165854955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten * to the audio sink. 165954955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten * <BR>With {@link #WRITE_NON_BLOCKING}, the write will return immediately after 166054955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten * queuing as much audio data for playback as possible without blocking. 166154955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten * @return the number of floats that were written, or {@link #ERROR_INVALID_OPERATION} 166254955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten * if the object wasn't properly initialized, or {@link #ERROR_BAD_VALUE} if 1663136e006248e6416ee30d7af2e6de102d195b8fb6Jean-Michel Trivi * the parameters don't resolve to valid data and indexes, or 1664136e006248e6416ee30d7af2e6de102d195b8fb6Jean-Michel Trivi * {@link AudioManager#ERROR_DEAD_OBJECT} if the AudioTrack is not valid anymore and 1665136e006248e6416ee30d7af2e6de102d195b8fb6Jean-Michel Trivi * needs to be recreated. 166654955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten */ 166754955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten public int write(float[] audioData, int offsetInFloats, int sizeInFloats, 166854955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten @WriteMode int writeMode) { 166954955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten 167054955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten if (mState == STATE_UNINITIALIZED) { 167154955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten Log.e(TAG, "AudioTrack.write() called in invalid state STATE_UNINITIALIZED"); 167254955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten return ERROR_INVALID_OPERATION; 167354955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten } 167454955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten 167554955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten if (mAudioFormat != AudioFormat.ENCODING_PCM_FLOAT) { 167654955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten Log.e(TAG, "AudioTrack.write(float[] ...) requires format ENCODING_PCM_FLOAT"); 167754955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten return ERROR_INVALID_OPERATION; 167854955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten } 167954955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten 168054955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten if ((writeMode != WRITE_BLOCKING) && (writeMode != WRITE_NON_BLOCKING)) { 168154955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten Log.e(TAG, "AudioTrack.write() called with invalid blocking mode"); 168254955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten return ERROR_BAD_VALUE; 168354955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten } 168454955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten 168554955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten if ( (audioData == null) || (offsetInFloats < 0 ) || (sizeInFloats < 0) 168654955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten || (offsetInFloats + sizeInFloats < 0) // detect integer overflow 168754955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten || (offsetInFloats + sizeInFloats > audioData.length)) { 168854955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten Log.e(TAG, "AudioTrack.write() called with invalid array, offset, or size"); 168954955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten return ERROR_BAD_VALUE; 169054955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten } 169154955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten 169254955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten int ret = native_write_float(audioData, offsetInFloats, sizeInFloats, mAudioFormat, 169354955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten writeMode == WRITE_BLOCKING); 169454955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten 169554955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten if ((mDataLoadMode == MODE_STATIC) 169654955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten && (mState == STATE_NO_STATIC_DATA) 169754955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten && (ret > 0)) { 169854955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten // benign race with respect to other APIs that read mState 169954955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten mState = STATE_INITIALIZED; 170054955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten } 170154955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten 170254955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten return ret; 170354955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten } 170454955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten 170554955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten 170654955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten /** 170754955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten * Writes the audio data to the audio sink for playback (streaming mode), 170854955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten * or copies audio data for later playback (static buffer mode). 17097ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi * In static buffer mode, copies the data to the buffer starting at its 0 offset, and the write 17107ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi * mode is ignored. 17117ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi * In streaming mode, the blocking behavior will depend on the write mode. 17127ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi * @param audioData the buffer that holds the data to play, starting at the position reported 17137ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi * by <code>audioData.position()</code>. 17145d21f679c58dbb13c8c931ffec6e06b6b8cd454fJean-Michel Trivi * <BR>Note that upon return, the buffer position (<code>audioData.position()</code>) will 17155d21f679c58dbb13c8c931ffec6e06b6b8cd454fJean-Michel Trivi * have been advanced to reflect the amount of data that was successfully written to 17165d21f679c58dbb13c8c931ffec6e06b6b8cd454fJean-Michel Trivi * the AudioTrack. 17175d21f679c58dbb13c8c931ffec6e06b6b8cd454fJean-Michel Trivi * @param sizeInBytes number of bytes to write. 17185d21f679c58dbb13c8c931ffec6e06b6b8cd454fJean-Michel Trivi * <BR>Note this may differ from <code>audioData.remaining()</code>, but cannot exceed it. 17197ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi * @param writeMode one of {@link #WRITE_BLOCKING}, {@link #WRITE_NON_BLOCKING}. It has no 17207ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi * effect in static mode. 17217ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi * <BR>With {@link #WRITE_BLOCKING}, the write will block until all data has been written 17227ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi * to the audio sink. 17237ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi * <BR>With {@link #WRITE_NON_BLOCKING}, the write will return immediately after 17247ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi * queuing as much audio data for playback as possible without blocking. 17257ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi * @return 0 or a positive number of bytes that were written, or 1726136e006248e6416ee30d7af2e6de102d195b8fb6Jean-Michel Trivi * {@link #ERROR_BAD_VALUE}, {@link #ERROR_INVALID_OPERATION}, or 1727136e006248e6416ee30d7af2e6de102d195b8fb6Jean-Michel Trivi * {@link AudioManager#ERROR_DEAD_OBJECT} if the AudioTrack is not valid anymore and 1728136e006248e6416ee30d7af2e6de102d195b8fb6Jean-Michel Trivi * needs to be recreated. 17297ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi */ 17305d21f679c58dbb13c8c931ffec6e06b6b8cd454fJean-Michel Trivi public int write(ByteBuffer audioData, int sizeInBytes, 17317ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi @WriteMode int writeMode) { 17327ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi 17337ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi if (mState == STATE_UNINITIALIZED) { 17347ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi Log.e(TAG, "AudioTrack.write() called in invalid state STATE_UNINITIALIZED"); 17357ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi return ERROR_INVALID_OPERATION; 17367ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi } 17377ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi 17387ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi if ((writeMode != WRITE_BLOCKING) && (writeMode != WRITE_NON_BLOCKING)) { 17397ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi Log.e(TAG, "AudioTrack.write() called with invalid blocking mode"); 17407ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi return ERROR_BAD_VALUE; 17417ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi } 17427ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi 17435d21f679c58dbb13c8c931ffec6e06b6b8cd454fJean-Michel Trivi if ( (audioData == null) || (sizeInBytes < 0) || (sizeInBytes > audioData.remaining())) { 17445d21f679c58dbb13c8c931ffec6e06b6b8cd454fJean-Michel Trivi Log.e(TAG, "AudioTrack.write() called with invalid size (" + sizeInBytes + ") value"); 17457ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi return ERROR_BAD_VALUE; 17467ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi } 17477ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi 17487ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi int ret = 0; 17497ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi if (audioData.isDirect()) { 17507ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi ret = native_write_native_bytes(audioData, 17515d21f679c58dbb13c8c931ffec6e06b6b8cd454fJean-Michel Trivi audioData.position(), sizeInBytes, mAudioFormat, 17527ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi writeMode == WRITE_BLOCKING); 17537ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi } else { 17547ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi ret = native_write_byte(NioUtils.unsafeArray(audioData), 17555d21f679c58dbb13c8c931ffec6e06b6b8cd454fJean-Michel Trivi NioUtils.unsafeArrayOffset(audioData) + audioData.position(), 17567ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi sizeInBytes, mAudioFormat, 17577ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi writeMode == WRITE_BLOCKING); 17587ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi } 17597ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi 17607ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi if ((mDataLoadMode == MODE_STATIC) 17617ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi && (mState == STATE_NO_STATIC_DATA) 17627ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi && (ret > 0)) { 17637ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi // benign race with respect to other APIs that read mState 17647ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi mState = STATE_INITIALIZED; 17657ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi } 17667ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi 17675d21f679c58dbb13c8c931ffec6e06b6b8cd454fJean-Michel Trivi if (ret > 0) { 17685d21f679c58dbb13c8c931ffec6e06b6b8cd454fJean-Michel Trivi audioData.position(audioData.position() + ret); 17695d21f679c58dbb13c8c931ffec6e06b6b8cd454fJean-Michel Trivi } 17705d21f679c58dbb13c8c931ffec6e06b6b8cd454fJean-Michel Trivi 17717ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi return ret; 17727ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi } 17737ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi 17747ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi /** 1775ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * Sets the playback head position within the static buffer to zero, 1776ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * that is it rewinds to start of static buffer. 1777ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * The track must be stopped or paused, and 1778ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * the track's creation mode must be {@link #MODE_STATIC}. 1779ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * <p> 1780ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * For API level 22 and above, also resets the value returned by 1781ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * {@link #getPlaybackHeadPosition()} to zero. 1782ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * For earlier API levels, the reset behavior is unspecified. 1783ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * <p> 1784ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * {@link #setPlaybackHeadPosition(int)} to zero 1785ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * is recommended instead when the reset of {@link #getPlaybackHeadPosition} is not needed. 17869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return error code or success, see {@link #SUCCESS}, {@link #ERROR_BAD_VALUE}, 17879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #ERROR_INVALID_OPERATION} 17889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 17899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int reloadStaticData() { 1790a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten if (mDataLoadMode == MODE_STREAM || mState != STATE_INITIALIZED) { 17919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return ERROR_INVALID_OPERATION; 17929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 17939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return native_reload_static(); 17949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 17959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 17967070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent //-------------------------------------------------------------------------- 17977070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent // Audio effects management 17987070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent //-------------------- 17997070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent 18007070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent /** 18011a5149e5d7f2dddc8b324f7695e69fd89af73c52Eric Laurent * Attaches an auxiliary effect to the audio track. A typical auxiliary 18021a5149e5d7f2dddc8b324f7695e69fd89af73c52Eric Laurent * effect is a reverberation effect which can be applied on any sound source 18031a5149e5d7f2dddc8b324f7695e69fd89af73c52Eric Laurent * that directs a certain amount of its energy to this effect. This amount 18041a5149e5d7f2dddc8b324f7695e69fd89af73c52Eric Laurent * is defined by setAuxEffectSendLevel(). 18057070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent * {@see #setAuxEffectSendLevel(float)}. 18061a5149e5d7f2dddc8b324f7695e69fd89af73c52Eric Laurent * <p>After creating an auxiliary effect (e.g. 18071a5149e5d7f2dddc8b324f7695e69fd89af73c52Eric Laurent * {@link android.media.audiofx.EnvironmentalReverb}), retrieve its ID with 18081a5149e5d7f2dddc8b324f7695e69fd89af73c52Eric Laurent * {@link android.media.audiofx.AudioEffect#getId()} and use it when calling 18097070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent * this method to attach the audio track to the effect. 18101a5149e5d7f2dddc8b324f7695e69fd89af73c52Eric Laurent * <p>To detach the effect from the audio track, call this method with a 18111a5149e5d7f2dddc8b324f7695e69fd89af73c52Eric Laurent * null effect id. 18127070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent * 18137070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent * @param effectId system wide unique id of the effect to attach 18147070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent * @return error code or success, see {@link #SUCCESS}, 18157070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent * {@link #ERROR_INVALID_OPERATION}, {@link #ERROR_BAD_VALUE} 18167070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent */ 18177070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent public int attachAuxEffect(int effectId) { 18183b4df62704a6184878afd9272830cf3db7bd2d66Glenn Kasten if (mState == STATE_UNINITIALIZED) { 18197070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent return ERROR_INVALID_OPERATION; 18207070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent } 18217070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent return native_attachAuxEffect(effectId); 18227070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent } 18237070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent 18247070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent /** 18257070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent * Sets the send level of the audio track to the attached auxiliary effect 182678cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * {@link #attachAuxEffect(int)}. Effect levels 182778cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * are clamped to the closed interval [0.0, max] where 182878cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * max is the value of {@link #getMaxVolume}. 182978cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * A value of 0.0 results in no effect, and a value of 1.0 is full send. 1830e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * <p>By default the send level is 0.0f, so even if an effect is attached to the player 18317070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent * this method must be called for the effect to be applied. 183278cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * <p>Note that the passed level value is a linear scalar. UI controls should be scaled 183378cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * logarithmically: the gain applied by audio framework ranges from -72dB to at least 0dB, 18347070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent * so an appropriate conversion from linear UI input x to level is: 18355c17a820f9e46e0756c11795b3e6f89105f2f539Glenn Kasten * x == 0 -> level = 0 18365c17a820f9e46e0756c11795b3e6f89105f2f539Glenn Kasten * 0 < x <= R -> level = 10^(72*(x-R)/20/R) 18377070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent * 183878cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * @param level linear send level 18397070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent * @return error code or success, see {@link #SUCCESS}, 18403009f0b911e39d3b26c69bd7667d6444eacb9d11Glenn Kasten * {@link #ERROR_INVALID_OPERATION}, {@link #ERROR} 18417070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent */ 18427070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent public int setAuxEffectSendLevel(float level) { 18431af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlock if (isRestricted()) { 18441af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlock return SUCCESS; 18451af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlock } 18463b4df62704a6184878afd9272830cf3db7bd2d66Glenn Kasten if (mState == STATE_UNINITIALIZED) { 18477070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent return ERROR_INVALID_OPERATION; 18487070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent } 184978cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten level = clampGainOrLevel(level); 18503009f0b911e39d3b26c69bd7667d6444eacb9d11Glenn Kasten int err = native_setAuxEffectSendLevel(level); 18513009f0b911e39d3b26c69bd7667d6444eacb9d11Glenn Kasten return err == 0 ? SUCCESS : ERROR; 18527070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent } 18539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 18549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //--------------------------------------------------------- 18559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Interface definitions 18569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //-------------------- 18579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 18584df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project * Interface definition for a callback to be invoked when the playback head position of 18594df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project * an AudioTrack has reached a notification marker or has increased by a certain period. 18609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 18614df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project public interface OnPlaybackPositionUpdateListener { 18629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 18639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Called on the listener to notify it that the previously set marker has been reached 18649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * by the playback head. 18659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 18669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project void onMarkerReached(AudioTrack track); 1867fb2ab9efc3805c81521afb9ff91a58ff5097a36eGlenn Kasten 18689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 18699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Called on the listener to periodically notify it that the playback head has reached 18709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * a multiple of the notification period. 18719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 18729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project void onPeriodicNotification(AudioTrack track); 18739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 18749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 18759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //--------------------------------------------------------- 18769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Inner classes 18779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //-------------------- 18789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 18794df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project * Helper class to handle the forwarding of native events to the appropriate listener 18804df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project * (potentially) handled in a different thread 18815c17a820f9e46e0756c11795b3e6f89105f2f539Glenn Kasten */ 18824df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project private class NativeEventHandlerDelegate { 18834df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project private final Handler mHandler; 1884fb2ab9efc3805c81521afb9ff91a58ff5097a36eGlenn Kasten 188595bd2329c6a36211f18be3e089eaa775ec62df62Glenn Kasten NativeEventHandlerDelegate(final AudioTrack track, 188695bd2329c6a36211f18be3e089eaa775ec62df62Glenn Kasten final OnPlaybackPositionUpdateListener listener, 188795bd2329c6a36211f18be3e089eaa775ec62df62Glenn Kasten Handler handler) { 18884df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project // find the looper for our new event handler 18894df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project Looper looper; 18904df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project if (handler != null) { 18914df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project looper = handler.getLooper(); 18924df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project } else { 1893105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project // no given handler, use the looper the AudioTrack was created in 1894105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project looper = mInitializationLooper; 18959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1896fb2ab9efc3805c81521afb9ff91a58ff5097a36eGlenn Kasten 18974df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project // construct the event handler with this looper 18984df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project if (looper != null) { 18994df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project // implement the event handler delegate 19004df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project mHandler = new Handler(looper) { 19014df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project @Override 19024df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project public void handleMessage(Message msg) { 190395bd2329c6a36211f18be3e089eaa775ec62df62Glenn Kasten if (track == null) { 19044df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project return; 19054df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project } 19064df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project switch(msg.what) { 19074df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project case NATIVE_EVENT_MARKER: 19084df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project if (listener != null) { 190995bd2329c6a36211f18be3e089eaa775ec62df62Glenn Kasten listener.onMarkerReached(track); 19104df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project } 19114df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project break; 19124df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project case NATIVE_EVENT_NEW_POS: 19134df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project if (listener != null) { 191495bd2329c6a36211f18be3e089eaa775ec62df62Glenn Kasten listener.onPeriodicNotification(track); 19154df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project } 19164df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project break; 19174df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project default: 19181f61d01508651b4475397414e1fe06af1ab8fadaGlenn Kasten loge("Unknown native event type: " + msg.what); 19194df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project break; 19204df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project } 19214df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project } 19224df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project }; 19234df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project } else { 19244df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project mHandler = null; 1925fb2ab9efc3805c81521afb9ff91a58ff5097a36eGlenn Kasten } 19264df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project } 1927fb2ab9efc3805c81521afb9ff91a58ff5097a36eGlenn Kasten 19284df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project Handler getHandler() { 19294df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project return mHandler; 19309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 19319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 19329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 19339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 19349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //--------------------------------------------------------- 19359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Java methods called from the native side 19369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //-------------------- 19379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @SuppressWarnings("unused") 19389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static void postEventFromNative(Object audiotrack_ref, 19399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int what, int arg1, int arg2, Object obj) { 19409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //logd("Event posted from the native side: event="+ what + " args="+ arg1+" "+arg2); 19419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project AudioTrack track = (AudioTrack)((WeakReference)audiotrack_ref).get(); 19429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (track == null) { 19439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return; 19449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 19459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 194695bd2329c6a36211f18be3e089eaa775ec62df62Glenn Kasten NativeEventHandlerDelegate delegate = track.mEventHandlerDelegate; 194795bd2329c6a36211f18be3e089eaa775ec62df62Glenn Kasten if (delegate != null) { 194895bd2329c6a36211f18be3e089eaa775ec62df62Glenn Kasten Handler handler = delegate.getHandler(); 194995bd2329c6a36211f18be3e089eaa775ec62df62Glenn Kasten if (handler != null) { 195095bd2329c6a36211f18be3e089eaa775ec62df62Glenn Kasten Message m = handler.obtainMessage(what, arg1, arg2, obj); 195195bd2329c6a36211f18be3e089eaa775ec62df62Glenn Kasten handler.sendMessage(m); 195295bd2329c6a36211f18be3e089eaa775ec62df62Glenn Kasten } 19539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 19549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 19559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 19569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 19579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 19589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //--------------------------------------------------------- 19599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Native methods called from the Java side 19609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //-------------------- 19619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1962a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi // post-condition: mStreamType is overwritten with a value 1963a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi // that reflects the audio attributes (e.g. an AudioAttributes object with a usage of 1964a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi // AudioAttributes.USAGE_MEDIA will map to AudioManager.STREAM_MUSIC 1965a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi private native final int native_setup(Object /*WeakReference<AudioTrack>*/ audiotrack_this, 1966a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi Object /*AudioAttributes*/ attributes, 1967a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi int sampleRate, int channelMask, int audioFormat, 1968619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent int buffSizeInBytes, int mode, int[] sessionId); 19699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 19709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private native final void native_finalize(); 19719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 19729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private native final void native_release(); 19739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 19749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private native final void native_start(); 19759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 19769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private native final void native_stop(); 19779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 19789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private native final void native_pause(); 19799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 19809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private native final void native_flush(); 19819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 19829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private native final int native_write_byte(byte[] audioData, 19837ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi int offsetInBytes, int sizeInBytes, int format, 19847ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi boolean isBlocking); 19859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 19869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private native final int native_write_short(short[] audioData, 19879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int offsetInShorts, int sizeInShorts, int format); 19889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 198954955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten private native final int native_write_float(float[] audioData, 199054955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten int offsetInFloats, int sizeInFloats, int format, 199154955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten boolean isBlocking); 199254955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten 19937ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi private native final int native_write_native_bytes(Object audioData, 19945d21f679c58dbb13c8c931ffec6e06b6b8cd454fJean-Michel Trivi int positionInBytes, int sizeInBytes, int format, boolean blocking); 19957ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi 19969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private native final int native_reload_static(); 19979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 19989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private native final int native_get_native_frame_count(); 19999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 20009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private native final void native_setVolume(float leftVolume, float rightVolume); 20019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 200288e209dcf8c2ebddda5c272f46d1bd5478bc639cEric Laurent private native final int native_set_playback_rate(int sampleRateInHz); 200388e209dcf8c2ebddda5c272f46d1bd5478bc639cEric Laurent private native final int native_get_playback_rate(); 20049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 20059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private native final int native_set_marker_pos(int marker); 20069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private native final int native_get_marker_pos(); 20079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 20089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private native final int native_set_pos_update_period(int updatePeriod); 20099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private native final int native_get_pos_update_period(); 20109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 20119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private native final int native_set_position(int position); 20129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private native final int native_get_position(); 20139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 201461dcdf3764b614c6f01e77cb4342d192e3101f8aOliver Woodman private native final int native_get_latency(); 201561dcdf3764b614c6f01e77cb4342d192e3101f8aOliver Woodman 2016948c2e6ff46d65942277f2e0e9ce0c038972b9d8Glenn Kasten // longArray must be a non-null array of length >= 2 2017948c2e6ff46d65942277f2e0e9ce0c038972b9d8Glenn Kasten // [0] is assigned the frame position 2018948c2e6ff46d65942277f2e0e9ce0c038972b9d8Glenn Kasten // [1] is assigned the time in CLOCK_MONOTONIC nanoseconds 2019948c2e6ff46d65942277f2e0e9ce0c038972b9d8Glenn Kasten private native final int native_get_timestamp(long[] longArray); 2020948c2e6ff46d65942277f2e0e9ce0c038972b9d8Glenn Kasten 20219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private native final int native_set_loop(int start, int end, int loopCount); 20229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 20239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project static private native final int native_get_output_sample_rate(int streamType); 20249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project static private native final int native_get_min_buff_size( 20259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int sampleRateInHz, int channelConfig, int audioFormat); 20269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 20277070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent private native final int native_attachAuxEffect(int effectId); 20283009f0b911e39d3b26c69bd7667d6444eacb9d11Glenn Kasten private native final int native_setAuxEffectSendLevel(float level); 20297070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent 20309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //--------------------------------------------------------- 20319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Utility methods 20329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //------------------ 20339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 20349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static void logd(String msg) { 20351f61d01508651b4475397414e1fe06af1ab8fadaGlenn Kasten Log.d(TAG, msg); 20369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 20379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 20389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static void loge(String msg) { 20391f61d01508651b4475397414e1fe06af1ab8fadaGlenn Kasten Log.e(TAG, msg); 20409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 20419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project} 2042