AudioTrack.java revision df3cb5279857cac41909643c6703e8fc1621fad1
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 199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport java.lang.ref.WeakReference; 209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport java.lang.IllegalArgumentException; 219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport java.lang.IllegalStateException; 229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.Handler; 249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.Looper; 259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.Message; 269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.media.AudioManager; 279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.util.Log; 289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/** 319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The AudioTrack class manages and plays a single audio resource for Java applications. 325c17a820f9e46e0756c11795b3e6f89105f2f539Glenn Kasten * It allows streaming PCM audio buffers to the audio hardware for playback. This is 339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * achieved by "pushing" the data to the AudioTrack object using one of the 349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #write(byte[], int, int)} and {@link #write(short[], int, int)} methods. 3588bde0ce3799c47530ea42ae3665bfa12ae38d11Narayan Kamath * 36ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * <p>An AudioTrack instance can operate under two modes: static or streaming.<br> 37ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * In Streaming mode, the application writes a continuous stream of data to the AudioTrack, using 3888bde0ce3799c47530ea42ae3665bfa12ae38d11Narayan Kamath * one of the {@code write()} methods. These are blocking and return when the data has been 3988bde0ce3799c47530ea42ae3665bfa12ae38d11Narayan Kamath * transferred from the Java layer to the native layer and queued for playback. The streaming 4088bde0ce3799c47530ea42ae3665bfa12ae38d11Narayan Kamath * mode is most useful when playing blocks of audio data that for instance are: 4188bde0ce3799c47530ea42ae3665bfa12ae38d11Narayan Kamath * 429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <ul> 439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>too big to fit in memory because of the duration of the sound to play,</li> 449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>too big to fit in memory because of the characteristics of the audio data 459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * (high sampling rate, bits per sample ...)</li> 46ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * <li>received or generated while previously queued audio is playing.</li> 479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * </ul> 4888bde0ce3799c47530ea42ae3665bfa12ae38d11Narayan Kamath * 495c17a820f9e46e0756c11795b3e6f89105f2f539Glenn Kasten * The static mode should be chosen when dealing with short sounds that fit in memory and 5088bde0ce3799c47530ea42ae3665bfa12ae38d11Narayan Kamath * that need to be played with the smallest latency possible. The static mode will 5188bde0ce3799c47530ea42ae3665bfa12ae38d11Narayan Kamath * therefore be preferred for UI and game sounds that are played often, and with the 5288bde0ce3799c47530ea42ae3665bfa12ae38d11Narayan Kamath * smallest overhead possible. 5388bde0ce3799c47530ea42ae3665bfa12ae38d11Narayan Kamath * 549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>Upon creation, an AudioTrack object initializes its associated audio buffer. 559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The size of this buffer, specified during the construction, determines how long an AudioTrack 569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * can play before running out of data.<br> 579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * For an AudioTrack using the static mode, this size is the maximum size of the sound that can 589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * be played from it.<br> 599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * For the streaming mode, data will be written to the hardware in chunks of 605c17a820f9e46e0756c11795b3e6f89105f2f539Glenn Kasten * sizes less than or equal to the total buffer size. 619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpublic class AudioTrack 639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project{ 649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //--------------------------------------------------------- 659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Constants 669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //-------------------- 679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** Minimum value for a channel volume */ 689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final float VOLUME_MIN = 0.0f; 699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** Maximum value for a channel volume */ 709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final float VOLUME_MAX = 1.0f; 719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 72ad67c9546494a7c4d9336b57889a7c19a7dbb945Glenn Kasten /** Minimum value for sample rate */ 73ad67c9546494a7c4d9336b57889a7c19a7dbb945Glenn Kasten private static final int SAMPLE_RATE_HZ_MIN = 4000; 74ad67c9546494a7c4d9336b57889a7c19a7dbb945Glenn Kasten /** Maximum value for sample rate */ 75ad67c9546494a7c4d9336b57889a7c19a7dbb945Glenn Kasten private static final int SAMPLE_RATE_HZ_MAX = 48000; 76ad67c9546494a7c4d9336b57889a7c19a7dbb945Glenn Kasten 77ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi /** indicates AudioTrack state is stopped */ 789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int PLAYSTATE_STOPPED = 1; // matches SL_PLAYSTATE_STOPPED 79ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi /** indicates AudioTrack state is paused */ 809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int PLAYSTATE_PAUSED = 2; // matches SL_PLAYSTATE_PAUSED 81ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi /** indicates AudioTrack state is playing */ 829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int PLAYSTATE_PLAYING = 3; // matches SL_PLAYSTATE_PLAYING 839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 845c17a820f9e46e0756c11795b3e6f89105f2f539Glenn Kasten // keep these values in sync with android_media_AudioTrack.cpp 859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Creation mode where audio data is transferred from Java to the native layer 879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * only once before the audio starts playing. 889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int MODE_STATIC = 0; 909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Creation mode where audio data is streamed from Java to the native layer 929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * as the audio is playing. 939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int MODE_STREAM = 1; 959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 97ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * State of an AudioTrack that was not successfully initialized upon creation. 989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int STATE_UNINITIALIZED = 0; 1009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * State of an AudioTrack that is ready to be used. 1029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int STATE_INITIALIZED = 1; 1049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * State of a successfully initialized AudioTrack that uses static data, 1069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * but that hasn't received that data yet. 1079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int STATE_NO_STATIC_DATA = 2; 1099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Error codes: 1119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // to keep in sync with frameworks/base/core/jni/android_media_AudioTrack.cpp 1129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Denotes a successful operation. 1149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int SUCCESS = 0; 1169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Denotes a generic operation failure. 1189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int ERROR = -1; 1209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Denotes a failure due to the use of an invalid value. 1229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int ERROR_BAD_VALUE = -2; 1249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Denotes a failure due to the improper use of a method. 1269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int ERROR_INVALID_OPERATION = -3; 1289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final int ERROR_NATIVESETUP_AUDIOSYSTEM = -16; 130a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent private static final int ERROR_NATIVESETUP_INVALIDCHANNELMASK = -17; 1319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final int ERROR_NATIVESETUP_INVALIDFORMAT = -18; 1329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final int ERROR_NATIVESETUP_INVALIDSTREAMTYPE = -19; 1339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final int ERROR_NATIVESETUP_NATIVEINITFAILED = -20; 1349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Events: 1369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // to keep in sync with frameworks/base/include/media/AudioTrack.h 1379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 138ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * Event id denotes when playback head has reached a previously set marker. 1399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final int NATIVE_EVENT_MARKER = 3; 1419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 142ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * Event id denotes when previously set update period has elapsed during playback. 1439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final int NATIVE_EVENT_NEW_POS = 4; 1459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private final static String TAG = "AudioTrack-Java"; 1479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //-------------------------------------------------------------------------- 1509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Member variables 1519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //-------------------- 1529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 153ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * Indicates the state of the AudioTrack instance. 1549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private int mState = STATE_UNINITIALIZED; 1569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 157ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * Indicates the play state of the AudioTrack instance. 1589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private int mPlayState = PLAYSTATE_STOPPED; 1609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Lock to make sure mPlayState updates are reflecting the actual state of the object. 1629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private final Object mPlayStateLock = new Object(); 1649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1654df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project * The listener the AudioTrack notifies when the playback position reaches a marker 1664df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project * or for periodic updates during the progression of the playback head. 1674df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project * @see #setPlaybackPositionUpdateListener(OnPlaybackPositionUpdateListener) 1689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1694df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project private OnPlaybackPositionUpdateListener mPositionListener = null; 1709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 171ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * Lock to protect event listener updates against event notifications. 1729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1734df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project private final Object mPositionListenerLock = new Object(); 1749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Size of the native audio buffer. 1769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private int mNativeBufferSizeInBytes = 0; 1789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 179ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * Handler for marker events coming from the native code. 1809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1814df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project private NativeEventHandlerDelegate mEventHandlerDelegate = null; 1829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 183ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * Looper associated with the thread that creates the AudioTrack instance. 184105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project */ 185105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project private Looper mInitializationLooper = null; 186105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project /** 1879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The audio data sampling rate in Hz. 1889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1895c17a820f9e46e0756c11795b3e6f89105f2f539Glenn Kasten private int mSampleRate; // initialized by all constructors 1909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1913026a023b8979b7ddcb3fe97bbc45531c89fda92Eric Laurent * The number of audio output channels (1 is mono, 2 is stereo). 1929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private int mChannelCount = 1; 1949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1953026a023b8979b7ddcb3fe97bbc45531c89fda92Eric Laurent * The audio channel mask. 1963026a023b8979b7ddcb3fe97bbc45531c89fda92Eric Laurent */ 1973026a023b8979b7ddcb3fe97bbc45531c89fda92Eric Laurent private int mChannels = AudioFormat.CHANNEL_OUT_MONO; 1983026a023b8979b7ddcb3fe97bbc45531c89fda92Eric Laurent 1993026a023b8979b7ddcb3fe97bbc45531c89fda92Eric Laurent /** 2009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The type of the audio stream to play. See 2019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link AudioManager#STREAM_VOICE_CALL}, {@link AudioManager#STREAM_SYSTEM}, 2025c17a820f9e46e0756c11795b3e6f89105f2f539Glenn Kasten * {@link AudioManager#STREAM_RING}, {@link AudioManager#STREAM_MUSIC}, 203b282e08ab641d4fc74d0324b7a0ce30926638dd5Glenn Kasten * {@link AudioManager#STREAM_ALARM}, {@link AudioManager#STREAM_NOTIFICATION}, and 204b282e08ab641d4fc74d0324b7a0ce30926638dd5Glenn Kasten * {@link AudioManager#STREAM_DTMF}. 2059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private int mStreamType = AudioManager.STREAM_MUSIC; 2079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The way audio is consumed by the hardware, streaming or static. 2099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private int mDataLoadMode = MODE_STREAM; 2119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 212ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * The current audio channel configuration. 2139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 214a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent private int mChannelConfiguration = AudioFormat.CHANNEL_OUT_MONO; 2159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The encoding of the audio samples. 2179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see AudioFormat#ENCODING_PCM_8BIT 2189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see AudioFormat#ENCODING_PCM_16BIT 2199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private int mAudioFormat = AudioFormat.ENCODING_PCM_16BIT; 221619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent /** 222619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * Audio session ID 223619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent */ 224619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent private int mSessionId = 0; 2259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //-------------------------------- 2289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Used exclusively by native code 2299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //-------------------- 2309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 231ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * Accessed by native methods: provides access to C++ AudioTrack object. 2329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @SuppressWarnings("unused") 2349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private int mNativeTrackInJavaObj; 2359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Accessed by native methods: provides access to the JNI data (i.e. resources used by 2379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the native AudioTrack object, but not stored in it). 2389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @SuppressWarnings("unused") 2409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private int mJniData; 2419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //-------------------------------------------------------------------------- 2449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Constructor, Finalize 2459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //-------------------- 2469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Class constructor. 2489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param streamType the type of the audio stream. See 2499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link AudioManager#STREAM_VOICE_CALL}, {@link AudioManager#STREAM_SYSTEM}, 2505c17a820f9e46e0756c11795b3e6f89105f2f539Glenn Kasten * {@link AudioManager#STREAM_RING}, {@link AudioManager#STREAM_MUSIC}, 2515c17a820f9e46e0756c11795b3e6f89105f2f539Glenn Kasten * {@link AudioManager#STREAM_ALARM}, and {@link AudioManager#STREAM_NOTIFICATION}. 2525c17a820f9e46e0756c11795b3e6f89105f2f539Glenn Kasten * @param sampleRateInHz the sample rate expressed in Hertz. 2539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param channelConfig describes the configuration of the audio channels. 254a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * See {@link AudioFormat#CHANNEL_OUT_MONO} and 255a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * {@link AudioFormat#CHANNEL_OUT_STEREO} 2569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param audioFormat the format in which the audio data is represented. 2579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * See {@link AudioFormat#ENCODING_PCM_16BIT} and 2589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link AudioFormat#ENCODING_PCM_8BIT} 2599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bufferSizeInBytes the total size (in bytes) of the buffer where audio data is read 2609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * from for playback. If using the AudioTrack in streaming mode, you can write data into 2619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * this buffer in smaller chunks than this size. If using the AudioTrack in static mode, 2629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * this is the maximum size of the sound that will be played for this instance. 263ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * See {@link #getMinBufferSize(int, int, int)} to determine the minimum required buffer size 264ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * for the successful creation of an AudioTrack instance in streaming mode. Using values 265ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * smaller than getMinBufferSize() will result in an initialization failure. 2669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param mode streaming or static buffer. See {@link #MODE_STATIC} and {@link #MODE_STREAM} 2679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws java.lang.IllegalArgumentException 2689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public AudioTrack(int streamType, int sampleRateInHz, int channelConfig, int audioFormat, 2709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int bufferSizeInBytes, int mode) 2719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throws IllegalArgumentException { 272619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent this(streamType, sampleRateInHz, channelConfig, audioFormat, 273619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent bufferSizeInBytes, mode, 0); 274619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent } 275619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent 276619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent /** 277619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * Class constructor with audio session. Use this constructor when the AudioTrack must be 278619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * attached to a particular audio session. The primary use of the audio session ID is to 279619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * associate audio effects to a particular instance of AudioTrack: if an audio session ID 280619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * is provided when creating an AudioEffect, this effect will be applied only to audio tracks 281619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * and media players in the same session and not to the output mix. 282619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * When an AudioTrack is created without specifying a session, it will create its own session 283619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * which can be retreived by calling the {@link #getAudioSessionId()} method. 2845c17a820f9e46e0756c11795b3e6f89105f2f539Glenn Kasten * If a non-zero session ID is provided, this AudioTrack will share effects attached to this 2855c17a820f9e46e0756c11795b3e6f89105f2f539Glenn Kasten * session 2865c17a820f9e46e0756c11795b3e6f89105f2f539Glenn Kasten * with all other media players or audio tracks in the same session, otherwise a new session 2875c17a820f9e46e0756c11795b3e6f89105f2f539Glenn Kasten * will be created for this track if none is supplied. 288619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * @param streamType the type of the audio stream. See 289619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * {@link AudioManager#STREAM_VOICE_CALL}, {@link AudioManager#STREAM_SYSTEM}, 2905c17a820f9e46e0756c11795b3e6f89105f2f539Glenn Kasten * {@link AudioManager#STREAM_RING}, {@link AudioManager#STREAM_MUSIC}, 2915c17a820f9e46e0756c11795b3e6f89105f2f539Glenn Kasten * {@link AudioManager#STREAM_ALARM}, and {@link AudioManager#STREAM_NOTIFICATION}. 2925c17a820f9e46e0756c11795b3e6f89105f2f539Glenn Kasten * @param sampleRateInHz the sample rate expressed in Hertz. 293619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * @param channelConfig describes the configuration of the audio channels. 294619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * See {@link AudioFormat#CHANNEL_OUT_MONO} and 295619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * {@link AudioFormat#CHANNEL_OUT_STEREO} 296619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * @param audioFormat the format in which the audio data is represented. 297619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * See {@link AudioFormat#ENCODING_PCM_16BIT} and 298619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * {@link AudioFormat#ENCODING_PCM_8BIT} 299619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * @param bufferSizeInBytes the total size (in bytes) of the buffer where audio data is read 300619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * from for playback. If using the AudioTrack in streaming mode, you can write data into 301619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * this buffer in smaller chunks than this size. If using the AudioTrack in static mode, 302619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * this is the maximum size of the sound that will be played for this instance. 303619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * See {@link #getMinBufferSize(int, int, int)} to determine the minimum required buffer size 304619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * for the successful creation of an AudioTrack instance in streaming mode. Using values 305619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * smaller than getMinBufferSize() will result in an initialization failure. 306619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * @param mode streaming or static buffer. See {@link #MODE_STATIC} and {@link #MODE_STREAM} 307619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * @param sessionId Id of audio session the AudioTrack must be attached to 308619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * @throws java.lang.IllegalArgumentException 309619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent */ 310619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent public AudioTrack(int streamType, int sampleRateInHz, int channelConfig, int audioFormat, 311619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent int bufferSizeInBytes, int mode, int sessionId) 312619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent throws IllegalArgumentException { 3139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mState = STATE_UNINITIALIZED; 3145c17a820f9e46e0756c11795b3e6f89105f2f539Glenn Kasten 3155c17a820f9e46e0756c11795b3e6f89105f2f539Glenn Kasten // remember which looper is associated with the AudioTrack instantiation 316105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project if ((mInitializationLooper = Looper.myLooper()) == null) { 317105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project mInitializationLooper = Looper.getMainLooper(); 318105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project } 3199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project audioParamCheck(streamType, sampleRateInHz, channelConfig, audioFormat, mode); 3219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project audioBuffSizeCheck(bufferSizeInBytes); 3239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 324619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent if (sessionId < 0) { 325619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent throw (new IllegalArgumentException("Invalid audio session ID: "+sessionId)); 326619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent } 327619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent 328619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent int[] session = new int[1]; 329619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent session[0] = sessionId; 3309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // native initialization 3319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int initResult = native_setup(new WeakReference<AudioTrack>(this), 3323026a023b8979b7ddcb3fe97bbc45531c89fda92Eric Laurent mStreamType, mSampleRate, mChannels, mAudioFormat, 333619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent mNativeBufferSizeInBytes, mDataLoadMode, session); 3349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (initResult != SUCCESS) { 3359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project loge("Error code "+initResult+" when initializing AudioTrack."); 3369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return; // with mState == STATE_UNINITIALIZED 3379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 339619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent mSessionId = session[0]; 340619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent 3419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mDataLoadMode == MODE_STATIC) { 3429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mState = STATE_NO_STATIC_DATA; 3439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 3449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mState = STATE_INITIALIZED; 3459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3481b8f499a14a4340d3422d95c7f6fdc8c0c72b3a4Jean-Michel Trivi // mask of all the channels supported by this implementation 3491b8f499a14a4340d3422d95c7f6fdc8c0c72b3a4Jean-Michel Trivi private static final int SUPPORTED_OUT_CHANNELS = 3501b8f499a14a4340d3422d95c7f6fdc8c0c72b3a4Jean-Michel Trivi AudioFormat.CHANNEL_OUT_FRONT_LEFT | 3511b8f499a14a4340d3422d95c7f6fdc8c0c72b3a4Jean-Michel Trivi AudioFormat.CHANNEL_OUT_FRONT_RIGHT | 3521b8f499a14a4340d3422d95c7f6fdc8c0c72b3a4Jean-Michel Trivi AudioFormat.CHANNEL_OUT_FRONT_CENTER | 3531b8f499a14a4340d3422d95c7f6fdc8c0c72b3a4Jean-Michel Trivi AudioFormat.CHANNEL_OUT_LOW_FREQUENCY | 3541b8f499a14a4340d3422d95c7f6fdc8c0c72b3a4Jean-Michel Trivi AudioFormat.CHANNEL_OUT_BACK_LEFT | 3551b8f499a14a4340d3422d95c7f6fdc8c0c72b3a4Jean-Michel Trivi AudioFormat.CHANNEL_OUT_BACK_RIGHT | 3561b8f499a14a4340d3422d95c7f6fdc8c0c72b3a4Jean-Michel Trivi AudioFormat.CHANNEL_OUT_BACK_CENTER; 3579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Convenience method for the constructor's parameter checks. 3599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // This is where constructor IllegalArgumentException-s are thrown 3609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // postconditions: 3619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // mStreamType is valid 3629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // mChannelCount is valid 3633026a023b8979b7ddcb3fe97bbc45531c89fda92Eric Laurent // mChannels is valid 3649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // mAudioFormat is valid 3659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // mSampleRate is valid 3669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // mDataLoadMode is valid 3679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private void audioParamCheck(int streamType, int sampleRateInHz, 3689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int channelConfig, int audioFormat, int mode) { 3699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //-------------- 3719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // stream type 3729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if( (streamType != AudioManager.STREAM_ALARM) && (streamType != AudioManager.STREAM_MUSIC) 3739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project && (streamType != AudioManager.STREAM_RING) && (streamType != AudioManager.STREAM_SYSTEM) 3749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project && (streamType != AudioManager.STREAM_VOICE_CALL) 3759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project && (streamType != AudioManager.STREAM_NOTIFICATION) 376a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent && (streamType != AudioManager.STREAM_BLUETOOTH_SCO) 377a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent && (streamType != AudioManager.STREAM_DTMF)) { 3789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw (new IllegalArgumentException("Invalid stream type.")); 3799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 3809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mStreamType = streamType; 3819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //-------------- 3845c17a820f9e46e0756c11795b3e6f89105f2f539Glenn Kasten // sample rate, note these values are subject to change 3859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if ( (sampleRateInHz < 4000) || (sampleRateInHz > 48000) ) { 3869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw (new IllegalArgumentException(sampleRateInHz 3879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project + "Hz is not a supported sample rate.")); 3889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 3899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mSampleRate = sampleRateInHz; 3909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //-------------- 3939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // channel config 3943026a023b8979b7ddcb3fe97bbc45531c89fda92Eric Laurent mChannelConfiguration = channelConfig; 3953026a023b8979b7ddcb3fe97bbc45531c89fda92Eric Laurent 3969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project switch (channelConfig) { 3973026a023b8979b7ddcb3fe97bbc45531c89fda92Eric Laurent case AudioFormat.CHANNEL_OUT_DEFAULT: //AudioFormat.CHANNEL_CONFIGURATION_DEFAULT 398a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent case AudioFormat.CHANNEL_OUT_MONO: 3993026a023b8979b7ddcb3fe97bbc45531c89fda92Eric Laurent case AudioFormat.CHANNEL_CONFIGURATION_MONO: 4009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mChannelCount = 1; 4013026a023b8979b7ddcb3fe97bbc45531c89fda92Eric Laurent mChannels = AudioFormat.CHANNEL_OUT_MONO; 4029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project break; 403a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent case AudioFormat.CHANNEL_OUT_STEREO: 4043026a023b8979b7ddcb3fe97bbc45531c89fda92Eric Laurent case AudioFormat.CHANNEL_CONFIGURATION_STEREO: 4059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mChannelCount = 2; 4063026a023b8979b7ddcb3fe97bbc45531c89fda92Eric Laurent mChannels = AudioFormat.CHANNEL_OUT_STEREO; 4079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project break; 4089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project default: 409d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi if (!isMultichannelConfigSupported(channelConfig)) { 4101b8f499a14a4340d3422d95c7f6fdc8c0c72b3a4Jean-Michel Trivi // input channel configuration features unsupported channels 4111b8f499a14a4340d3422d95c7f6fdc8c0c72b3a4Jean-Michel Trivi mChannelCount = 0; 4121b8f499a14a4340d3422d95c7f6fdc8c0c72b3a4Jean-Michel Trivi mChannels = AudioFormat.CHANNEL_INVALID; 4131b8f499a14a4340d3422d95c7f6fdc8c0c72b3a4Jean-Michel Trivi mChannelConfiguration = AudioFormat.CHANNEL_INVALID; 4141b8f499a14a4340d3422d95c7f6fdc8c0c72b3a4Jean-Michel Trivi throw(new IllegalArgumentException("Unsupported channel configuration.")); 4151b8f499a14a4340d3422d95c7f6fdc8c0c72b3a4Jean-Michel Trivi } else { 4161b8f499a14a4340d3422d95c7f6fdc8c0c72b3a4Jean-Michel Trivi mChannels = channelConfig; 4171b8f499a14a4340d3422d95c7f6fdc8c0c72b3a4Jean-Michel Trivi mChannelCount = Integer.bitCount(channelConfig); 4181b8f499a14a4340d3422d95c7f6fdc8c0c72b3a4Jean-Michel Trivi } 4199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //-------------- 4229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // audio format 4239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project switch (audioFormat) { 4249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project case AudioFormat.ENCODING_DEFAULT: 4259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mAudioFormat = AudioFormat.ENCODING_PCM_16BIT; 4269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project break; 4279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project case AudioFormat.ENCODING_PCM_16BIT: 4289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project case AudioFormat.ENCODING_PCM_8BIT: 4299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mAudioFormat = audioFormat; 4309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project break; 4319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project default: 4329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mAudioFormat = AudioFormat.ENCODING_INVALID; 4339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw(new IllegalArgumentException("Unsupported sample encoding." 4349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project + " Should be ENCODING_PCM_8BIT or ENCODING_PCM_16BIT.")); 4359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //-------------- 4389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // audio load mode 4399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if ( (mode != MODE_STREAM) && (mode != MODE_STATIC) ) { 4409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw(new IllegalArgumentException("Invalid mode.")); 4419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 4429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mDataLoadMode = mode; 4439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 446d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi /** 447d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi * Convenience method to check that the channel configuration (a.k.a channel mask) is supported 448d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi * @param channelConfig the mask to validate 449d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi * @return false if the AudioTrack can't be used with such a mask 450d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi */ 451d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi private static boolean isMultichannelConfigSupported(int channelConfig) { 452d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi // check for unsupported channels 453d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi if ((channelConfig & SUPPORTED_OUT_CHANNELS) != channelConfig) { 454d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi Log.e(TAG, "Channel configuration features unsupported channels"); 455d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi return false; 456d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi } 457d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi // check for unsupported multichannel combinations: 458d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi // - FL/FR must be present 459d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi // - L/R channels must be paired (e.g. no single L channel) 460d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi final int frontPair = 461d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi AudioFormat.CHANNEL_OUT_FRONT_LEFT | AudioFormat.CHANNEL_OUT_FRONT_RIGHT; 462d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi if ((channelConfig & frontPair) != frontPair) { 463d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi Log.e(TAG, "Front channels must be present in multichannel configurations"); 464d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi return false; 465d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi } 466d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi final int backPair = 467d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi AudioFormat.CHANNEL_OUT_BACK_LEFT | AudioFormat.CHANNEL_OUT_BACK_RIGHT; 468d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi if ((channelConfig & backPair) != 0) { 469d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi if ((channelConfig & backPair) != backPair) { 470d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi Log.e(TAG, "Rear channels can't be used independently"); 471d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi return false; 472d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi } 473d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi } 474d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi return true; 475d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi } 476d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi 4779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Convenience method for the contructor's audio buffer size check. 4799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // preconditions: 4809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // mChannelCount is valid 4819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // mAudioFormat is valid 4829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // postcondition: 4839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // mNativeBufferSizeInBytes is valid (multiple of frame size, positive) 4849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private void audioBuffSizeCheck(int audioBufferSize) { 4859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // NB: this section is only valid with PCM data. 4869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // To update when supporting compressed formats 4879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int frameSizeInBytes = mChannelCount 4889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * (mAudioFormat == AudioFormat.ENCODING_PCM_8BIT ? 1 : 2); 4899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if ((audioBufferSize % frameSizeInBytes != 0) || (audioBufferSize < 1)) { 4909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw (new IllegalArgumentException("Invalid audio buffer size.")); 4919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mNativeBufferSizeInBytes = audioBufferSize; 4949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Releases the native AudioTrack resources. 4999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void release() { 5019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // even though native_release() stops the native AudioTrack, we need to stop 5029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // AudioTrack subclasses too. 5039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 5049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project stop(); 505fb2ab9efc3805c81521afb9ff91a58ff5097a36eGlenn Kasten } catch(IllegalStateException ise) { 5069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // don't raise an exception, we're releasing the resources. 5079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project native_release(); 5099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mState = STATE_UNINITIALIZED; 5109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 5139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project protected void finalize() { 5149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project native_finalize(); 5159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //-------------------------------------------------------------------------- 5189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Getters 5199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //-------------------- 5209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the minimum valid volume value. Volume values set under this one will 5229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * be clamped at this value. 5239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return the minimum volume expressed as a linear attenuation. 5249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project static public float getMinVolume() { 526df3cb5279857cac41909643c6703e8fc1621fad1Glenn Kasten return VOLUME_MIN; 5279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the maximum valid volume value. Volume values set above this one will 5319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * be clamped at this value. 5329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return the maximum volume expressed as a linear attenuation. 5339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project static public float getMaxVolume() { 535df3cb5279857cac41909643c6703e8fc1621fad1Glenn Kasten return VOLUME_MAX; 5369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the configured audio data sample rate in Hz 5409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getSampleRate() { 5429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mSampleRate; 5439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 544fb2ab9efc3805c81521afb9ff91a58ff5097a36eGlenn Kasten 5459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 54688e209dcf8c2ebddda5c272f46d1bd5478bc639cEric Laurent * Returns the current playback rate in Hz. 5479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getPlaybackRate() { 5499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return native_get_playback_rate(); 5509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the configured audio data format. See {@link AudioFormat#ENCODING_PCM_16BIT} 5549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * and {@link AudioFormat#ENCODING_PCM_8BIT}. 5559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getAudioFormat() { 5579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mAudioFormat; 5589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the type of audio stream this AudioTrack is configured for. 5629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Compare the result against {@link AudioManager#STREAM_VOICE_CALL}, 5639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link AudioManager#STREAM_SYSTEM}, {@link AudioManager#STREAM_RING}, 5645c17a820f9e46e0756c11795b3e6f89105f2f539Glenn Kasten * {@link AudioManager#STREAM_MUSIC}, {@link AudioManager#STREAM_ALARM}, 565b282e08ab641d4fc74d0324b7a0ce30926638dd5Glenn Kasten * {@link AudioManager#STREAM_NOTIFICATION}, or {@link AudioManager#STREAM_DTMF}. 5669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getStreamType() { 5689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mStreamType; 5699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the configured channel configuration. 5739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 574a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * See {@link AudioFormat#CHANNEL_OUT_MONO} 575a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * and {@link AudioFormat#CHANNEL_OUT_STEREO}. 5769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getChannelConfiguration() { 5789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mChannelConfiguration; 5799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the configured number of channels. 5839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getChannelCount() { 5859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mChannelCount; 5869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the state of the AudioTrack instance. This is useful after the 5909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * AudioTrack instance has been created to check if it was initialized 5919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * properly. This ensures that the appropriate hardware resources have been 5929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * acquired. 593ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * @see #STATE_INITIALIZED 594ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * @see #STATE_NO_STATIC_DATA 595ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * @see #STATE_UNINITIALIZED 5969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getState() { 5989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mState; 5999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the playback state of the AudioTrack instance. 6039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #PLAYSTATE_STOPPED 6049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #PLAYSTATE_PAUSED 6059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #PLAYSTATE_PLAYING 6069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getPlayState() { 60806e0333c7eb50533cc6e0f7b61812d2840844296Narayan Kamath synchronized (mPlayStateLock) { 60906e0333c7eb50533cc6e0f7b61812d2840844296Narayan Kamath return mPlayState; 61006e0333c7eb50533cc6e0f7b61812d2840844296Narayan Kamath } 6119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 614ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * Returns the native frame count used by the hardware. 6159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project protected int getNativeFrameCount() { 6179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return native_get_native_frame_count(); 6189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 621ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * Returns marker position expressed in frames. 6229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getNotificationMarkerPosition() { 6249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return native_get_marker_pos(); 6259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 628ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * Returns the notification update period expressed in frames. 6299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getPositionNotificationPeriod() { 6319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return native_get_pos_update_period(); 6329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 635ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * Returns the playback head position expressed in frames 6369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getPlaybackHeadPosition() { 6389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return native_get_position(); 6399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the hardware output sample rate 6439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project static public int getNativeOutputSampleRate(int streamType) { 6459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return native_get_output_sample_rate(streamType); 6469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 647fb2ab9efc3805c81521afb9ff91a58ff5097a36eGlenn Kasten 6489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the minimum buffer size required for the successful creation of an AudioTrack 650ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * object to be created in the {@link #MODE_STREAM} mode. Note that this size doesn't 651ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * guarantee a smooth playback under load, and higher values should be chosen according to 652fb2ab9efc3805c81521afb9ff91a58ff5097a36eGlenn Kasten * the expected frequency at which the buffer will be refilled with additional data to play. 6539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param sampleRateInHz the sample rate expressed in Hertz. 654fb2ab9efc3805c81521afb9ff91a58ff5097a36eGlenn Kasten * @param channelConfig describes the configuration of the audio channels. 655a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * See {@link AudioFormat#CHANNEL_OUT_MONO} and 656a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * {@link AudioFormat#CHANNEL_OUT_STEREO} 657fb2ab9efc3805c81521afb9ff91a58ff5097a36eGlenn Kasten * @param audioFormat the format in which the audio data is represented. 658fb2ab9efc3805c81521afb9ff91a58ff5097a36eGlenn Kasten * See {@link AudioFormat#ENCODING_PCM_16BIT} and 6599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link AudioFormat#ENCODING_PCM_8BIT} 6609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return {@link #ERROR_BAD_VALUE} if an invalid parameter was passed, 661fb2ab9efc3805c81521afb9ff91a58ff5097a36eGlenn Kasten * or {@link #ERROR} if the implementation was unable to query the hardware for its output 662fb2ab9efc3805c81521afb9ff91a58ff5097a36eGlenn Kasten * properties, 663ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * or the minimum buffer size expressed in bytes. 6649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project static public int getMinBufferSize(int sampleRateInHz, int channelConfig, int audioFormat) { 6669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int channelCount = 0; 6679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project switch(channelConfig) { 668a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent case AudioFormat.CHANNEL_OUT_MONO: 6693026a023b8979b7ddcb3fe97bbc45531c89fda92Eric Laurent case AudioFormat.CHANNEL_CONFIGURATION_MONO: 6709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project channelCount = 1; 6719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project break; 672a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent case AudioFormat.CHANNEL_OUT_STEREO: 6733026a023b8979b7ddcb3fe97bbc45531c89fda92Eric Laurent case AudioFormat.CHANNEL_CONFIGURATION_STEREO: 6749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project channelCount = 2; 6759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project break; 6769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project default: 6771b8f499a14a4340d3422d95c7f6fdc8c0c72b3a4Jean-Michel Trivi if ((channelConfig & SUPPORTED_OUT_CHANNELS) != channelConfig) { 6781b8f499a14a4340d3422d95c7f6fdc8c0c72b3a4Jean-Michel Trivi // input channel configuration features unsupported channels 6791b8f499a14a4340d3422d95c7f6fdc8c0c72b3a4Jean-Michel Trivi loge("getMinBufferSize(): Invalid channel configuration."); 680df3cb5279857cac41909643c6703e8fc1621fad1Glenn Kasten return ERROR_BAD_VALUE; 6811b8f499a14a4340d3422d95c7f6fdc8c0c72b3a4Jean-Michel Trivi } else { 6821b8f499a14a4340d3422d95c7f6fdc8c0c72b3a4Jean-Michel Trivi channelCount = Integer.bitCount(channelConfig); 6831b8f499a14a4340d3422d95c7f6fdc8c0c72b3a4Jean-Michel Trivi } 6849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 685fb2ab9efc3805c81521afb9ff91a58ff5097a36eGlenn Kasten 686fb2ab9efc3805c81521afb9ff91a58ff5097a36eGlenn Kasten if ((audioFormat != AudioFormat.ENCODING_PCM_16BIT) 6879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project && (audioFormat != AudioFormat.ENCODING_PCM_8BIT)) { 6889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project loge("getMinBufferSize(): Invalid audio format."); 689df3cb5279857cac41909643c6703e8fc1621fad1Glenn Kasten return ERROR_BAD_VALUE; 6909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 691fb2ab9efc3805c81521afb9ff91a58ff5097a36eGlenn Kasten 6925c17a820f9e46e0756c11795b3e6f89105f2f539Glenn Kasten // sample rate, note these values are subject to change 693ad67c9546494a7c4d9336b57889a7c19a7dbb945Glenn Kasten if ( (sampleRateInHz < SAMPLE_RATE_HZ_MIN) || (sampleRateInHz > SAMPLE_RATE_HZ_MAX) ) { 694ad67c9546494a7c4d9336b57889a7c19a7dbb945Glenn Kasten loge("getMinBufferSize(): " + sampleRateInHz + " Hz is not a supported sample rate."); 695df3cb5279857cac41909643c6703e8fc1621fad1Glenn Kasten return ERROR_BAD_VALUE; 6969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 697fb2ab9efc3805c81521afb9ff91a58ff5097a36eGlenn Kasten 6989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int size = native_get_min_buff_size(sampleRateInHz, channelCount, audioFormat); 6999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if ((size == -1) || (size == 0)) { 7009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project loge("getMinBufferSize(): error querying hardware"); 701df3cb5279857cac41909643c6703e8fc1621fad1Glenn Kasten return ERROR; 7029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project else { 7049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return size; 7059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 708619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent /** 709619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * Returns the audio session ID. 710619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * 711619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * @return the ID of the audio session this AudioTrack belongs to. 712619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent */ 713619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent public int getAudioSessionId() { 714619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent return mSessionId; 715619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent } 7169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //-------------------------------------------------------------------------- 7189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Initialization / configuration 7199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //-------------------- 7209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7214df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project * Sets the listener the AudioTrack notifies when a previously set marker is reached or 7224df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project * for each periodic playback head position update. 723ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * Notifications will be received in the same thread as the one in which the AudioTrack 724ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * instance was created. 7259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param listener 7269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7274df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project public void setPlaybackPositionUpdateListener(OnPlaybackPositionUpdateListener listener) { 7284df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project setPlaybackPositionUpdateListener(listener, null); 7299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 730fb2ab9efc3805c81521afb9ff91a58ff5097a36eGlenn Kasten 731ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi /** 732ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * Sets the listener the AudioTrack notifies when a previously set marker is reached or 733ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * for each periodic playback head position update. 734ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * Use this method to receive AudioTrack events in the Handler associated with another 735ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * thread than the one in which you created the AudioTrack instance. 736ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * @param listener 737ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * @param handler the Handler that will receive the event notification messages. 738ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi */ 739fb2ab9efc3805c81521afb9ff91a58ff5097a36eGlenn Kasten public void setPlaybackPositionUpdateListener(OnPlaybackPositionUpdateListener listener, 7404df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project Handler handler) { 7414df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project synchronized (mPositionListenerLock) { 7424df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project mPositionListener = listener; 7439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7444df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project if (listener != null) { 7454df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project mEventHandlerDelegate = new NativeEventHandlerDelegate(this, handler); 7469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 747fb2ab9efc3805c81521afb9ff91a58ff5097a36eGlenn Kasten 7489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7514df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project 7529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets the specified left/right output volume values on the AudioTrack. Values are clamped 7549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * to the ({@link #getMinVolume()}, {@link #getMaxVolume()}) interval if outside this range. 7559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param leftVolume output attenuation for the left channel. A value of 0.0f is silence, 7569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * a value of 1.0f is no attenuation. 7579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param rightVolume output attenuation for the right channel 7589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return error code or success, see {@link #SUCCESS}, 7599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #ERROR_INVALID_OPERATION} 7609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int setStereoVolume(float leftVolume, float rightVolume) { 7629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mState != STATE_INITIALIZED) { 7639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return ERROR_INVALID_OPERATION; 7649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // clamp the volumes 7679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (leftVolume < getMinVolume()) { 7689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project leftVolume = getMinVolume(); 7699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (leftVolume > getMaxVolume()) { 7719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project leftVolume = getMaxVolume(); 7729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (rightVolume < getMinVolume()) { 7749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project rightVolume = getMinVolume(); 7759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (rightVolume > getMaxVolume()) { 7779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project rightVolume = getMaxVolume(); 7789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project native_setVolume(leftVolume, rightVolume); 7819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return SUCCESS; 7839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 787068225de0197df07a0247b2877666ea91c22c992Glenn Kasten * Similar, except set volume of all channels to same value. 788068225de0197df07a0247b2877666ea91c22c992Glenn Kasten * @hide 789068225de0197df07a0247b2877666ea91c22c992Glenn Kasten */ 790068225de0197df07a0247b2877666ea91c22c992Glenn Kasten public int setVolume(float volume) { 791068225de0197df07a0247b2877666ea91c22c992Glenn Kasten return setStereoVolume(volume, volume); 792068225de0197df07a0247b2877666ea91c22c992Glenn Kasten } 793068225de0197df07a0247b2877666ea91c22c992Glenn Kasten 794068225de0197df07a0247b2877666ea91c22c992Glenn Kasten 795068225de0197df07a0247b2877666ea91c22c992Glenn Kasten /** 7969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets the playback sample rate for this track. This sets the sampling rate at which 7979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the audio data will be consumed and played back, not the original sampling rate of the 7989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * content. Setting it to half the sample rate of the content will cause the playback to 79988e209dcf8c2ebddda5c272f46d1bd5478bc639cEric Laurent * last twice as long, but will also result in a negative pitch shift. 8005c17a820f9e46e0756c11795b3e6f89105f2f539Glenn Kasten * The valid sample rate range is from 1Hz to twice the value returned by 80188e209dcf8c2ebddda5c272f46d1bd5478bc639cEric Laurent * {@link #getNativeOutputSampleRate(int)}. 802ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * @param sampleRateInHz the sample rate expressed in Hz 8039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return error code or success, see {@link #SUCCESS}, {@link #ERROR_BAD_VALUE}, 8049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #ERROR_INVALID_OPERATION} 8059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int setPlaybackRate(int sampleRateInHz) { 8079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mState != STATE_INITIALIZED) { 8089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return ERROR_INVALID_OPERATION; 8099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (sampleRateInHz <= 0) { 8119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return ERROR_BAD_VALUE; 8129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 81388e209dcf8c2ebddda5c272f46d1bd5478bc639cEric Laurent return native_set_playback_rate(sampleRateInHz); 8149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 818ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * Sets the position of the notification marker. 8199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param markerInFrames marker in frames 8209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return error code or success, see {@link #SUCCESS}, {@link #ERROR_BAD_VALUE}, 8219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #ERROR_INVALID_OPERATION} 8229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int setNotificationMarkerPosition(int markerInFrames) { 8249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mState != STATE_INITIALIZED) { 8259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return ERROR_INVALID_OPERATION; 8269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return native_set_marker_pos(markerInFrames); 8289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 832ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * Sets the period for the periodic notification event. 833ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * @param periodInFrames update period expressed in frames 8349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return error code or success, see {@link #SUCCESS}, {@link #ERROR_INVALID_OPERATION} 8359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int setPositionNotificationPeriod(int periodInFrames) { 8379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mState != STATE_INITIALIZED) { 8389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return ERROR_INVALID_OPERATION; 8399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return native_set_pos_update_period(periodInFrames); 8419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets the playback head position. The track must be stopped for the position to be changed. 846ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * @param positionInFrames playback head position expressed in frames 8479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return error code or success, see {@link #SUCCESS}, {@link #ERROR_BAD_VALUE}, 8489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #ERROR_INVALID_OPERATION} 8499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int setPlaybackHeadPosition(int positionInFrames) { 8519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project synchronized(mPlayStateLock) { 8529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if ((mPlayState == PLAYSTATE_STOPPED) || (mPlayState == PLAYSTATE_PAUSED)) { 8539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return native_set_position(positionInFrames); 8549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 8559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return ERROR_INVALID_OPERATION; 8569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets the loop points and the loop count. The loop can be infinite. 862ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * @param startInFrames loop start marker expressed in frames 863ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * @param endInFrames loop end marker expressed in frames 8649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param loopCount the number of times the loop is looped. 8659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * A value of -1 means infinite looping. 8669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return error code or success, see {@link #SUCCESS}, {@link #ERROR_BAD_VALUE}, 8679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #ERROR_INVALID_OPERATION} 8689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int setLoopPoints(int startInFrames, int endInFrames, int loopCount) { 8709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mDataLoadMode == MODE_STREAM) { 8719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return ERROR_INVALID_OPERATION; 8729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return native_set_loop(startInFrames, endInFrames, loopCount); 8749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets the initialization state of the instance. To be used in an AudioTrack subclass 8789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * constructor to set a subclass-specific post-initialization state. 8799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param state the state of the AudioTrack instance 8809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project protected void setState(int state) { 8829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mState = state; 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 // Transport control methods 8889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //-------------------- 8899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Starts playing an AudioTrack. 89188bde0ce3799c47530ea42ae3665bfa12ae38d11Narayan Kamath * 8929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws IllegalStateException 8939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void play() 8959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throws IllegalStateException { 8969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mState != STATE_INITIALIZED) { 8979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw(new IllegalStateException("play() called on uninitialized AudioTrack.")); 8989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project synchronized(mPlayStateLock) { 9019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project native_start(); 9029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mPlayState = PLAYSTATE_PLAYING; 9039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Stops playing the audio data. 908a701da8ebabb3d63ac57b7718055698abb21804aJean-Michel Trivi * When used on an instance created in {@link #MODE_STREAM} mode, audio will stop playing 909a701da8ebabb3d63ac57b7718055698abb21804aJean-Michel Trivi * after the last buffer that was written has been played. For an immediate stop, use 910a701da8ebabb3d63ac57b7718055698abb21804aJean-Michel Trivi * {@link #pause()}, followed by {@link #flush()} to discard audio data that hasn't been played 911a701da8ebabb3d63ac57b7718055698abb21804aJean-Michel Trivi * back yet. 9129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws IllegalStateException 9139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void stop() 9159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throws IllegalStateException { 9169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mState != STATE_INITIALIZED) { 9179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw(new IllegalStateException("stop() called on uninitialized AudioTrack.")); 9189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // stop playing 9219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project synchronized(mPlayStateLock) { 9229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project native_stop(); 9239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mPlayState = PLAYSTATE_STOPPED; 9249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 92888bde0ce3799c47530ea42ae3665bfa12ae38d11Narayan Kamath * Pauses the playback of the audio data. Data that has not been played 92988bde0ce3799c47530ea42ae3665bfa12ae38d11Narayan Kamath * back will not be discarded. Subsequent calls to {@link #play} will play 930a701da8ebabb3d63ac57b7718055698abb21804aJean-Michel Trivi * this data back. See {@link #flush()} to discard this data. 93188bde0ce3799c47530ea42ae3665bfa12ae38d11Narayan Kamath * 9329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws IllegalStateException 9339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void pause() 9359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throws IllegalStateException { 9369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mState != STATE_INITIALIZED) { 9379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw(new IllegalStateException("pause() called on uninitialized AudioTrack.")); 9389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //logd("pause()"); 9409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // pause playback 9429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project synchronized(mPlayStateLock) { 9439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project native_pause(); 9449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mPlayState = PLAYSTATE_PAUSED; 9459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //--------------------------------------------------------- 9509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Audio data supply 9519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //-------------------- 9529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 95488bde0ce3799c47530ea42ae3665bfa12ae38d11Narayan Kamath * Flushes the audio data currently queued for playback. Any data that has 95588bde0ce3799c47530ea42ae3665bfa12ae38d11Narayan Kamath * not been played back will be discarded. 9569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void flush() { 9589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mState == STATE_INITIALIZED) { 9599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // flush the data in native layer 9609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project native_flush(); 9619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 96688bde0ce3799c47530ea42ae3665bfa12ae38d11Narayan Kamath * Writes the audio data to the audio hardware for playback. Will block until 96788bde0ce3799c47530ea42ae3665bfa12ae38d11Narayan Kamath * all data has been written to the audio mixer. 96888bde0ce3799c47530ea42ae3665bfa12ae38d11Narayan Kamath * Note that the actual playback of this data might occur after this function 96988bde0ce3799c47530ea42ae3665bfa12ae38d11Narayan Kamath * returns. This function is thread safe with respect to {@link #stop} calls, 97088bde0ce3799c47530ea42ae3665bfa12ae38d11Narayan Kamath * in which case all of the specified data might not be written to the mixer. 97188bde0ce3799c47530ea42ae3665bfa12ae38d11Narayan Kamath * 9729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param audioData the array that holds the data to play. 97388bde0ce3799c47530ea42ae3665bfa12ae38d11Narayan Kamath * @param offsetInBytes the offset expressed in bytes in audioData where the data to play 974ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * starts. 9759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param sizeInBytes the number of bytes to read in audioData after the offset. 9769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return the number of bytes that were written or {@link #ERROR_INVALID_OPERATION} 9779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * if the object wasn't properly initialized, or {@link #ERROR_BAD_VALUE} if 9789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the parameters don't resolve to valid data and indexes. 9799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9815c17a820f9e46e0756c11795b3e6f89105f2f539Glenn Kasten public int write(byte[] audioData, int offsetInBytes, int sizeInBytes) { 9829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if ((mDataLoadMode == MODE_STATIC) 9839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project && (mState == STATE_NO_STATIC_DATA) 9849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project && (sizeInBytes > 0)) { 9859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mState = STATE_INITIALIZED; 9869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mState != STATE_INITIALIZED) { 9899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return ERROR_INVALID_OPERATION; 9909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 992fb2ab9efc3805c81521afb9ff91a58ff5097a36eGlenn Kasten if ( (audioData == null) || (offsetInBytes < 0 ) || (sizeInBytes < 0) 9939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project || (offsetInBytes + sizeInBytes > audioData.length)) { 9949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return ERROR_BAD_VALUE; 9959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return native_write_byte(audioData, offsetInBytes, sizeInBytes, mAudioFormat); 9989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 100288bde0ce3799c47530ea42ae3665bfa12ae38d11Narayan Kamath * Writes the audio data to the audio hardware for playback. Will block until 100388bde0ce3799c47530ea42ae3665bfa12ae38d11Narayan Kamath * all data has been written to the audio mixer. 100488bde0ce3799c47530ea42ae3665bfa12ae38d11Narayan Kamath * Note that the actual playback of this data might occur after this function 100588bde0ce3799c47530ea42ae3665bfa12ae38d11Narayan Kamath * returns. This function is thread safe with respect to {@link #stop} calls, 100688bde0ce3799c47530ea42ae3665bfa12ae38d11Narayan Kamath * in which case all of the specified data might not be written to the mixer. 100788bde0ce3799c47530ea42ae3665bfa12ae38d11Narayan Kamath * 10089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param audioData the array that holds the data to play. 1009ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * @param offsetInShorts the offset expressed in shorts in audioData where the data to play 1010ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * starts. 10119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param sizeInShorts the number of bytes to read in audioData after the offset. 10129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return the number of shorts that were written or {@link #ERROR_INVALID_OPERATION} 10139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * if the object wasn't properly initialized, or {@link #ERROR_BAD_VALUE} if 10149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the parameters don't resolve to valid data and indexes. 10159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 10169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int write(short[] audioData, int offsetInShorts, int sizeInShorts) { 10189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if ((mDataLoadMode == MODE_STATIC) 10199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project && (mState == STATE_NO_STATIC_DATA) 10209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project && (sizeInShorts > 0)) { 10219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mState = STATE_INITIALIZED; 10229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1023fb2ab9efc3805c81521afb9ff91a58ff5097a36eGlenn Kasten 10249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mState != STATE_INITIALIZED) { 10259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return ERROR_INVALID_OPERATION; 10269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1028fb2ab9efc3805c81521afb9ff91a58ff5097a36eGlenn Kasten if ( (audioData == null) || (offsetInShorts < 0 ) || (sizeInShorts < 0) 10299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project || (offsetInShorts + sizeInShorts > audioData.length)) { 10309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return ERROR_BAD_VALUE; 10319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return native_write_short(audioData, offsetInShorts, sizeInShorts, mAudioFormat); 10349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 10389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Notifies the native resource to reuse the audio data already loaded in the native 10399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * layer. This call is only valid with AudioTrack instances that don't use the streaming 10409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * model. 10419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return error code or success, see {@link #SUCCESS}, {@link #ERROR_BAD_VALUE}, 10429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #ERROR_INVALID_OPERATION} 10439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 10449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int reloadStaticData() { 10459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mDataLoadMode == MODE_STREAM) { 10469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return ERROR_INVALID_OPERATION; 10479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return native_reload_static(); 10499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10517070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent //-------------------------------------------------------------------------- 10527070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent // Audio effects management 10537070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent //-------------------- 10547070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent 10557070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent /** 10561a5149e5d7f2dddc8b324f7695e69fd89af73c52Eric Laurent * Attaches an auxiliary effect to the audio track. A typical auxiliary 10571a5149e5d7f2dddc8b324f7695e69fd89af73c52Eric Laurent * effect is a reverberation effect which can be applied on any sound source 10581a5149e5d7f2dddc8b324f7695e69fd89af73c52Eric Laurent * that directs a certain amount of its energy to this effect. This amount 10591a5149e5d7f2dddc8b324f7695e69fd89af73c52Eric Laurent * is defined by setAuxEffectSendLevel(). 10607070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent * {@see #setAuxEffectSendLevel(float)}. 10611a5149e5d7f2dddc8b324f7695e69fd89af73c52Eric Laurent * <p>After creating an auxiliary effect (e.g. 10621a5149e5d7f2dddc8b324f7695e69fd89af73c52Eric Laurent * {@link android.media.audiofx.EnvironmentalReverb}), retrieve its ID with 10631a5149e5d7f2dddc8b324f7695e69fd89af73c52Eric Laurent * {@link android.media.audiofx.AudioEffect#getId()} and use it when calling 10647070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent * this method to attach the audio track to the effect. 10651a5149e5d7f2dddc8b324f7695e69fd89af73c52Eric Laurent * <p>To detach the effect from the audio track, call this method with a 10661a5149e5d7f2dddc8b324f7695e69fd89af73c52Eric Laurent * null effect id. 10677070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent * 10687070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent * @param effectId system wide unique id of the effect to attach 10697070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent * @return error code or success, see {@link #SUCCESS}, 10707070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent * {@link #ERROR_INVALID_OPERATION}, {@link #ERROR_BAD_VALUE} 10717070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent */ 10727070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent public int attachAuxEffect(int effectId) { 10737070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent if (mState != STATE_INITIALIZED) { 10747070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent return ERROR_INVALID_OPERATION; 10757070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent } 10767070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent return native_attachAuxEffect(effectId); 10777070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent } 10787070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent 10797070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent /** 10807070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent * Sets the send level of the audio track to the attached auxiliary effect 108188bde0ce3799c47530ea42ae3665bfa12ae38d11Narayan Kamath * {@link #attachAuxEffect(int)}. The level value range is 0 to 1.0. 10827070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent * <p>By default the send level is 0, so even if an effect is attached to the player 10837070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent * this method must be called for the effect to be applied. 10847070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent * <p>Note that the passed level value is a raw scalar. UI controls should be scaled 10857070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent * logarithmically: the gain applied by audio framework ranges from -72dB to 0dB, 10867070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent * so an appropriate conversion from linear UI input x to level is: 10875c17a820f9e46e0756c11795b3e6f89105f2f539Glenn Kasten * x == 0 -> level = 0 10885c17a820f9e46e0756c11795b3e6f89105f2f539Glenn Kasten * 0 < x <= R -> level = 10^(72*(x-R)/20/R) 10897070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent * 10907070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent * @param level send level scalar 10917070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent * @return error code or success, see {@link #SUCCESS}, 10927070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent * {@link #ERROR_INVALID_OPERATION} 10937070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent */ 10947070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent public int setAuxEffectSendLevel(float level) { 10957070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent if (mState != STATE_INITIALIZED) { 10967070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent return ERROR_INVALID_OPERATION; 10977070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent } 10987070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent // clamp the level 10997070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent if (level < getMinVolume()) { 11007070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent level = getMinVolume(); 11017070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent } 11027070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent if (level > getMaxVolume()) { 11037070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent level = getMaxVolume(); 11047070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent } 11057070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent native_setAuxEffectSendLevel(level); 11067070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent return SUCCESS; 11077070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent } 11089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //--------------------------------------------------------- 11109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Interface definitions 11119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //-------------------- 11129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11134df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project * Interface definition for a callback to be invoked when the playback head position of 11144df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project * an AudioTrack has reached a notification marker or has increased by a certain period. 11159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 11164df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project public interface OnPlaybackPositionUpdateListener { 11179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Called on the listener to notify it that the previously set marker has been reached 11199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * by the playback head. 11209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 11219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project void onMarkerReached(AudioTrack track); 1122fb2ab9efc3805c81521afb9ff91a58ff5097a36eGlenn Kasten 11239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Called on the listener to periodically notify it that the playback head has reached 11259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * a multiple of the notification period. 11269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 11279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project void onPeriodicNotification(AudioTrack track); 11289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //--------------------------------------------------------- 11329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Inner classes 11339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //-------------------- 11349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11354df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project * Helper class to handle the forwarding of native events to the appropriate listener 11364df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project * (potentially) handled in a different thread 11375c17a820f9e46e0756c11795b3e6f89105f2f539Glenn Kasten */ 11384df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project private class NativeEventHandlerDelegate { 11394df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project private final AudioTrack mAudioTrack; 11404df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project private final Handler mHandler; 1141fb2ab9efc3805c81521afb9ff91a58ff5097a36eGlenn Kasten 11424df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project NativeEventHandlerDelegate(AudioTrack track, Handler handler) { 11434df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project mAudioTrack = track; 11444df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project // find the looper for our new event handler 11454df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project Looper looper; 11464df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project if (handler != null) { 11474df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project looper = handler.getLooper(); 11484df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project } else { 1149105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project // no given handler, use the looper the AudioTrack was created in 1150105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project looper = mInitializationLooper; 11519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1152fb2ab9efc3805c81521afb9ff91a58ff5097a36eGlenn Kasten 11534df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project // construct the event handler with this looper 11544df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project if (looper != null) { 11554df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project // implement the event handler delegate 11564df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project mHandler = new Handler(looper) { 11574df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project @Override 11584df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project public void handleMessage(Message msg) { 11594df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project if (mAudioTrack == null) { 11604df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project return; 11614df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project } 11624df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project OnPlaybackPositionUpdateListener listener = null; 11634df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project synchronized (mPositionListenerLock) { 11644df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project listener = mAudioTrack.mPositionListener; 11654df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project } 11664df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project switch(msg.what) { 11674df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project case NATIVE_EVENT_MARKER: 11684df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project if (listener != null) { 11694df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project listener.onMarkerReached(mAudioTrack); 11704df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project } 11714df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project break; 11724df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project case NATIVE_EVENT_NEW_POS: 11734df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project if (listener != null) { 11744df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project listener.onPeriodicNotification(mAudioTrack); 11754df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project } 11764df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project break; 11774df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project default: 11784df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project Log.e(TAG, "[ android.media.AudioTrack.NativeEventHandler ] " + 11794df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project "Unknown event type: " + msg.what); 11804df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project break; 11814df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project } 11824df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project } 11834df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project }; 11844df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project } else { 11854df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project mHandler = null; 1186fb2ab9efc3805c81521afb9ff91a58ff5097a36eGlenn Kasten } 11874df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project } 1188fb2ab9efc3805c81521afb9ff91a58ff5097a36eGlenn Kasten 11894df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project Handler getHandler() { 11904df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project return mHandler; 11919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //--------------------------------------------------------- 11969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Java methods called from the native side 11979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //-------------------- 11989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @SuppressWarnings("unused") 11999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static void postEventFromNative(Object audiotrack_ref, 12009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int what, int arg1, int arg2, Object obj) { 12019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //logd("Event posted from the native side: event="+ what + " args="+ arg1+" "+arg2); 12029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project AudioTrack track = (AudioTrack)((WeakReference)audiotrack_ref).get(); 12039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (track == null) { 12049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return; 12059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12074df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project if (track.mEventHandlerDelegate != null) { 1208fb2ab9efc3805c81521afb9ff91a58ff5097a36eGlenn Kasten Message m = 12094df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project track.mEventHandlerDelegate.getHandler().obtainMessage(what, arg1, arg2, obj); 12104df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project track.mEventHandlerDelegate.getHandler().sendMessage(m); 12119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //--------------------------------------------------------- 12179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Native methods called from the Java side 12189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //-------------------- 12199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private native final int native_setup(Object audiotrack_this, 12219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int streamType, int sampleRate, int nbChannels, int audioFormat, 1222619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent int buffSizeInBytes, int mode, int[] sessionId); 12239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private native final void native_finalize(); 12259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private native final void native_release(); 12279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private native final void native_start(); 12299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private native final void native_stop(); 12319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private native final void native_pause(); 12339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private native final void native_flush(); 12359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private native final int native_write_byte(byte[] audioData, 12379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int offsetInBytes, int sizeInBytes, int format); 12389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private native final int native_write_short(short[] audioData, 12409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int offsetInShorts, int sizeInShorts, int format); 12419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private native final int native_reload_static(); 12439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private native final int native_get_native_frame_count(); 12459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private native final void native_setVolume(float leftVolume, float rightVolume); 12479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 124888e209dcf8c2ebddda5c272f46d1bd5478bc639cEric Laurent private native final int native_set_playback_rate(int sampleRateInHz); 124988e209dcf8c2ebddda5c272f46d1bd5478bc639cEric Laurent private native final int native_get_playback_rate(); 12509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private native final int native_set_marker_pos(int marker); 12529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private native final int native_get_marker_pos(); 12539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private native final int native_set_pos_update_period(int updatePeriod); 12559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private native final int native_get_pos_update_period(); 12569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private native final int native_set_position(int position); 12589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private native final int native_get_position(); 12599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private native final int native_set_loop(int start, int end, int loopCount); 12619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project static private native final int native_get_output_sample_rate(int streamType); 12639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project static private native final int native_get_min_buff_size( 12649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int sampleRateInHz, int channelConfig, int audioFormat); 12659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1266619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent private native final int native_get_session_id(); 12679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12687070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent private native final int native_attachAuxEffect(int effectId); 12697070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent private native final void native_setAuxEffectSendLevel(float level); 12707070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent 12719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //--------------------------------------------------------- 12729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Utility methods 12739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //------------------ 12749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static void logd(String msg) { 12769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.d(TAG, "[ android.media.AudioTrack ] " + msg); 12779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static void loge(String msg) { 12809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "[ android.media.AudioTrack ] " + msg); 12819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project} 1284