AudioTrack.java revision 679f1e26d03ebb5574ed389187f2ebc619832d52
19066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/* 29066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Copyright (C) 2008 The Android Open Source Project 39066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 49066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Licensed under the Apache License, Version 2.0 (the "License"); 59066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * you may not use this file except in compliance with the License. 69066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * You may obtain a copy of the License at 79066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 89066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * http://www.apache.org/licenses/LICENSE-2.0 99066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Unless required by applicable law or agreed to in writing, software 119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * distributed under the License is distributed on an "AS IS" BASIS, 129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * See the License for the specific language governing permissions and 149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * limitations under the License. 159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpackage android.media; 189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 197ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Triviimport java.lang.annotation.Retention; 207ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Triviimport java.lang.annotation.RetentionPolicy; 219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport java.lang.ref.WeakReference; 22cfe964a09ca05778e5dd84f2fd24119b89401696Rachadimport java.lang.Math; 237ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Triviimport java.nio.ByteBuffer; 24cfe964a09ca05778e5dd84f2fd24119b89401696Rachadimport java.nio.ByteOrder; 257ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Triviimport java.nio.NioUtils; 26d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLeanimport java.util.Collection; 2735ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi 287ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Triviimport android.annotation.IntDef; 2935ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Triviimport android.annotation.NonNull; 301af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlockimport android.app.ActivityThread; 311af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlockimport android.app.AppOpsManager; 321af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlockimport android.content.Context; 339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.Handler; 341af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlockimport android.os.IBinder; 359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.Looper; 369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.Message; 371af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlockimport android.os.Process; 381af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlockimport android.os.RemoteException; 391af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlockimport android.os.ServiceManager; 40d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLeanimport android.util.ArrayMap; 419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.util.Log; 429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 431af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlockimport com.android.internal.app.IAppOpsService; 441af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlock 459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/** 469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The AudioTrack class manages and plays a single audio resource for Java applications. 47e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * It allows streaming of PCM audio buffers to the audio sink for playback. This is 489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * achieved by "pushing" the data to the AudioTrack object using one of the 497d60bcd2d950e3571c00ce9f1c492c6bd58334c9Glenn Kasten * {@link #write(byte[], int, int)}, {@link #write(short[], int, int)}, 507d60bcd2d950e3571c00ce9f1c492c6bd58334c9Glenn Kasten * and {@link #write(float[], int, int, int)} methods. 5188bde0ce3799c47530ea42ae3665bfa12ae38d11Narayan Kamath * 52ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * <p>An AudioTrack instance can operate under two modes: static or streaming.<br> 53ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * In Streaming mode, the application writes a continuous stream of data to the AudioTrack, using 5488bde0ce3799c47530ea42ae3665bfa12ae38d11Narayan Kamath * one of the {@code write()} methods. These are blocking and return when the data has been 5588bde0ce3799c47530ea42ae3665bfa12ae38d11Narayan Kamath * transferred from the Java layer to the native layer and queued for playback. The streaming 5688bde0ce3799c47530ea42ae3665bfa12ae38d11Narayan Kamath * mode is most useful when playing blocks of audio data that for instance are: 5788bde0ce3799c47530ea42ae3665bfa12ae38d11Narayan Kamath * 589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <ul> 599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>too big to fit in memory because of the duration of the sound to play,</li> 609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>too big to fit in memory because of the characteristics of the audio data 619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * (high sampling rate, bits per sample ...)</li> 62ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * <li>received or generated while previously queued audio is playing.</li> 639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * </ul> 6488bde0ce3799c47530ea42ae3665bfa12ae38d11Narayan Kamath * 655c17a820f9e46e0756c11795b3e6f89105f2f539Glenn Kasten * The static mode should be chosen when dealing with short sounds that fit in memory and 6688bde0ce3799c47530ea42ae3665bfa12ae38d11Narayan Kamath * that need to be played with the smallest latency possible. The static mode will 6788bde0ce3799c47530ea42ae3665bfa12ae38d11Narayan Kamath * therefore be preferred for UI and game sounds that are played often, and with the 6888bde0ce3799c47530ea42ae3665bfa12ae38d11Narayan Kamath * smallest overhead possible. 6988bde0ce3799c47530ea42ae3665bfa12ae38d11Narayan Kamath * 709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>Upon creation, an AudioTrack object initializes its associated audio buffer. 719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The size of this buffer, specified during the construction, determines how long an AudioTrack 729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * can play before running out of data.<br> 739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * For an AudioTrack using the static mode, this size is the maximum size of the sound that can 749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * be played from it.<br> 75e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * For the streaming mode, data will be written to the audio sink in chunks of 765c17a820f9e46e0756c11795b3e6f89105f2f539Glenn Kasten * sizes less than or equal to the total buffer size. 7755a3218f242a611afb3569d88970c0c5dbf8ce54Glenn Kasten * 7855a3218f242a611afb3569d88970c0c5dbf8ce54Glenn Kasten * AudioTrack is not final and thus permits subclasses, but such use is not recommended. 799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 80ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLeanpublic class AudioTrack implements AudioRouting 819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project{ 829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //--------------------------------------------------------- 839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Constants 849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //-------------------- 8578cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten /** Minimum value for a linear gain or auxiliary effect level. 8678cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * This value must be exactly equal to 0.0f; do not change it. 8778cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten */ 8878cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten private static final float GAIN_MIN = 0.0f; 8978cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten /** Maximum value for a linear gain or auxiliary effect level. 9078cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * This value must be greater than or equal to 1.0f. 9178cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten */ 9278cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten private static final float GAIN_MAX = 1.0f; 939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 94ad67c9546494a7c4d9336b57889a7c19a7dbb945Glenn Kasten /** Minimum value for sample rate */ 95ad67c9546494a7c4d9336b57889a7c19a7dbb945Glenn Kasten private static final int SAMPLE_RATE_HZ_MIN = 4000; 96ad67c9546494a7c4d9336b57889a7c19a7dbb945Glenn Kasten /** Maximum value for sample rate */ 978fd0928cdb6249882acb18274ff7ddaab6fa46d0Andy Hung private static final int SAMPLE_RATE_HZ_MAX = 192000; 98ad67c9546494a7c4d9336b57889a7c19a7dbb945Glenn Kasten 99bd2c3d65d6b62b5a359268246e7ebe96904bd851Glenn Kasten /** Maximum value for AudioTrack channel count 100bd2c3d65d6b62b5a359268246e7ebe96904bd851Glenn Kasten * @hide public for MediaCode only, do not un-hide or change to a numeric literal 101bd2c3d65d6b62b5a359268246e7ebe96904bd851Glenn Kasten */ 10225d3c7c49bafb22723138bfab2e315d2d0a926fbGlenn Kasten public static final int CHANNEL_COUNT_MAX = native_get_FCC_8(); 103ad720aeea741d9058a7b4d326c9ab1b3ebcd7c62Andy Hung 104ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi /** indicates AudioTrack state is stopped */ 1059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int PLAYSTATE_STOPPED = 1; // matches SL_PLAYSTATE_STOPPED 106ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi /** indicates AudioTrack state is paused */ 1079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int PLAYSTATE_PAUSED = 2; // matches SL_PLAYSTATE_PAUSED 108ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi /** indicates AudioTrack state is playing */ 1099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int PLAYSTATE_PLAYING = 3; // matches SL_PLAYSTATE_PLAYING 1109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1115c17a820f9e46e0756c11795b3e6f89105f2f539Glenn Kasten // keep these values in sync with android_media_AudioTrack.cpp 1129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Creation mode where audio data is transferred from Java to the native layer 1149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * only once before the audio starts playing. 1159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int MODE_STATIC = 0; 1179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Creation mode where audio data is streamed from Java to the native layer 1199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * as the audio is playing. 1209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int MODE_STREAM = 1; 1229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12335ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi /** @hide */ 12435ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi @IntDef({ 12535ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi MODE_STATIC, 12635ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi MODE_STREAM 12735ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi }) 12835ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi @Retention(RetentionPolicy.SOURCE) 12935ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi public @interface TransferMode {} 13035ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi 1319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 132ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * State of an AudioTrack that was not successfully initialized upon creation. 1339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int STATE_UNINITIALIZED = 0; 1359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * State of an AudioTrack that is ready to be used. 1379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int STATE_INITIALIZED = 1; 1399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * State of a successfully initialized AudioTrack that uses static data, 1419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * but that hasn't received that data yet. 1429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int STATE_NO_STATIC_DATA = 2; 1449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Denotes a successful operation. 1479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 148bc11a696f6856624de532a6830d5db9dbbe2384cEric Laurent public static final int SUCCESS = AudioSystem.SUCCESS; 1499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Denotes a generic operation failure. 1519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 152bc11a696f6856624de532a6830d5db9dbbe2384cEric Laurent public static final int ERROR = AudioSystem.ERROR; 1539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Denotes a failure due to the use of an invalid value. 1559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 156bc11a696f6856624de532a6830d5db9dbbe2384cEric Laurent public static final int ERROR_BAD_VALUE = AudioSystem.BAD_VALUE; 1579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Denotes a failure due to the improper use of a method. 1599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 160bc11a696f6856624de532a6830d5db9dbbe2384cEric Laurent public static final int ERROR_INVALID_OPERATION = AudioSystem.INVALID_OPERATION; 1614e1ccd370fc268f3207c5baee08ac8c943c3fdf9Eric Laurent /** 1624e1ccd370fc268f3207c5baee08ac8c943c3fdf9Eric Laurent * An error code indicating that the object reporting it is no longer valid and needs to 1634e1ccd370fc268f3207c5baee08ac8c943c3fdf9Eric Laurent * be recreated. 1644e1ccd370fc268f3207c5baee08ac8c943c3fdf9Eric Laurent * @hide 1654e1ccd370fc268f3207c5baee08ac8c943c3fdf9Eric Laurent */ 1664e1ccd370fc268f3207c5baee08ac8c943c3fdf9Eric Laurent public static final int ERROR_DEAD_OBJECT = AudioSystem.DEAD_OBJECT; 1674e1ccd370fc268f3207c5baee08ac8c943c3fdf9Eric Laurent /** 1684e1ccd370fc268f3207c5baee08ac8c943c3fdf9Eric Laurent * {@link #getTimestampWithStatus(AudioTimestamp)} is called in STOPPED or FLUSHED state, 1694e1ccd370fc268f3207c5baee08ac8c943c3fdf9Eric Laurent * or immediately after start/ACTIVE. 1704e1ccd370fc268f3207c5baee08ac8c943c3fdf9Eric Laurent * @hide 1714e1ccd370fc268f3207c5baee08ac8c943c3fdf9Eric Laurent */ 1724e1ccd370fc268f3207c5baee08ac8c943c3fdf9Eric Laurent public static final int ERROR_WOULD_BLOCK = AudioSystem.WOULD_BLOCK; 1739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 174bc11a696f6856624de532a6830d5db9dbbe2384cEric Laurent // Error codes: 175bc11a696f6856624de532a6830d5db9dbbe2384cEric Laurent // to keep in sync with frameworks/base/core/jni/android_media_AudioTrack.cpp 1769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final int ERROR_NATIVESETUP_AUDIOSYSTEM = -16; 177a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent private static final int ERROR_NATIVESETUP_INVALIDCHANNELMASK = -17; 1789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final int ERROR_NATIVESETUP_INVALIDFORMAT = -18; 1799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final int ERROR_NATIVESETUP_INVALIDSTREAMTYPE = -19; 1809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final int ERROR_NATIVESETUP_NATIVEINITFAILED = -20; 1819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Events: 183e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten // to keep in sync with frameworks/av/include/media/AudioTrack.h 1849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 185ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * Event id denotes when playback head has reached a previously set marker. 1869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final int NATIVE_EVENT_MARKER = 3; 1889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 189ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * Event id denotes when previously set update period has elapsed during playback. 1909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final int NATIVE_EVENT_NEW_POS = 4; 1929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1931f61d01508651b4475397414e1fe06af1ab8fadaGlenn Kasten private final static String TAG = "android.media.AudioTrack"; 1949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1967ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi /** @hide */ 1977ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi @IntDef({ 1987ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi WRITE_BLOCKING, 1997ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi WRITE_NON_BLOCKING 2007ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi }) 2017ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi @Retention(RetentionPolicy.SOURCE) 2027ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi public @interface WriteMode {} 2037ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi 2047ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi /** 2057ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi * The write mode indicating the write operation will block until all data has been written, 206659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * to be used as the actual value of the writeMode parameter in 207659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * {@link #write(byte[], int, int, int)}, {@link #write(short[], int, int, int)}, 208659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * {@link #write(float[], int, int, int)}, {@link #write(ByteBuffer, int, int)}, and 209659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * {@link #write(ByteBuffer, int, int, long)}. 2107ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi */ 2117ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi public final static int WRITE_BLOCKING = 0; 212659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten 2137ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi /** 2147ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi * The write mode indicating the write operation will return immediately after 215659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * queuing as much audio data for playback as possible without blocking, 216659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * to be used as the actual value of the writeMode parameter in 217659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * {@link #write(ByteBuffer, int, int)}, {@link #write(short[], int, int, int)}, 218659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * {@link #write(float[], int, int, int)}, {@link #write(ByteBuffer, int, int)}, and 219659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * {@link #write(ByteBuffer, int, int, long)}. 2207ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi */ 2217ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi public final static int WRITE_NON_BLOCKING = 1; 2227ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi 2239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //-------------------------------------------------------------------------- 2249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Member variables 2259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //-------------------- 2269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 227ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * Indicates the state of the AudioTrack instance. 228340a6d09bdba7d4d99cef52a83a90fb96842c58aGlenn Kasten * One of STATE_UNINITIALIZED, STATE_INITIALIZED, or STATE_NO_STATIC_DATA. 2299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private int mState = STATE_UNINITIALIZED; 2319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 232ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * Indicates the play state of the AudioTrack instance. 233340a6d09bdba7d4d99cef52a83a90fb96842c58aGlenn Kasten * One of PLAYSTATE_STOPPED, PLAYSTATE_PAUSED, or PLAYSTATE_PLAYING. 2349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private int mPlayState = PLAYSTATE_STOPPED; 2369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 237340a6d09bdba7d4d99cef52a83a90fb96842c58aGlenn Kasten * Lock to ensure mPlayState updates reflect the actual state of the object. 2389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private final Object mPlayStateLock = new Object(); 2409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 241e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * Sizes of the native audio buffer. 2424bd513e6ed168811c97dbc83cd5a7c7cc43caffeAndy Hung * These values are set during construction and can be stale. 243e90a0a88f4eabdc27c3ef033f38c91ea23362a1eAndy Hung * To obtain the current native audio buffer frame count use {@link #getBufferSizeInFrames()}. 2449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private int mNativeBufferSizeInBytes = 0; 246e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten private int mNativeBufferSizeInFrames = 0; 2479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 24886fad47e68e344b19fabeab1156c5e6742d8dfadGlenn Kasten * Handler for events coming from the native code. 2499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 250d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean private NativePositionEventHandlerDelegate mEventHandlerDelegate; 2519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 252ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * Looper associated with the thread that creates the AudioTrack instance. 253105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project */ 254b09707a041957f055cee3d290c85763cfef8d986Glenn Kasten private final Looper mInitializationLooper; 255105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project /** 2568d7fa137466c833ed422053204fb4c506b7bb209Glenn Kasten * The audio data source sampling rate in Hz. 2579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 258340a6d09bdba7d4d99cef52a83a90fb96842c58aGlenn Kasten private int mSampleRate; // initialized by all constructors via audioParamCheck() 2599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 260340a6d09bdba7d4d99cef52a83a90fb96842c58aGlenn Kasten * The number of audio output channels (1 is mono, 2 is stereo, etc.). 2619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private int mChannelCount = 1; 2639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 264a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung * The audio channel mask used for calling native AudioTrack 2653026a023b8979b7ddcb3fe97bbc45531c89fda92Eric Laurent */ 2669ea5e5564812bb88e62d0c4fae8f1d40d8a6e7e0Glenn Kasten private int mChannelMask = AudioFormat.CHANNEL_OUT_MONO; 2673026a023b8979b7ddcb3fe97bbc45531c89fda92Eric Laurent 2683026a023b8979b7ddcb3fe97bbc45531c89fda92Eric Laurent /** 2699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The type of the audio stream to play. See 2709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link AudioManager#STREAM_VOICE_CALL}, {@link AudioManager#STREAM_SYSTEM}, 2715c17a820f9e46e0756c11795b3e6f89105f2f539Glenn Kasten * {@link AudioManager#STREAM_RING}, {@link AudioManager#STREAM_MUSIC}, 272b282e08ab641d4fc74d0324b7a0ce30926638dd5Glenn Kasten * {@link AudioManager#STREAM_ALARM}, {@link AudioManager#STREAM_NOTIFICATION}, and 273b282e08ab641d4fc74d0324b7a0ce30926638dd5Glenn Kasten * {@link AudioManager#STREAM_DTMF}. 2749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private int mStreamType = AudioManager.STREAM_MUSIC; 276a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi 277a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi private final AudioAttributes mAttributes; 2789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 279340a6d09bdba7d4d99cef52a83a90fb96842c58aGlenn Kasten * The way audio is consumed by the audio sink, one of MODE_STATIC or MODE_STREAM. 2809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private int mDataLoadMode = MODE_STREAM; 2829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 283a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung * The current channel position mask, as specified on AudioTrack creation. 284a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung * Can be set simultaneously with channel index mask {@link #mChannelIndexMask}. 285a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung * May be set to {@link AudioFormat#CHANNEL_INVALID} if a channel index mask is specified. 2869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 287a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent private int mChannelConfiguration = AudioFormat.CHANNEL_OUT_MONO; 2889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 289340a6d09bdba7d4d99cef52a83a90fb96842c58aGlenn Kasten * The channel index mask if specified, otherwise 0. 290a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung */ 291a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung private int mChannelIndexMask = 0; 292a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung /** 2939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The encoding of the audio samples. 2949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see AudioFormat#ENCODING_PCM_8BIT 2959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see AudioFormat#ENCODING_PCM_16BIT 2967d60bcd2d950e3571c00ce9f1c492c6bd58334c9Glenn Kasten * @see AudioFormat#ENCODING_PCM_FLOAT 2979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 298340a6d09bdba7d4d99cef52a83a90fb96842c58aGlenn Kasten private int mAudioFormat; // initialized by all constructors via audioParamCheck() 299619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent /** 300619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * Audio session ID 301619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent */ 30260bd67f7b1b85ed0ee19f77b056b90350a3d5343Glenn Kasten private int mSessionId = AudioSystem.AUDIO_SESSION_ALLOCATE; 3031af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlock /** 3041af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlock * Reference to the app-ops service. 3051af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlock */ 3061af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlock private final IAppOpsService mAppOps; 307cfe964a09ca05778e5dd84f2fd24119b89401696Rachad /** 308cfe964a09ca05778e5dd84f2fd24119b89401696Rachad * HW_AV_SYNC track AV Sync Header 309cfe964a09ca05778e5dd84f2fd24119b89401696Rachad */ 310cfe964a09ca05778e5dd84f2fd24119b89401696Rachad private ByteBuffer mAvSyncHeader = null; 311cfe964a09ca05778e5dd84f2fd24119b89401696Rachad /** 312cfe964a09ca05778e5dd84f2fd24119b89401696Rachad * HW_AV_SYNC track audio data bytes remaining to write after current AV sync header 313cfe964a09ca05778e5dd84f2fd24119b89401696Rachad */ 314cfe964a09ca05778e5dd84f2fd24119b89401696Rachad private int mAvSyncBytesRemaining = 0; 3159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //-------------------------------- 3179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Used exclusively by native code 3189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //-------------------- 3199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 320ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean * @hide 321ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * Accessed by native methods: provides access to C++ AudioTrack object. 3229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @SuppressWarnings("unused") 324ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean protected long mNativeTrackInJavaObj; 3259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Accessed by native methods: provides access to the JNI data (i.e. resources used by 3279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the native AudioTrack object, but not stored in it). 3289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @SuppressWarnings("unused") 330075e9a19ce645752f8282bc19c91b25978a7dc52Ashok Bhat private long mJniData; 3319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //-------------------------------------------------------------------------- 3349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Constructor, Finalize 3359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //-------------------- 3369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Class constructor. 3389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param streamType the type of the audio stream. See 3399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link AudioManager#STREAM_VOICE_CALL}, {@link AudioManager#STREAM_SYSTEM}, 3405c17a820f9e46e0756c11795b3e6f89105f2f539Glenn Kasten * {@link AudioManager#STREAM_RING}, {@link AudioManager#STREAM_MUSIC}, 3415c17a820f9e46e0756c11795b3e6f89105f2f539Glenn Kasten * {@link AudioManager#STREAM_ALARM}, and {@link AudioManager#STREAM_NOTIFICATION}. 3428d7fa137466c833ed422053204fb4c506b7bb209Glenn Kasten * @param sampleRateInHz the initial source sample rate expressed in Hz. 3439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param channelConfig describes the configuration of the audio channels. 344a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * See {@link AudioFormat#CHANNEL_OUT_MONO} and 345a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * {@link AudioFormat#CHANNEL_OUT_STEREO} 3469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param audioFormat the format in which the audio data is represented. 3477d60bcd2d950e3571c00ce9f1c492c6bd58334c9Glenn Kasten * See {@link AudioFormat#ENCODING_PCM_16BIT}, 3487d60bcd2d950e3571c00ce9f1c492c6bd58334c9Glenn Kasten * {@link AudioFormat#ENCODING_PCM_8BIT}, 3497d60bcd2d950e3571c00ce9f1c492c6bd58334c9Glenn Kasten * and {@link AudioFormat#ENCODING_PCM_FLOAT}. 350e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * @param bufferSizeInBytes the total size (in bytes) of the internal buffer where audio data is 3514bd513e6ed168811c97dbc83cd5a7c7cc43caffeAndy Hung * read from for playback. This should be a multiple of the frame size in bytes. 3524bd513e6ed168811c97dbc83cd5a7c7cc43caffeAndy Hung * <p> If the track's creation mode is {@link #MODE_STATIC}, 353e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * this is the maximum length sample, or audio clip, that can be played by this instance. 3544bd513e6ed168811c97dbc83cd5a7c7cc43caffeAndy Hung * <p> If the track's creation mode is {@link #MODE_STREAM}, 3554bd513e6ed168811c97dbc83cd5a7c7cc43caffeAndy Hung * this should be the desired buffer size 3564bd513e6ed168811c97dbc83cd5a7c7cc43caffeAndy Hung * for the <code>AudioTrack</code> to satisfy the application's 3574bd513e6ed168811c97dbc83cd5a7c7cc43caffeAndy Hung * natural latency requirements. 3584bd513e6ed168811c97dbc83cd5a7c7cc43caffeAndy Hung * If <code>bufferSizeInBytes</code> is less than the 3594bd513e6ed168811c97dbc83cd5a7c7cc43caffeAndy Hung * minimum buffer size for the output sink, it is automatically increased to the minimum 3604bd513e6ed168811c97dbc83cd5a7c7cc43caffeAndy Hung * buffer size. 361e90a0a88f4eabdc27c3ef033f38c91ea23362a1eAndy Hung * The method {@link #getBufferSizeInFrames()} returns the 3624bd513e6ed168811c97dbc83cd5a7c7cc43caffeAndy Hung * actual size in frames of the native buffer created, which 3634bd513e6ed168811c97dbc83cd5a7c7cc43caffeAndy Hung * determines the frequency to write 3644bd513e6ed168811c97dbc83cd5a7c7cc43caffeAndy Hung * to the streaming <code>AudioTrack</code> to avoid underrun. 3659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param mode streaming or static buffer. See {@link #MODE_STATIC} and {@link #MODE_STREAM} 3669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws java.lang.IllegalArgumentException 3679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public AudioTrack(int streamType, int sampleRateInHz, int channelConfig, int audioFormat, 3699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int bufferSizeInBytes, int mode) 3709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throws IllegalArgumentException { 371619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent this(streamType, sampleRateInHz, channelConfig, audioFormat, 37260bd67f7b1b85ed0ee19f77b056b90350a3d5343Glenn Kasten bufferSizeInBytes, mode, AudioSystem.AUDIO_SESSION_ALLOCATE); 373619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent } 374619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent 375619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent /** 376619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * Class constructor with audio session. Use this constructor when the AudioTrack must be 377619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * attached to a particular audio session. The primary use of the audio session ID is to 378619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * associate audio effects to a particular instance of AudioTrack: if an audio session ID 379619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * is provided when creating an AudioEffect, this effect will be applied only to audio tracks 380619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * and media players in the same session and not to the output mix. 381619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * When an AudioTrack is created without specifying a session, it will create its own session 3828d7fa137466c833ed422053204fb4c506b7bb209Glenn Kasten * which can be retrieved by calling the {@link #getAudioSessionId()} method. 3835c17a820f9e46e0756c11795b3e6f89105f2f539Glenn Kasten * If a non-zero session ID is provided, this AudioTrack will share effects attached to this 3845c17a820f9e46e0756c11795b3e6f89105f2f539Glenn Kasten * session 3855c17a820f9e46e0756c11795b3e6f89105f2f539Glenn Kasten * with all other media players or audio tracks in the same session, otherwise a new session 3865c17a820f9e46e0756c11795b3e6f89105f2f539Glenn Kasten * will be created for this track if none is supplied. 387619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * @param streamType the type of the audio stream. See 388619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * {@link AudioManager#STREAM_VOICE_CALL}, {@link AudioManager#STREAM_SYSTEM}, 3895c17a820f9e46e0756c11795b3e6f89105f2f539Glenn Kasten * {@link AudioManager#STREAM_RING}, {@link AudioManager#STREAM_MUSIC}, 3905c17a820f9e46e0756c11795b3e6f89105f2f539Glenn Kasten * {@link AudioManager#STREAM_ALARM}, and {@link AudioManager#STREAM_NOTIFICATION}. 3918d7fa137466c833ed422053204fb4c506b7bb209Glenn Kasten * @param sampleRateInHz the initial source sample rate expressed in Hz. 392619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * @param channelConfig describes the configuration of the audio channels. 393619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * See {@link AudioFormat#CHANNEL_OUT_MONO} and 394619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * {@link AudioFormat#CHANNEL_OUT_STEREO} 395619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * @param audioFormat the format in which the audio data is represented. 396619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * See {@link AudioFormat#ENCODING_PCM_16BIT} and 3977d60bcd2d950e3571c00ce9f1c492c6bd58334c9Glenn Kasten * {@link AudioFormat#ENCODING_PCM_8BIT}, 3987d60bcd2d950e3571c00ce9f1c492c6bd58334c9Glenn Kasten * and {@link AudioFormat#ENCODING_PCM_FLOAT}. 399619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * @param bufferSizeInBytes the total size (in bytes) of the buffer where audio data is read 400619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * from for playback. If using the AudioTrack in streaming mode, you can write data into 401619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * this buffer in smaller chunks than this size. If using the AudioTrack in static mode, 402619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * this is the maximum size of the sound that will be played for this instance. 403619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * See {@link #getMinBufferSize(int, int, int)} to determine the minimum required buffer size 404619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * for the successful creation of an AudioTrack instance in streaming mode. Using values 405619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * smaller than getMinBufferSize() will result in an initialization failure. 406619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * @param mode streaming or static buffer. See {@link #MODE_STATIC} and {@link #MODE_STREAM} 407619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * @param sessionId Id of audio session the AudioTrack must be attached to 408619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * @throws java.lang.IllegalArgumentException 409619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent */ 410619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent public AudioTrack(int streamType, int sampleRateInHz, int channelConfig, int audioFormat, 411619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent int bufferSizeInBytes, int mode, int sessionId) 412619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent throws IllegalArgumentException { 413a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten // mState already == STATE_UNINITIALIZED 414a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi this((new AudioAttributes.Builder()) 415a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi .setLegacyStreamType(streamType) 416a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi .build(), 417a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi (new AudioFormat.Builder()) 418a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi .setChannelMask(channelConfig) 419a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi .setEncoding(audioFormat) 420a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi .setSampleRate(sampleRateInHz) 421a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi .build(), 422a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi bufferSizeInBytes, 423a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi mode, sessionId); 424a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi } 425a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi 426a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi /** 4277f6ee760b0aee76bdb9fe61ac7ed1465c0da3489Jean-Michel Trivi * Class constructor with {@link AudioAttributes} and {@link AudioFormat}. 4287f6ee760b0aee76bdb9fe61ac7ed1465c0da3489Jean-Michel Trivi * @param attributes a non-null {@link AudioAttributes} instance. 4297f6ee760b0aee76bdb9fe61ac7ed1465c0da3489Jean-Michel Trivi * @param format a non-null {@link AudioFormat} instance describing the format of the data 4307f6ee760b0aee76bdb9fe61ac7ed1465c0da3489Jean-Michel Trivi * that will be played through this AudioTrack. See {@link AudioFormat.Builder} for 4317f6ee760b0aee76bdb9fe61ac7ed1465c0da3489Jean-Michel Trivi * configuring the audio format parameters such as encoding, channel mask and sample rate. 4327f6ee760b0aee76bdb9fe61ac7ed1465c0da3489Jean-Michel Trivi * @param bufferSizeInBytes the total size (in bytes) of the buffer where audio data is read 4337f6ee760b0aee76bdb9fe61ac7ed1465c0da3489Jean-Michel Trivi * from for playback. If using the AudioTrack in streaming mode, you can write data into 4347f6ee760b0aee76bdb9fe61ac7ed1465c0da3489Jean-Michel Trivi * this buffer in smaller chunks than this size. If using the AudioTrack in static mode, 4357f6ee760b0aee76bdb9fe61ac7ed1465c0da3489Jean-Michel Trivi * this is the maximum size of the sound that will be played for this instance. 4367f6ee760b0aee76bdb9fe61ac7ed1465c0da3489Jean-Michel Trivi * See {@link #getMinBufferSize(int, int, int)} to determine the minimum required buffer size 4377f6ee760b0aee76bdb9fe61ac7ed1465c0da3489Jean-Michel Trivi * for the successful creation of an AudioTrack instance in streaming mode. Using values 4387f6ee760b0aee76bdb9fe61ac7ed1465c0da3489Jean-Michel Trivi * smaller than getMinBufferSize() will result in an initialization failure. 4397f6ee760b0aee76bdb9fe61ac7ed1465c0da3489Jean-Michel Trivi * @param mode streaming or static buffer. See {@link #MODE_STATIC} and {@link #MODE_STREAM}. 440289cc8e887f786f557faab226a1e01abb9a632a6Jean-Michel Trivi * @param sessionId ID of audio session the AudioTrack must be attached to, or 441289cc8e887f786f557faab226a1e01abb9a632a6Jean-Michel Trivi * {@link AudioManager#AUDIO_SESSION_ID_GENERATE} if the session isn't known at construction 442289cc8e887f786f557faab226a1e01abb9a632a6Jean-Michel Trivi * time. See also {@link AudioManager#generateAudioSessionId()} to obtain a session ID before 443289cc8e887f786f557faab226a1e01abb9a632a6Jean-Michel Trivi * construction. 4447f6ee760b0aee76bdb9fe61ac7ed1465c0da3489Jean-Michel Trivi * @throws IllegalArgumentException 445a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi */ 446a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi public AudioTrack(AudioAttributes attributes, AudioFormat format, int bufferSizeInBytes, 447a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi int mode, int sessionId) 448a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi throws IllegalArgumentException { 449a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi // mState already == STATE_UNINITIALIZED 4505c17a820f9e46e0756c11795b3e6f89105f2f539Glenn Kasten 4517f6ee760b0aee76bdb9fe61ac7ed1465c0da3489Jean-Michel Trivi if (attributes == null) { 4527f6ee760b0aee76bdb9fe61ac7ed1465c0da3489Jean-Michel Trivi throw new IllegalArgumentException("Illegal null AudioAttributes"); 4537f6ee760b0aee76bdb9fe61ac7ed1465c0da3489Jean-Michel Trivi } 4547f6ee760b0aee76bdb9fe61ac7ed1465c0da3489Jean-Michel Trivi if (format == null) { 4557f6ee760b0aee76bdb9fe61ac7ed1465c0da3489Jean-Michel Trivi throw new IllegalArgumentException("Illegal null AudioFormat"); 4567f6ee760b0aee76bdb9fe61ac7ed1465c0da3489Jean-Michel Trivi } 4577f6ee760b0aee76bdb9fe61ac7ed1465c0da3489Jean-Michel Trivi 4585c17a820f9e46e0756c11795b3e6f89105f2f539Glenn Kasten // remember which looper is associated with the AudioTrack instantiation 459b09707a041957f055cee3d290c85763cfef8d986Glenn Kasten Looper looper; 460b09707a041957f055cee3d290c85763cfef8d986Glenn Kasten if ((looper = Looper.myLooper()) == null) { 461b09707a041957f055cee3d290c85763cfef8d986Glenn Kasten looper = Looper.getMainLooper(); 462105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project } 4639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 464a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi int rate = 0; 465a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi if ((format.getPropertySetMask() & AudioFormat.AUDIO_FORMAT_HAS_PROPERTY_SAMPLE_RATE) != 0) 466a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi { 467a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi rate = format.getSampleRate(); 468a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi } else { 469a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi rate = AudioSystem.getPrimaryOutputSamplingRate(); 470a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi if (rate <= 0) { 471a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi rate = 44100; 472a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi } 473a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi } 474a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung int channelIndexMask = 0; 475a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung if ((format.getPropertySetMask() 476a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung & AudioFormat.AUDIO_FORMAT_HAS_PROPERTY_CHANNEL_INDEX_MASK) != 0) { 477a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung channelIndexMask = format.getChannelIndexMask(); 478a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung } 479a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung int channelMask = 0; 480a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung if ((format.getPropertySetMask() 481a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung & AudioFormat.AUDIO_FORMAT_HAS_PROPERTY_CHANNEL_MASK) != 0) { 482a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi channelMask = format.getChannelMask(); 483a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung } else if (channelIndexMask == 0) { // if no masks at all, use stereo 484a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung channelMask = AudioFormat.CHANNEL_OUT_FRONT_LEFT 485a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung | AudioFormat.CHANNEL_OUT_FRONT_RIGHT; 486a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi } 487a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi int encoding = AudioFormat.ENCODING_DEFAULT; 488a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi if ((format.getPropertySetMask() & AudioFormat.AUDIO_FORMAT_HAS_PROPERTY_ENCODING) != 0) { 489a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi encoding = format.getEncoding(); 490a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi } 491a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung audioParamCheck(rate, channelMask, channelIndexMask, encoding, mode); 492a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi mStreamType = AudioSystem.STREAM_DEFAULT; 4939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project audioBuffSizeCheck(bufferSizeInBytes); 4959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 496a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi mInitializationLooper = looper; 4971af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlock IBinder b = ServiceManager.getService(Context.APP_OPS_SERVICE); 4981af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlock mAppOps = IAppOpsService.Stub.asInterface(b); 4991af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlock 500340a6d09bdba7d4d99cef52a83a90fb96842c58aGlenn Kasten mAttributes = new AudioAttributes.Builder(attributes).build(); 501a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi 502619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent if (sessionId < 0) { 503f4e58051e22ad4e21c7cd436c37cc5665c194d1cGlenn Kasten throw new IllegalArgumentException("Invalid audio session ID: "+sessionId); 504619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent } 505619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent 506619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent int[] session = new int[1]; 507619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent session[0] = sessionId; 5089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // native initialization 509a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi int initResult = native_setup(new WeakReference<AudioTrack>(this), mAttributes, 5109ea5e5564812bb88e62d0c4fae8f1d40d8a6e7e0Glenn Kasten mSampleRate, mChannelMask, mChannelIndexMask, mAudioFormat, 511619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent mNativeBufferSizeInBytes, mDataLoadMode, session); 5129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (initResult != SUCCESS) { 5139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project loge("Error code "+initResult+" when initializing AudioTrack."); 5149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return; // with mState == STATE_UNINITIALIZED 5159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 517619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent mSessionId = session[0]; 518619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent 5199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mDataLoadMode == MODE_STATIC) { 5209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mState = STATE_NO_STATIC_DATA; 5219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 5229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mState = STATE_INITIALIZED; 5239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 52635ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi /** 527ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean * A constructor which explicitly connects a Native (C++) AudioTrack. For use by 528ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean * the AudioTrackRoutingProxy subclass. 529ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean * @param nativeTrackInJavaObj a C/C++ pointer to a native AudioTrack 530ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean * (associated with an OpenSL ES player). 531ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean */ 532ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean /*package*/ AudioTrack(long nativeTrackInJavaObj) { 533ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean mNativeTrackInJavaObj = nativeTrackInJavaObj; 534ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean 535ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean // "final"s 536ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean mAttributes = null; 537ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean mAppOps = null; 538ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean 539ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean // remember which looper is associated with the AudioTrack instantiation 540ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean Looper looper; 541ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean if ((looper = Looper.myLooper()) == null) { 542ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean looper = Looper.getMainLooper(); 543ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean } 544ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean mInitializationLooper = looper; 545ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean 546ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean // other initialization... 547ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean 548ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean mState = STATE_INITIALIZED; 549ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean } 550ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean 551ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean /** 55235ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * Builder class for {@link AudioTrack} objects. 55335ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * Use this class to configure and create an <code>AudioTrack</code> instance. By setting audio 55435ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * attributes and audio format parameters, you indicate which of those vary from the default 55535ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * behavior on the device. 55635ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * <p> Here is an example where <code>Builder</code> is used to specify all {@link AudioFormat} 55735ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * parameters, to be used by a new <code>AudioTrack</code> instance: 55835ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * 55935ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * <pre class="prettyprint"> 56035ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * AudioTrack player = new AudioTrack.Builder() 56135ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * .setAudioAttributes(new AudioAttributes.Builder() 56235ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * .setUsage(AudioAttributes.USAGE_ALARM) 56335ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * .setContentType(CONTENT_TYPE_MUSIC) 56435ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * .build()) 56535ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * .setAudioFormat(new AudioFormat.Builder() 56635ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * .setEncoding(AudioFormat.ENCODING_PCM_16BIT) 56735ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * .setSampleRate(441000) 56835ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * .setChannelMask(AudioFormat.CHANNEL_OUT_STEREO) 56935ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * .build()) 57035ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * .setBufferSize(minBuffSize) 57135ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * .build(); 57235ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * </pre> 57335ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * <p> 57435ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * If the audio attributes are not set with {@link #setAudioAttributes(AudioAttributes)}, 57535ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * attributes comprising {@link AudioAttributes#USAGE_MEDIA} will be used. 57635ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * <br>If the audio format is not specified or is incomplete, its sample rate will be the 57735ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * default output sample rate of the device (see 57835ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * {@link AudioManager#PROPERTY_OUTPUT_SAMPLE_RATE}), its channel configuration will be 57935ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * {@link AudioFormat#CHANNEL_OUT_STEREO} and the encoding will be 58035ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * {@link AudioFormat#ENCODING_PCM_16BIT}. 5814bd513e6ed168811c97dbc83cd5a7c7cc43caffeAndy Hung * <br>If the buffer size is not specified with {@link #setBufferSizeInBytes(int)}, 5824bd513e6ed168811c97dbc83cd5a7c7cc43caffeAndy Hung * and the mode is {@link AudioTrack#MODE_STREAM}, the minimum buffer size is used. 58335ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * <br>If the transfer mode is not specified with {@link #setTransferMode(int)}, 5844bd513e6ed168811c97dbc83cd5a7c7cc43caffeAndy Hung * <code>MODE_STREAM</code> will be used. 58535ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * <br>If the session ID is not specified with {@link #setSessionId(int)}, a new one will 58635ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * be generated. 58735ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi */ 58835ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi public static class Builder { 58935ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi private AudioAttributes mAttributes; 59035ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi private AudioFormat mFormat; 59135ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi private int mBufferSizeInBytes; 59235ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi private int mSessionId = AudioManager.AUDIO_SESSION_ID_GENERATE; 59335ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi private int mMode = MODE_STREAM; 59435ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi 59535ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi /** 59635ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * Constructs a new Builder with the default values as described above. 59735ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi */ 59835ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi public Builder() { 59935ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi } 60035ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi 60135ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi /** 60235ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * Sets the {@link AudioAttributes}. 60335ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * @param attributes a non-null {@link AudioAttributes} instance that describes the audio 60435ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * data to be played. 60535ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * @return the same Builder instance. 60635ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * @throws IllegalArgumentException 60735ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi */ 60835ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi public @NonNull Builder setAudioAttributes(@NonNull AudioAttributes attributes) 60935ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi throws IllegalArgumentException { 61035ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi if (attributes == null) { 61135ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi throw new IllegalArgumentException("Illegal null AudioAttributes argument"); 61235ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi } 61335ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi // keep reference, we only copy the data when building 61435ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi mAttributes = attributes; 61535ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi return this; 61635ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi } 61735ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi 61835ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi /** 61935ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * Sets the format of the audio data to be played by the {@link AudioTrack}. 62035ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * See {@link AudioFormat.Builder} for configuring the audio format parameters such 62135ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * as encoding, channel mask and sample rate. 62235ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * @param format a non-null {@link AudioFormat} instance. 62335ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * @return the same Builder instance. 62435ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * @throws IllegalArgumentException 62535ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi */ 62635ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi public @NonNull Builder setAudioFormat(@NonNull AudioFormat format) 62735ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi throws IllegalArgumentException { 62835ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi if (format == null) { 62935ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi throw new IllegalArgumentException("Illegal null AudioFormat argument"); 63035ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi } 63135ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi // keep reference, we only copy the data when building 63235ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi mFormat = format; 63335ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi return this; 63435ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi } 63535ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi 63635ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi /** 63735ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * Sets the total size (in bytes) of the buffer where audio data is read from for playback. 63835ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * If using the {@link AudioTrack} in streaming mode 63935ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * (see {@link AudioTrack#MODE_STREAM}, you can write data into this buffer in smaller 64035ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * chunks than this size. See {@link #getMinBufferSize(int, int, int)} to determine 64135ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * the minimum required buffer size for the successful creation of an AudioTrack instance 64235ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * in streaming mode. Using values smaller than <code>getMinBufferSize()</code> will result 64335ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * in an exception when trying to build the <code>AudioTrack</code>. 64435ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * <br>If using the <code>AudioTrack</code> in static mode (see 64535ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * {@link AudioTrack#MODE_STATIC}), this is the maximum size of the sound that will be 64635ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * played by this instance. 64735ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * @param bufferSizeInBytes 64835ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * @return the same Builder instance. 64935ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * @throws IllegalArgumentException 65035ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi */ 65135ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi public @NonNull Builder setBufferSizeInBytes(int bufferSizeInBytes) 65235ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi throws IllegalArgumentException { 65335ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi if (bufferSizeInBytes <= 0) { 65435ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi throw new IllegalArgumentException("Invalid buffer size " + bufferSizeInBytes); 65535ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi } 65635ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi mBufferSizeInBytes = bufferSizeInBytes; 65735ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi return this; 65835ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi } 65935ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi 66035ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi /** 66135ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * Sets the mode under which buffers of audio data are transferred from the 66235ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * {@link AudioTrack} to the framework. 66335ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * @param mode one of {@link AudioTrack#MODE_STREAM}, {@link AudioTrack#MODE_STATIC}. 66435ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * @return the same Builder instance. 66535ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * @throws IllegalArgumentException 66635ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi */ 66735ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi public @NonNull Builder setTransferMode(@TransferMode int mode) 66835ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi throws IllegalArgumentException { 66935ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi switch(mode) { 67035ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi case MODE_STREAM: 67135ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi case MODE_STATIC: 67235ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi mMode = mode; 67335ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi break; 67435ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi default: 67535ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi throw new IllegalArgumentException("Invalid transfer mode " + mode); 67635ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi } 67735ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi return this; 67835ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi } 67935ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi 68035ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi /** 68135ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * Sets the session ID the {@link AudioTrack} will be attached to. 68235ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * @param sessionId a strictly positive ID number retrieved from another 68335ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * <code>AudioTrack</code> via {@link AudioTrack#getAudioSessionId()} or allocated by 68435ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * {@link AudioManager} via {@link AudioManager#generateAudioSessionId()}, or 68535ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * {@link AudioManager#AUDIO_SESSION_ID_GENERATE}. 68635ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * @return the same Builder instance. 68735ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * @throws IllegalArgumentException 68835ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi */ 68935ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi public @NonNull Builder setSessionId(int sessionId) 69035ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi throws IllegalArgumentException { 69135ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi if ((sessionId != AudioManager.AUDIO_SESSION_ID_GENERATE) && (sessionId < 1)) { 69235ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi throw new IllegalArgumentException("Invalid audio session ID " + sessionId); 69335ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi } 69435ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi mSessionId = sessionId; 69535ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi return this; 69635ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi } 69735ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi 69835ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi /** 69935ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * Builds an {@link AudioTrack} instance initialized with all the parameters set 70035ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * on this <code>Builder</code>. 7012d2d89363f0b794cbb63f389584fa4c5557ff51aAndy Hung * @return a new successfully initialized {@link AudioTrack} instance. 70235ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi * @throws UnsupportedOperationException if the parameters set on the <code>Builder</code> 7032d2d89363f0b794cbb63f389584fa4c5557ff51aAndy Hung * were incompatible, or if they are not supported by the device, 7042d2d89363f0b794cbb63f389584fa4c5557ff51aAndy Hung * or if the device was not available. 70535ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi */ 70635ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi public @NonNull AudioTrack build() throws UnsupportedOperationException { 70735ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi if (mAttributes == null) { 70835ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi mAttributes = new AudioAttributes.Builder() 70935ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi .setUsage(AudioAttributes.USAGE_MEDIA) 71035ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi .build(); 71135ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi } 71235ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi if (mFormat == null) { 71335ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi mFormat = new AudioFormat.Builder() 71435ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi .setChannelMask(AudioFormat.CHANNEL_OUT_STEREO) 71535ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi .setSampleRate(AudioSystem.getPrimaryOutputSamplingRate()) 71635ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi .setEncoding(AudioFormat.ENCODING_DEFAULT) 71735ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi .build(); 71835ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi } 71935ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi try { 7204bd513e6ed168811c97dbc83cd5a7c7cc43caffeAndy Hung // If the buffer size is not specified in streaming mode, 7214bd513e6ed168811c97dbc83cd5a7c7cc43caffeAndy Hung // use a single frame for the buffer size and let the 7224bd513e6ed168811c97dbc83cd5a7c7cc43caffeAndy Hung // native code figure out the minimum buffer size. 7234bd513e6ed168811c97dbc83cd5a7c7cc43caffeAndy Hung if (mMode == MODE_STREAM && mBufferSizeInBytes == 0) { 7244bd513e6ed168811c97dbc83cd5a7c7cc43caffeAndy Hung mBufferSizeInBytes = mFormat.getChannelCount() 7254bd513e6ed168811c97dbc83cd5a7c7cc43caffeAndy Hung * mFormat.getBytesPerSample(mFormat.getEncoding()); 7264bd513e6ed168811c97dbc83cd5a7c7cc43caffeAndy Hung } 7272d2d89363f0b794cbb63f389584fa4c5557ff51aAndy Hung final AudioTrack track = new AudioTrack( 7282d2d89363f0b794cbb63f389584fa4c5557ff51aAndy Hung mAttributes, mFormat, mBufferSizeInBytes, mMode, mSessionId); 7292d2d89363f0b794cbb63f389584fa4c5557ff51aAndy Hung if (track.getState() == STATE_UNINITIALIZED) { 7302d2d89363f0b794cbb63f389584fa4c5557ff51aAndy Hung // release is not necessary 7312d2d89363f0b794cbb63f389584fa4c5557ff51aAndy Hung throw new UnsupportedOperationException("Cannot create AudioTrack"); 7322d2d89363f0b794cbb63f389584fa4c5557ff51aAndy Hung } 7332d2d89363f0b794cbb63f389584fa4c5557ff51aAndy Hung return track; 73435ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi } catch (IllegalArgumentException e) { 73535ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi throw new UnsupportedOperationException(e.getMessage()); 73635ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi } 73735ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi } 73835ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi } 73935ba5ab4503f4818f0dd131ad1d2bf91f7397cadJean-Michel Trivi 740340a6d09bdba7d4d99cef52a83a90fb96842c58aGlenn Kasten // mask of all the positional channels supported, however the allowed combinations 741340a6d09bdba7d4d99cef52a83a90fb96842c58aGlenn Kasten // are further restricted by the matching left/right rule and CHANNEL_COUNT_MAX 7421b8f499a14a4340d3422d95c7f6fdc8c0c72b3a4Jean-Michel Trivi private static final int SUPPORTED_OUT_CHANNELS = 7431b8f499a14a4340d3422d95c7f6fdc8c0c72b3a4Jean-Michel Trivi AudioFormat.CHANNEL_OUT_FRONT_LEFT | 7441b8f499a14a4340d3422d95c7f6fdc8c0c72b3a4Jean-Michel Trivi AudioFormat.CHANNEL_OUT_FRONT_RIGHT | 7451b8f499a14a4340d3422d95c7f6fdc8c0c72b3a4Jean-Michel Trivi AudioFormat.CHANNEL_OUT_FRONT_CENTER | 7461b8f499a14a4340d3422d95c7f6fdc8c0c72b3a4Jean-Michel Trivi AudioFormat.CHANNEL_OUT_LOW_FREQUENCY | 7471b8f499a14a4340d3422d95c7f6fdc8c0c72b3a4Jean-Michel Trivi AudioFormat.CHANNEL_OUT_BACK_LEFT | 7481b8f499a14a4340d3422d95c7f6fdc8c0c72b3a4Jean-Michel Trivi AudioFormat.CHANNEL_OUT_BACK_RIGHT | 749ad720aeea741d9058a7b4d326c9ab1b3ebcd7c62Andy Hung AudioFormat.CHANNEL_OUT_BACK_CENTER | 750ad720aeea741d9058a7b4d326c9ab1b3ebcd7c62Andy Hung AudioFormat.CHANNEL_OUT_SIDE_LEFT | 751ad720aeea741d9058a7b4d326c9ab1b3ebcd7c62Andy Hung AudioFormat.CHANNEL_OUT_SIDE_RIGHT; 7529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Convenience method for the constructor's parameter checks. 7549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // This is where constructor IllegalArgumentException-s are thrown 7559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // postconditions: 7569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // mChannelCount is valid 7579ea5e5564812bb88e62d0c4fae8f1d40d8a6e7e0Glenn Kasten // mChannelMask is valid 7589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // mAudioFormat is valid 7599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // mSampleRate is valid 7609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // mDataLoadMode is valid 761a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung private void audioParamCheck(int sampleRateInHz, int channelConfig, int channelIndexMask, 762a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung int audioFormat, int mode) { 7639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //-------------- 7645c17a820f9e46e0756c11795b3e6f89105f2f539Glenn Kasten // sample rate, note these values are subject to change 7659e4a66d69673adcf5f32e4b121809322d9ffd97cAndy Hung if (sampleRateInHz < SAMPLE_RATE_HZ_MIN || sampleRateInHz > SAMPLE_RATE_HZ_MAX) { 766f4e58051e22ad4e21c7cd436c37cc5665c194d1cGlenn Kasten throw new IllegalArgumentException(sampleRateInHz 767f4e58051e22ad4e21c7cd436c37cc5665c194d1cGlenn Kasten + "Hz is not a supported sample rate."); 7689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 769896a7f5fee46c24d31e9403abdf5813e4bb84ca5Glenn Kasten mSampleRate = sampleRateInHz; 7709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //-------------- 7729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // channel config 7733026a023b8979b7ddcb3fe97bbc45531c89fda92Eric Laurent mChannelConfiguration = channelConfig; 7743026a023b8979b7ddcb3fe97bbc45531c89fda92Eric Laurent 7759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project switch (channelConfig) { 7763026a023b8979b7ddcb3fe97bbc45531c89fda92Eric Laurent case AudioFormat.CHANNEL_OUT_DEFAULT: //AudioFormat.CHANNEL_CONFIGURATION_DEFAULT 777a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent case AudioFormat.CHANNEL_OUT_MONO: 7783026a023b8979b7ddcb3fe97bbc45531c89fda92Eric Laurent case AudioFormat.CHANNEL_CONFIGURATION_MONO: 7799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mChannelCount = 1; 7809ea5e5564812bb88e62d0c4fae8f1d40d8a6e7e0Glenn Kasten mChannelMask = AudioFormat.CHANNEL_OUT_MONO; 7819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project break; 782a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent case AudioFormat.CHANNEL_OUT_STEREO: 7833026a023b8979b7ddcb3fe97bbc45531c89fda92Eric Laurent case AudioFormat.CHANNEL_CONFIGURATION_STEREO: 7849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mChannelCount = 2; 7859ea5e5564812bb88e62d0c4fae8f1d40d8a6e7e0Glenn Kasten mChannelMask = AudioFormat.CHANNEL_OUT_STEREO; 7869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project break; 7879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project default: 788a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung if (channelConfig == AudioFormat.CHANNEL_INVALID && channelIndexMask != 0) { 789a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung mChannelCount = 0; 790a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung break; // channel index configuration only 791a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung } 792d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi if (!isMultichannelConfigSupported(channelConfig)) { 7931b8f499a14a4340d3422d95c7f6fdc8c0c72b3a4Jean-Michel Trivi // input channel configuration features unsupported channels 794f4e58051e22ad4e21c7cd436c37cc5665c194d1cGlenn Kasten throw new IllegalArgumentException("Unsupported channel configuration."); 7951b8f499a14a4340d3422d95c7f6fdc8c0c72b3a4Jean-Michel Trivi } 7969ea5e5564812bb88e62d0c4fae8f1d40d8a6e7e0Glenn Kasten mChannelMask = channelConfig; 7978528ed43b41ff02535675c5da7425bef5195e73bAndy Hung mChannelCount = AudioFormat.channelCountFromOutChannelMask(channelConfig); 7989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 799a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung // check the channel index configuration (if present) 800a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung mChannelIndexMask = channelIndexMask; 801a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung if (mChannelIndexMask != 0) { 802a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung // restrictive: indexMask could allow up to AUDIO_CHANNEL_BITS_LOG2 803a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung final int indexMask = (1 << CHANNEL_COUNT_MAX) - 1; 804a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung if ((channelIndexMask & ~indexMask) != 0) { 805a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung throw new IllegalArgumentException("Unsupported channel index configuration " 806a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung + channelIndexMask); 807a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung } 808a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung int channelIndexCount = Integer.bitCount(channelIndexMask); 809a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung if (mChannelCount == 0) { 810a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung mChannelCount = channelIndexCount; 811a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung } else if (mChannelCount != channelIndexCount) { 812a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung throw new IllegalArgumentException("Channel count must match"); 813a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung } 814a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung } 8159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //-------------- 8179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // audio format 818ff0d9f098e51c54e1a030ed21fd980680cb7b405Eric Laurent if (audioFormat == AudioFormat.ENCODING_DEFAULT) { 819ff0d9f098e51c54e1a030ed21fd980680cb7b405Eric Laurent audioFormat = AudioFormat.ENCODING_PCM_16BIT; 820ff0d9f098e51c54e1a030ed21fd980680cb7b405Eric Laurent } 821ff0d9f098e51c54e1a030ed21fd980680cb7b405Eric Laurent 822cae346633321e237f824f3ca10d7e6fff2307b2fEric Laurent if (!AudioFormat.isPublicEncoding(audioFormat)) { 823ff0d9f098e51c54e1a030ed21fd980680cb7b405Eric Laurent throw new IllegalArgumentException("Unsupported audio encoding."); 8249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 825ff0d9f098e51c54e1a030ed21fd980680cb7b405Eric Laurent mAudioFormat = audioFormat; 8269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //-------------- 8289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // audio load mode 829ff0d9f098e51c54e1a030ed21fd980680cb7b405Eric Laurent if (((mode != MODE_STREAM) && (mode != MODE_STATIC)) || 830ff0d9f098e51c54e1a030ed21fd980680cb7b405Eric Laurent ((mode != MODE_STREAM) && !AudioFormat.isEncodingLinearPcm(mAudioFormat))) { 831f4e58051e22ad4e21c7cd436c37cc5665c194d1cGlenn Kasten throw new IllegalArgumentException("Invalid mode."); 8329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 833896a7f5fee46c24d31e9403abdf5813e4bb84ca5Glenn Kasten mDataLoadMode = mode; 8349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 836d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi /** 837d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi * Convenience method to check that the channel configuration (a.k.a channel mask) is supported 838d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi * @param channelConfig the mask to validate 839d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi * @return false if the AudioTrack can't be used with such a mask 840d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi */ 841d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi private static boolean isMultichannelConfigSupported(int channelConfig) { 842d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi // check for unsupported channels 843d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi if ((channelConfig & SUPPORTED_OUT_CHANNELS) != channelConfig) { 8441f61d01508651b4475397414e1fe06af1ab8fadaGlenn Kasten loge("Channel configuration features unsupported channels"); 845d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi return false; 846d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi } 8478528ed43b41ff02535675c5da7425bef5195e73bAndy Hung final int channelCount = AudioFormat.channelCountFromOutChannelMask(channelConfig); 848ad720aeea741d9058a7b4d326c9ab1b3ebcd7c62Andy Hung if (channelCount > CHANNEL_COUNT_MAX) { 849ad720aeea741d9058a7b4d326c9ab1b3ebcd7c62Andy Hung loge("Channel configuration contains too many channels " + 850ad720aeea741d9058a7b4d326c9ab1b3ebcd7c62Andy Hung channelCount + ">" + CHANNEL_COUNT_MAX); 851ad720aeea741d9058a7b4d326c9ab1b3ebcd7c62Andy Hung return false; 852ad720aeea741d9058a7b4d326c9ab1b3ebcd7c62Andy Hung } 853d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi // check for unsupported multichannel combinations: 854d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi // - FL/FR must be present 855d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi // - L/R channels must be paired (e.g. no single L channel) 856d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi final int frontPair = 857d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi AudioFormat.CHANNEL_OUT_FRONT_LEFT | AudioFormat.CHANNEL_OUT_FRONT_RIGHT; 858d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi if ((channelConfig & frontPair) != frontPair) { 8591f61d01508651b4475397414e1fe06af1ab8fadaGlenn Kasten loge("Front channels must be present in multichannel configurations"); 860d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi return false; 861d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi } 862d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi final int backPair = 863d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi AudioFormat.CHANNEL_OUT_BACK_LEFT | AudioFormat.CHANNEL_OUT_BACK_RIGHT; 864d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi if ((channelConfig & backPair) != 0) { 865d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi if ((channelConfig & backPair) != backPair) { 8661f61d01508651b4475397414e1fe06af1ab8fadaGlenn Kasten loge("Rear channels can't be used independently"); 867d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi return false; 868d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi } 869d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi } 870ad720aeea741d9058a7b4d326c9ab1b3ebcd7c62Andy Hung final int sidePair = 871ad720aeea741d9058a7b4d326c9ab1b3ebcd7c62Andy Hung AudioFormat.CHANNEL_OUT_SIDE_LEFT | AudioFormat.CHANNEL_OUT_SIDE_RIGHT; 872ad720aeea741d9058a7b4d326c9ab1b3ebcd7c62Andy Hung if ((channelConfig & sidePair) != 0 873ad720aeea741d9058a7b4d326c9ab1b3ebcd7c62Andy Hung && (channelConfig & sidePair) != sidePair) { 874ad720aeea741d9058a7b4d326c9ab1b3ebcd7c62Andy Hung loge("Side channels can't be used independently"); 875ad720aeea741d9058a7b4d326c9ab1b3ebcd7c62Andy Hung return false; 876ad720aeea741d9058a7b4d326c9ab1b3ebcd7c62Andy Hung } 877d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi return true; 878d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi } 879d9e587137b926a56e6e339f11da6a91624df515aJean-Michel Trivi 8809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 881e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten // Convenience method for the constructor's audio buffer size check. 8829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // preconditions: 8839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // mChannelCount is valid 8849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // mAudioFormat is valid 8859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // postcondition: 8869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // mNativeBufferSizeInBytes is valid (multiple of frame size, positive) 8879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private void audioBuffSizeCheck(int audioBufferSize) { 8889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // NB: this section is only valid with PCM data. 8899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // To update when supporting compressed formats 890ff0d9f098e51c54e1a030ed21fd980680cb7b405Eric Laurent int frameSizeInBytes; 891ff0d9f098e51c54e1a030ed21fd980680cb7b405Eric Laurent if (AudioFormat.isEncodingLinearPcm(mAudioFormat)) { 892340a6d09bdba7d4d99cef52a83a90fb96842c58aGlenn Kasten frameSizeInBytes = mChannelCount * AudioFormat.getBytesPerSample(mAudioFormat); 893ff0d9f098e51c54e1a030ed21fd980680cb7b405Eric Laurent } else { 894ff0d9f098e51c54e1a030ed21fd980680cb7b405Eric Laurent frameSizeInBytes = 1; 895ff0d9f098e51c54e1a030ed21fd980680cb7b405Eric Laurent } 8969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if ((audioBufferSize % frameSizeInBytes != 0) || (audioBufferSize < 1)) { 897f4e58051e22ad4e21c7cd436c37cc5665c194d1cGlenn Kasten throw new IllegalArgumentException("Invalid audio buffer size."); 8989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mNativeBufferSizeInBytes = audioBufferSize; 901e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten mNativeBufferSizeInFrames = audioBufferSize / frameSizeInBytes; 9029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Releases the native AudioTrack resources. 9079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void release() { 9099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // even though native_release() stops the native AudioTrack, we need to stop 9109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // AudioTrack subclasses too. 9119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 9129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project stop(); 913fb2ab9efc3805c81521afb9ff91a58ff5097a36eGlenn Kasten } catch(IllegalStateException ise) { 9149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // don't raise an exception, we're releasing the resources. 9159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project native_release(); 9179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mState = STATE_UNINITIALIZED; 9189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 9219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project protected void finalize() { 9229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project native_finalize(); 9239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //-------------------------------------------------------------------------- 9269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Getters 9279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //-------------------- 9289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 92978cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * Returns the minimum gain value, which is the constant 0.0. 93078cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * Gain values less than 0.0 will be clamped to 0.0. 93178cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * <p>The word "volume" in the API name is historical; this is actually a linear gain. 93278cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * @return the minimum value, which is the constant 0.0. 9339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project static public float getMinVolume() { 93578cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten return GAIN_MIN; 9369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 93978cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * Returns the maximum gain value, which is greater than or equal to 1.0. 94078cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * Gain values greater than the maximum will be clamped to the maximum. 94178cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * <p>The word "volume" in the API name is historical; this is actually a gain. 94278cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * expressed as a linear multiplier on sample values, where a maximum value of 1.0 94378cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * corresponds to a gain of 0 dB (sample values left unmodified). 94478cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * @return the maximum value, which is greater than or equal to 1.0. 9459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project static public float getMaxVolume() { 94778cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten return GAIN_MAX; 9489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the configured audio data sample rate in Hz 9529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getSampleRate() { 9549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mSampleRate; 9559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 956fb2ab9efc3805c81521afb9ff91a58ff5097a36eGlenn Kasten 9579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 958263b4c97823295c41900210515d0c769a236190cAndy Hung * Returns the current playback sample rate rate in Hz. 9599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getPlaybackRate() { 9619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return native_get_playback_rate(); 9629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9655f68c7a3f8400bcef233bf02d9a722f6d21f5c34Glenn Kasten * Returns the current playback parameters. 9665f68c7a3f8400bcef233bf02d9a722f6d21f5c34Glenn Kasten * See {@link #setPlaybackParams(PlaybackParams)} to set playback parameters 9672d61e2b97c92ac2de80ebb3782b728ae5cdf5306Wei Jia * @return current {@link PlaybackParams}. 968263b4c97823295c41900210515d0c769a236190cAndy Hung * @throws IllegalStateException if track is not initialized. 969263b4c97823295c41900210515d0c769a236190cAndy Hung */ 9702d61e2b97c92ac2de80ebb3782b728ae5cdf5306Wei Jia public @NonNull PlaybackParams getPlaybackParams() { 9712d61e2b97c92ac2de80ebb3782b728ae5cdf5306Wei Jia return native_get_playback_params(); 972263b4c97823295c41900210515d0c769a236190cAndy Hung } 973263b4c97823295c41900210515d0c769a236190cAndy Hung 974263b4c97823295c41900210515d0c769a236190cAndy Hung /** 975463a8c7743c5187827a8ac56b7767b50ab491ca8Andy Hung * Returns the configured audio data encoding. See {@link AudioFormat#ENCODING_PCM_8BIT}, 976463a8c7743c5187827a8ac56b7767b50ab491ca8Andy Hung * {@link AudioFormat#ENCODING_PCM_16BIT}, and {@link AudioFormat#ENCODING_PCM_FLOAT}. 9779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getAudioFormat() { 9799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mAudioFormat; 9809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the type of audio stream this AudioTrack is configured for. 9849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Compare the result against {@link AudioManager#STREAM_VOICE_CALL}, 9859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link AudioManager#STREAM_SYSTEM}, {@link AudioManager#STREAM_RING}, 9865c17a820f9e46e0756c11795b3e6f89105f2f539Glenn Kasten * {@link AudioManager#STREAM_MUSIC}, {@link AudioManager#STREAM_ALARM}, 987b282e08ab641d4fc74d0324b7a0ce30926638dd5Glenn Kasten * {@link AudioManager#STREAM_NOTIFICATION}, or {@link AudioManager#STREAM_DTMF}. 9889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getStreamType() { 9909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mStreamType; 9919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 994a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung * Returns the configured channel position mask. 995463a8c7743c5187827a8ac56b7767b50ab491ca8Andy Hung * <p> For example, refer to {@link AudioFormat#CHANNEL_OUT_MONO}, 996a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung * {@link AudioFormat#CHANNEL_OUT_STEREO}, {@link AudioFormat#CHANNEL_OUT_5POINT1}. 997463a8c7743c5187827a8ac56b7767b50ab491ca8Andy Hung * This method may return {@link AudioFormat#CHANNEL_INVALID} if 998340a6d09bdba7d4d99cef52a83a90fb96842c58aGlenn Kasten * a channel index mask was used. Consider 999463a8c7743c5187827a8ac56b7767b50ab491ca8Andy Hung * {@link #getFormat()} instead, to obtain an {@link AudioFormat}, 1000463a8c7743c5187827a8ac56b7767b50ab491ca8Andy Hung * which contains both the channel position mask and the channel index mask. 10019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 10029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getChannelConfiguration() { 10039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mChannelConfiguration; 10049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1007463a8c7743c5187827a8ac56b7767b50ab491ca8Andy Hung * Returns the configured <code>AudioTrack</code> format. 1008463a8c7743c5187827a8ac56b7767b50ab491ca8Andy Hung * @return an {@link AudioFormat} containing the 1009463a8c7743c5187827a8ac56b7767b50ab491ca8Andy Hung * <code>AudioTrack</code> parameters at the time of configuration. 1010463a8c7743c5187827a8ac56b7767b50ab491ca8Andy Hung */ 1011463a8c7743c5187827a8ac56b7767b50ab491ca8Andy Hung public @NonNull AudioFormat getFormat() { 1012463a8c7743c5187827a8ac56b7767b50ab491ca8Andy Hung AudioFormat.Builder builder = new AudioFormat.Builder() 1013463a8c7743c5187827a8ac56b7767b50ab491ca8Andy Hung .setSampleRate(mSampleRate) 1014463a8c7743c5187827a8ac56b7767b50ab491ca8Andy Hung .setEncoding(mAudioFormat); 1015463a8c7743c5187827a8ac56b7767b50ab491ca8Andy Hung if (mChannelConfiguration != AudioFormat.CHANNEL_INVALID) { 1016463a8c7743c5187827a8ac56b7767b50ab491ca8Andy Hung builder.setChannelMask(mChannelConfiguration); 1017463a8c7743c5187827a8ac56b7767b50ab491ca8Andy Hung } 1018463a8c7743c5187827a8ac56b7767b50ab491ca8Andy Hung if (mChannelIndexMask != AudioFormat.CHANNEL_INVALID /* 0 */) { 1019463a8c7743c5187827a8ac56b7767b50ab491ca8Andy Hung builder.setChannelIndexMask(mChannelIndexMask); 1020463a8c7743c5187827a8ac56b7767b50ab491ca8Andy Hung } 1021463a8c7743c5187827a8ac56b7767b50ab491ca8Andy Hung return builder.build(); 1022463a8c7743c5187827a8ac56b7767b50ab491ca8Andy Hung } 1023463a8c7743c5187827a8ac56b7767b50ab491ca8Andy Hung 1024463a8c7743c5187827a8ac56b7767b50ab491ca8Andy Hung /** 10259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the configured number of channels. 10269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 10279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getChannelCount() { 10289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mChannelCount; 10299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 10329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the state of the AudioTrack instance. This is useful after the 10339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * AudioTrack instance has been created to check if it was initialized 1034e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * properly. This ensures that the appropriate resources have been acquired. 1035340a6d09bdba7d4d99cef52a83a90fb96842c58aGlenn Kasten * @see #STATE_UNINITIALIZED 1036ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * @see #STATE_INITIALIZED 1037ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * @see #STATE_NO_STATIC_DATA 10389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 10399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getState() { 10409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mState; 10419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 10449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the playback state of the AudioTrack instance. 10459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #PLAYSTATE_STOPPED 10469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #PLAYSTATE_PAUSED 10479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #PLAYSTATE_PLAYING 10489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 10499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getPlayState() { 105006e0333c7eb50533cc6e0f7b61812d2840844296Narayan Kamath synchronized (mPlayStateLock) { 105106e0333c7eb50533cc6e0f7b61812d2840844296Narayan Kamath return mPlayState; 105206e0333c7eb50533cc6e0f7b61812d2840844296Narayan Kamath } 10539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 105510a33e499c97767f8d6bfc6514ba8b5f485394daPhil Burk// TODO Change getBufferCapacityInFrames() reference below to 105610a33e499c97767f8d6bfc6514ba8b5f485394daPhil Burk// {@link #getBufferCapacityInFrames()} after @hide is removed. 105710a33e499c97767f8d6bfc6514ba8b5f485394daPhil Burk// TODO Change setBufferSizeInFrames(int) reference below to 105810a33e499c97767f8d6bfc6514ba8b5f485394daPhil Burk// {@link #setBufferSizeInFrames(int)} after @hide is removed. 105910a33e499c97767f8d6bfc6514ba8b5f485394daPhil Burk /** 106010a33e499c97767f8d6bfc6514ba8b5f485394daPhil Burk * Returns the effective size of the <code>AudioTrack</code> buffer 106110a33e499c97767f8d6bfc6514ba8b5f485394daPhil Burk * that the application writes to. 106210a33e499c97767f8d6bfc6514ba8b5f485394daPhil Burk * <p> This will be less than or equal to the result of 106310a33e499c97767f8d6bfc6514ba8b5f485394daPhil Burk * getBufferCapacityInFrames(). 106410a33e499c97767f8d6bfc6514ba8b5f485394daPhil Burk * It will be equal if setBufferSizeInFrames(int) has never been called. 106510a33e499c97767f8d6bfc6514ba8b5f485394daPhil Burk * <p> If the track is subsequently routed to a different output sink, the buffer 106610a33e499c97767f8d6bfc6514ba8b5f485394daPhil Burk * size and capacity may enlarge to accommodate. 106710a33e499c97767f8d6bfc6514ba8b5f485394daPhil Burk * <p> If the <code>AudioTrack</code> encoding indicates compressed data, 106810a33e499c97767f8d6bfc6514ba8b5f485394daPhil Burk * e.g. {@link AudioFormat#ENCODING_AC3}, then the frame count returned is 106910a33e499c97767f8d6bfc6514ba8b5f485394daPhil Burk * the size of the native <code>AudioTrack</code> buffer in bytes. 107010a33e499c97767f8d6bfc6514ba8b5f485394daPhil Burk * <p> See also {@link AudioManager#getProperty(String)} for key 107110a33e499c97767f8d6bfc6514ba8b5f485394daPhil Burk * {@link AudioManager#PROPERTY_OUTPUT_FRAMES_PER_BUFFER}. 107210a33e499c97767f8d6bfc6514ba8b5f485394daPhil Burk * @return current size in frames of the <code>AudioTrack</code> buffer. 107310a33e499c97767f8d6bfc6514ba8b5f485394daPhil Burk * @throws IllegalStateException 107410a33e499c97767f8d6bfc6514ba8b5f485394daPhil Burk */ 107510a33e499c97767f8d6bfc6514ba8b5f485394daPhil Burk public int getBufferSizeInFrames() { 107610a33e499c97767f8d6bfc6514ba8b5f485394daPhil Burk return native_get_buffer_size_frames(); 107710a33e499c97767f8d6bfc6514ba8b5f485394daPhil Burk } 107810a33e499c97767f8d6bfc6514ba8b5f485394daPhil Burk 107910a33e499c97767f8d6bfc6514ba8b5f485394daPhil Burk// TODO Change getBufferCapacityInFrames() reference below to 108010a33e499c97767f8d6bfc6514ba8b5f485394daPhil Burk// {@link #getBufferCapacityInFrames()} after @hide is removed. 108110a33e499c97767f8d6bfc6514ba8b5f485394daPhil Burk /** 108210a33e499c97767f8d6bfc6514ba8b5f485394daPhil Burk * Limits the effective size of the <code>AudioTrack</code> buffer 108310a33e499c97767f8d6bfc6514ba8b5f485394daPhil Burk * that the application writes to. 108410a33e499c97767f8d6bfc6514ba8b5f485394daPhil Burk * <p> A write to this AudioTrack will not fill the buffer beyond this limit. 108510a33e499c97767f8d6bfc6514ba8b5f485394daPhil Burk * If a blocking write is used then the write will block until the the data 108610a33e499c97767f8d6bfc6514ba8b5f485394daPhil Burk * can fit within this limit. 108710a33e499c97767f8d6bfc6514ba8b5f485394daPhil Burk * <p>Changing this limit modifies the latency associated with 108810a33e499c97767f8d6bfc6514ba8b5f485394daPhil Burk * the buffer for this track. A smaller size will give lower latency 108910a33e499c97767f8d6bfc6514ba8b5f485394daPhil Burk * but there may be more glitches due to buffer underruns. 109010a33e499c97767f8d6bfc6514ba8b5f485394daPhil Burk * <p>The actual size used may not be equal to this requested size. 109110a33e499c97767f8d6bfc6514ba8b5f485394daPhil Burk * It will be limited to a valid range with a maximum of 109210a33e499c97767f8d6bfc6514ba8b5f485394daPhil Burk * getBufferCapacityInFrames(). 109310a33e499c97767f8d6bfc6514ba8b5f485394daPhil Burk * It may also be adjusted slightly for internal reasons. 109410a33e499c97767f8d6bfc6514ba8b5f485394daPhil Burk * If bufferSizeInFrames is less than zero then {@link #ERROR_BAD_VALUE} 109510a33e499c97767f8d6bfc6514ba8b5f485394daPhil Burk * will be returned. 109610a33e499c97767f8d6bfc6514ba8b5f485394daPhil Burk * <p>This method is only supported for PCM audio. 109710a33e499c97767f8d6bfc6514ba8b5f485394daPhil Burk * It is not supported for compressed audio tracks. 109810a33e499c97767f8d6bfc6514ba8b5f485394daPhil Burk * 109910a33e499c97767f8d6bfc6514ba8b5f485394daPhil Burk * @param bufferSizeInFrames requested buffer size 110010a33e499c97767f8d6bfc6514ba8b5f485394daPhil Burk * @return error code or success, see {@link #SUCCESS}, {@link #ERROR_BAD_VALUE}, 110110a33e499c97767f8d6bfc6514ba8b5f485394daPhil Burk * {@link #ERROR_INVALID_OPERATION} 110210a33e499c97767f8d6bfc6514ba8b5f485394daPhil Burk * @throws IllegalStateException 110310a33e499c97767f8d6bfc6514ba8b5f485394daPhil Burk */ 110410a33e499c97767f8d6bfc6514ba8b5f485394daPhil Burk public int setBufferSizeInFrames(int bufferSizeInFrames) { 110510a33e499c97767f8d6bfc6514ba8b5f485394daPhil Burk if (mDataLoadMode == MODE_STATIC || mState == STATE_UNINITIALIZED) { 110610a33e499c97767f8d6bfc6514ba8b5f485394daPhil Burk return ERROR_INVALID_OPERATION; 110710a33e499c97767f8d6bfc6514ba8b5f485394daPhil Burk } 110810a33e499c97767f8d6bfc6514ba8b5f485394daPhil Burk if (bufferSizeInFrames < 0) { 110910a33e499c97767f8d6bfc6514ba8b5f485394daPhil Burk return ERROR_BAD_VALUE; 111010a33e499c97767f8d6bfc6514ba8b5f485394daPhil Burk } 111110a33e499c97767f8d6bfc6514ba8b5f485394daPhil Burk return native_set_buffer_size_frames(bufferSizeInFrames); 111210a33e499c97767f8d6bfc6514ba8b5f485394daPhil Burk } 111310a33e499c97767f8d6bfc6514ba8b5f485394daPhil Burk 11149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 111510a33e499c97767f8d6bfc6514ba8b5f485394daPhil Burk * Returns the maximum size of the native <code>AudioTrack</code> buffer. 11164bd513e6ed168811c97dbc83cd5a7c7cc43caffeAndy Hung * <p> If the track's creation mode is {@link #MODE_STATIC}, 11174bd513e6ed168811c97dbc83cd5a7c7cc43caffeAndy Hung * it is equal to the specified bufferSizeInBytes on construction, converted to frame units. 11184bd513e6ed168811c97dbc83cd5a7c7cc43caffeAndy Hung * A static track's native frame count will not change. 11194bd513e6ed168811c97dbc83cd5a7c7cc43caffeAndy Hung * <p> If the track's creation mode is {@link #MODE_STREAM}, 11204bd513e6ed168811c97dbc83cd5a7c7cc43caffeAndy Hung * it is greater than or equal to the specified bufferSizeInBytes converted to frame units. 11214bd513e6ed168811c97dbc83cd5a7c7cc43caffeAndy Hung * For streaming tracks, this value may be rounded up to a larger value if needed by 11224bd513e6ed168811c97dbc83cd5a7c7cc43caffeAndy Hung * the target output sink, and 11234bd513e6ed168811c97dbc83cd5a7c7cc43caffeAndy Hung * if the track is subsequently routed to a different output sink, the native 11244bd513e6ed168811c97dbc83cd5a7c7cc43caffeAndy Hung * frame count may enlarge to accommodate. 1125e90a0a88f4eabdc27c3ef033f38c91ea23362a1eAndy Hung * <p> If the <code>AudioTrack</code> encoding indicates compressed data, 1126e90a0a88f4eabdc27c3ef033f38c91ea23362a1eAndy Hung * e.g. {@link AudioFormat#ENCODING_AC3}, then the frame count returned is 1127e90a0a88f4eabdc27c3ef033f38c91ea23362a1eAndy Hung * the size of the native <code>AudioTrack</code> buffer in bytes. 1128e90a0a88f4eabdc27c3ef033f38c91ea23362a1eAndy Hung * <p> See also {@link AudioManager#getProperty(String)} for key 112955a3218f242a611afb3569d88970c0c5dbf8ce54Glenn Kasten * {@link AudioManager#PROPERTY_OUTPUT_FRAMES_PER_BUFFER}. 113010a33e499c97767f8d6bfc6514ba8b5f485394daPhil Burk * @return maximum size in frames of the <code>AudioTrack</code> buffer. 11314bd513e6ed168811c97dbc83cd5a7c7cc43caffeAndy Hung * @throws IllegalStateException 11329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 113310a33e499c97767f8d6bfc6514ba8b5f485394daPhil Burk public int getBufferCapacityInFrames() { 113410a33e499c97767f8d6bfc6514ba8b5f485394daPhil Burk return native_get_buffer_capacity_frames(); 1135e90a0a88f4eabdc27c3ef033f38c91ea23362a1eAndy Hung } 1136e90a0a88f4eabdc27c3ef033f38c91ea23362a1eAndy Hung 1137e90a0a88f4eabdc27c3ef033f38c91ea23362a1eAndy Hung /** 1138e90a0a88f4eabdc27c3ef033f38c91ea23362a1eAndy Hung * Returns the frame count of the native <code>AudioTrack</code> buffer. 1139e90a0a88f4eabdc27c3ef033f38c91ea23362a1eAndy Hung * @return current size in frames of the <code>AudioTrack</code> buffer. 1140e90a0a88f4eabdc27c3ef033f38c91ea23362a1eAndy Hung * @throws IllegalStateException 1141e90a0a88f4eabdc27c3ef033f38c91ea23362a1eAndy Hung * @deprecated Use the identical public method {@link #getBufferSizeInFrames()} instead. 1142e90a0a88f4eabdc27c3ef033f38c91ea23362a1eAndy Hung */ 1143e90a0a88f4eabdc27c3ef033f38c91ea23362a1eAndy Hung @Deprecated 1144e90a0a88f4eabdc27c3ef033f38c91ea23362a1eAndy Hung protected int getNativeFrameCount() { 114510a33e499c97767f8d6bfc6514ba8b5f485394daPhil Burk return native_get_buffer_capacity_frames(); 11469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1149ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * Returns marker position expressed in frames. 1150e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * @return marker position in wrapping frame units similar to {@link #getPlaybackHeadPosition}, 1151e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * or zero if marker is disabled. 11529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 11539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getNotificationMarkerPosition() { 11549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return native_get_marker_pos(); 11559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1158ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * Returns the notification update period expressed in frames. 1159e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * Zero means that no position update notifications are being delivered. 11609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 11619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getPositionNotificationPeriod() { 11629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return native_get_pos_update_period(); 11639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1166e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * Returns the playback head position expressed in frames. 1167e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * Though the "int" type is signed 32-bits, the value should be reinterpreted as if it is 1168e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * unsigned 32-bits. That is, the next position after 0x7FFFFFFF is (int) 0x80000000. 1169e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * This is a continuously advancing counter. It will wrap (overflow) periodically, 1170e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * for example approximately once every 27:03:11 hours:minutes:seconds at 44.1 kHz. 1171ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * It is reset to zero by {@link #flush()}, {@link #reloadStaticData()}, and {@link #stop()}. 1172ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * If the track's creation mode is {@link #MODE_STATIC}, the return value indicates 1173ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * the total number of frames played since reset, 1174ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * <i>not</i> the current offset within the buffer. 11759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 11769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getPlaybackHeadPosition() { 11779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return native_get_position(); 11789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 118161dcdf3764b614c6f01e77cb4342d192e3101f8aOliver Woodman * Returns this track's estimated latency in milliseconds. This includes the latency due 118261dcdf3764b614c6f01e77cb4342d192e3101f8aOliver Woodman * to AudioTrack buffer size, AudioMixer (if any) and audio hardware driver. 118361dcdf3764b614c6f01e77cb4342d192e3101f8aOliver Woodman * 118461dcdf3764b614c6f01e77cb4342d192e3101f8aOliver Woodman * DO NOT UNHIDE. The existing approach for doing A/V sync has too many problems. We need 118561dcdf3764b614c6f01e77cb4342d192e3101f8aOliver Woodman * a better solution. 118661dcdf3764b614c6f01e77cb4342d192e3101f8aOliver Woodman * @hide 118761dcdf3764b614c6f01e77cb4342d192e3101f8aOliver Woodman */ 118861dcdf3764b614c6f01e77cb4342d192e3101f8aOliver Woodman public int getLatency() { 118961dcdf3764b614c6f01e77cb4342d192e3101f8aOliver Woodman return native_get_latency(); 119061dcdf3764b614c6f01e77cb4342d192e3101f8aOliver Woodman } 119161dcdf3764b614c6f01e77cb4342d192e3101f8aOliver Woodman 119261dcdf3764b614c6f01e77cb4342d192e3101f8aOliver Woodman /** 119303f61bbb2e7293592ad4a304b0f0b8e6ee8e6aacPhil Burk * Returns the number of underrun occurrences in the application-level write buffer 119403f61bbb2e7293592ad4a304b0f0b8e6ee8e6aacPhil Burk * since the AudioTrack was created. 119503f61bbb2e7293592ad4a304b0f0b8e6ee8e6aacPhil Burk * An underrun occurs if the application does not write audio 119603f61bbb2e7293592ad4a304b0f0b8e6ee8e6aacPhil Burk * data quickly enough, causing the buffer to underflow 119703f61bbb2e7293592ad4a304b0f0b8e6ee8e6aacPhil Burk * and a potential audio glitch or pop. 119803f61bbb2e7293592ad4a304b0f0b8e6ee8e6aacPhil Burk * Underruns are less likely when buffer sizes are large. 119903f61bbb2e7293592ad4a304b0f0b8e6ee8e6aacPhil Burk * <p> Though the "int" type is signed 32-bits, the value should be reinterpreted 120003f61bbb2e7293592ad4a304b0f0b8e6ee8e6aacPhil Burk * as if it is unsigned 32-bits. 120103f61bbb2e7293592ad4a304b0f0b8e6ee8e6aacPhil Burk * That is, the next position after 0x7FFFFFFF is (int) 0x80000000. 120203f61bbb2e7293592ad4a304b0f0b8e6ee8e6aacPhil Burk * This is a continuously advancing counter. It can wrap around to zero 120303f61bbb2e7293592ad4a304b0f0b8e6ee8e6aacPhil Burk * if there are too many underruns. If there were, for example, 68 underruns per 120403f61bbb2e7293592ad4a304b0f0b8e6ee8e6aacPhil Burk * second then the counter would wrap in 2 years. 120503f61bbb2e7293592ad4a304b0f0b8e6ee8e6aacPhil Burk */ 120603f61bbb2e7293592ad4a304b0f0b8e6ee8e6aacPhil Burk public int getUnderrunCount() { 120703f61bbb2e7293592ad4a304b0f0b8e6ee8e6aacPhil Burk return native_get_underrun_count(); 120803f61bbb2e7293592ad4a304b0f0b8e6ee8e6aacPhil Burk } 120903f61bbb2e7293592ad4a304b0f0b8e6ee8e6aacPhil Burk 121003f61bbb2e7293592ad4a304b0f0b8e6ee8e6aacPhil Burk /** 1211e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * Returns the output sample rate in Hz for the specified stream type. 12129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 12139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project static public int getNativeOutputSampleRate(int streamType) { 12149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return native_get_output_sample_rate(streamType); 12159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1216fb2ab9efc3805c81521afb9ff91a58ff5097a36eGlenn Kasten 12179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 12189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the minimum buffer size required for the successful creation of an AudioTrack 1219ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * object to be created in the {@link #MODE_STREAM} mode. Note that this size doesn't 1220ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * guarantee a smooth playback under load, and higher values should be chosen according to 1221fb2ab9efc3805c81521afb9ff91a58ff5097a36eGlenn Kasten * the expected frequency at which the buffer will be refilled with additional data to play. 12228d7fa137466c833ed422053204fb4c506b7bb209Glenn Kasten * For example, if you intend to dynamically set the source sample rate of an AudioTrack 12238d7fa137466c833ed422053204fb4c506b7bb209Glenn Kasten * to a higher value than the initial source sample rate, be sure to configure the buffer size 12248d7fa137466c833ed422053204fb4c506b7bb209Glenn Kasten * based on the highest planned sample rate. 12258d7fa137466c833ed422053204fb4c506b7bb209Glenn Kasten * @param sampleRateInHz the source sample rate expressed in Hz. 1226fb2ab9efc3805c81521afb9ff91a58ff5097a36eGlenn Kasten * @param channelConfig describes the configuration of the audio channels. 1227a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * See {@link AudioFormat#CHANNEL_OUT_MONO} and 1228a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent * {@link AudioFormat#CHANNEL_OUT_STEREO} 1229fb2ab9efc3805c81521afb9ff91a58ff5097a36eGlenn Kasten * @param audioFormat the format in which the audio data is represented. 1230fb2ab9efc3805c81521afb9ff91a58ff5097a36eGlenn Kasten * See {@link AudioFormat#ENCODING_PCM_16BIT} and 12317d60bcd2d950e3571c00ce9f1c492c6bd58334c9Glenn Kasten * {@link AudioFormat#ENCODING_PCM_8BIT}, 12327d60bcd2d950e3571c00ce9f1c492c6bd58334c9Glenn Kasten * and {@link AudioFormat#ENCODING_PCM_FLOAT}. 12339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return {@link #ERROR_BAD_VALUE} if an invalid parameter was passed, 1234e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * or {@link #ERROR} if unable to query for output properties, 1235ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * or the minimum buffer size expressed in bytes. 12369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 12379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project static public int getMinBufferSize(int sampleRateInHz, int channelConfig, int audioFormat) { 12389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int channelCount = 0; 12399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project switch(channelConfig) { 1240a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent case AudioFormat.CHANNEL_OUT_MONO: 12413026a023b8979b7ddcb3fe97bbc45531c89fda92Eric Laurent case AudioFormat.CHANNEL_CONFIGURATION_MONO: 12429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project channelCount = 1; 12439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project break; 1244a553c25b33c99b345cf1c8688f8df0ed8df14e5aEric Laurent case AudioFormat.CHANNEL_OUT_STEREO: 12453026a023b8979b7ddcb3fe97bbc45531c89fda92Eric Laurent case AudioFormat.CHANNEL_CONFIGURATION_STEREO: 12469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project channelCount = 2; 12479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project break; 12489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project default: 1249a9470c19a9dfe362a201c569f14b669b7aa69ee4Andy Hung if (!isMultichannelConfigSupported(channelConfig)) { 12501b8f499a14a4340d3422d95c7f6fdc8c0c72b3a4Jean-Michel Trivi loge("getMinBufferSize(): Invalid channel configuration."); 1251df3cb5279857cac41909643c6703e8fc1621fad1Glenn Kasten return ERROR_BAD_VALUE; 12521b8f499a14a4340d3422d95c7f6fdc8c0c72b3a4Jean-Michel Trivi } else { 12538528ed43b41ff02535675c5da7425bef5195e73bAndy Hung channelCount = AudioFormat.channelCountFromOutChannelMask(channelConfig); 12541b8f499a14a4340d3422d95c7f6fdc8c0c72b3a4Jean-Michel Trivi } 12559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1256fb2ab9efc3805c81521afb9ff91a58ff5097a36eGlenn Kasten 1257cae346633321e237f824f3ca10d7e6fff2307b2fEric Laurent if (!AudioFormat.isPublicEncoding(audioFormat)) { 12589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project loge("getMinBufferSize(): Invalid audio format."); 1259df3cb5279857cac41909643c6703e8fc1621fad1Glenn Kasten return ERROR_BAD_VALUE; 12609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1261fb2ab9efc3805c81521afb9ff91a58ff5097a36eGlenn Kasten 12625c17a820f9e46e0756c11795b3e6f89105f2f539Glenn Kasten // sample rate, note these values are subject to change 1263ad67c9546494a7c4d9336b57889a7c19a7dbb945Glenn Kasten if ( (sampleRateInHz < SAMPLE_RATE_HZ_MIN) || (sampleRateInHz > SAMPLE_RATE_HZ_MAX) ) { 1264ad67c9546494a7c4d9336b57889a7c19a7dbb945Glenn Kasten loge("getMinBufferSize(): " + sampleRateInHz + " Hz is not a supported sample rate."); 1265df3cb5279857cac41909643c6703e8fc1621fad1Glenn Kasten return ERROR_BAD_VALUE; 12669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1267fb2ab9efc3805c81521afb9ff91a58ff5097a36eGlenn Kasten 12689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int size = native_get_min_buff_size(sampleRateInHz, channelCount, audioFormat); 1269a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten if (size <= 0) { 12709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project loge("getMinBufferSize(): error querying hardware"); 1271df3cb5279857cac41909643c6703e8fc1621fad1Glenn Kasten return ERROR; 12729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project else { 12749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return size; 12759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1278619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent /** 1279619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * Returns the audio session ID. 1280619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * 1281619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent * @return the ID of the audio session this AudioTrack belongs to. 1282619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent */ 1283619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent public int getAudioSessionId() { 1284619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent return mSessionId; 1285619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent } 12869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1287948c2e6ff46d65942277f2e0e9ce0c038972b9d8Glenn Kasten /** 1288948c2e6ff46d65942277f2e0e9ce0c038972b9d8Glenn Kasten * Poll for a timestamp on demand. 1289486918b41584cd2589c46c5217b3fba1e7d18874Glenn Kasten * <p> 1290486918b41584cd2589c46c5217b3fba1e7d18874Glenn Kasten * If you need to track timestamps during initial warmup or after a routing or mode change, 129100908b6c6964346af4d2512ba161a109912d97b8Glenn Kasten * you should request a new timestamp periodically until the reported timestamps 129200908b6c6964346af4d2512ba161a109912d97b8Glenn Kasten * show that the frame position is advancing, or until it becomes clear that 129300908b6c6964346af4d2512ba161a109912d97b8Glenn Kasten * timestamps are unavailable for this route. 129400908b6c6964346af4d2512ba161a109912d97b8Glenn Kasten * <p> 129500908b6c6964346af4d2512ba161a109912d97b8Glenn Kasten * After the clock is advancing at a stable rate, 129600908b6c6964346af4d2512ba161a109912d97b8Glenn Kasten * query for a new timestamp approximately once every 10 seconds to once per minute. 1297486918b41584cd2589c46c5217b3fba1e7d18874Glenn Kasten * Calling this method more often is inefficient. 1298486918b41584cd2589c46c5217b3fba1e7d18874Glenn Kasten * It is also counter-productive to call this method more often than recommended, 1299486918b41584cd2589c46c5217b3fba1e7d18874Glenn Kasten * because the short-term differences between successive timestamp reports are not meaningful. 1300486918b41584cd2589c46c5217b3fba1e7d18874Glenn Kasten * If you need a high-resolution mapping between frame position and presentation time, 1301948c2e6ff46d65942277f2e0e9ce0c038972b9d8Glenn Kasten * consider implementing that at application level, based on low-resolution timestamps. 1302486918b41584cd2589c46c5217b3fba1e7d18874Glenn Kasten * <p> 1303948c2e6ff46d65942277f2e0e9ce0c038972b9d8Glenn Kasten * The audio data at the returned position may either already have been 1304948c2e6ff46d65942277f2e0e9ce0c038972b9d8Glenn Kasten * presented, or may have not yet been presented but is committed to be presented. 1305948c2e6ff46d65942277f2e0e9ce0c038972b9d8Glenn Kasten * It is not possible to request the time corresponding to a particular position, 1306948c2e6ff46d65942277f2e0e9ce0c038972b9d8Glenn Kasten * or to request the (fractional) position corresponding to a particular time. 1307948c2e6ff46d65942277f2e0e9ce0c038972b9d8Glenn Kasten * If you need such features, consider implementing them at application level. 1308948c2e6ff46d65942277f2e0e9ce0c038972b9d8Glenn Kasten * 1309948c2e6ff46d65942277f2e0e9ce0c038972b9d8Glenn Kasten * @param timestamp a reference to a non-null AudioTimestamp instance allocated 1310596fb8e7969cafdf7f25dfdc97372be4c0950cc3Glenn Kasten * and owned by caller. 1311596fb8e7969cafdf7f25dfdc97372be4c0950cc3Glenn Kasten * @return true if a timestamp is available, or false if no timestamp is available. 1312596fb8e7969cafdf7f25dfdc97372be4c0950cc3Glenn Kasten * If a timestamp if available, 1313948c2e6ff46d65942277f2e0e9ce0c038972b9d8Glenn Kasten * the AudioTimestamp instance is filled in with a position in frame units, together 1314948c2e6ff46d65942277f2e0e9ce0c038972b9d8Glenn Kasten * with the estimated time when that frame was presented or is committed to 1315948c2e6ff46d65942277f2e0e9ce0c038972b9d8Glenn Kasten * be presented. 1316948c2e6ff46d65942277f2e0e9ce0c038972b9d8Glenn Kasten * In the case that no timestamp is available, any supplied instance is left unaltered. 1317c52f4e25e21719d5d637a588e3200be941b9fe4dGlenn Kasten * A timestamp may be temporarily unavailable while the audio clock is stabilizing, 1318c52f4e25e21719d5d637a588e3200be941b9fe4dGlenn Kasten * or during and immediately after a route change. 131900908b6c6964346af4d2512ba161a109912d97b8Glenn Kasten * A timestamp is permanently unavailable for a given route if the route does not support 132000908b6c6964346af4d2512ba161a109912d97b8Glenn Kasten * timestamps. In this case, the approximate frame position can be obtained 132100908b6c6964346af4d2512ba161a109912d97b8Glenn Kasten * using {@link #getPlaybackHeadPosition}. 132200908b6c6964346af4d2512ba161a109912d97b8Glenn Kasten * However, it may be useful to continue to query for 132300908b6c6964346af4d2512ba161a109912d97b8Glenn Kasten * timestamps occasionally, to recover after a route change. 1324948c2e6ff46d65942277f2e0e9ce0c038972b9d8Glenn Kasten */ 1325486918b41584cd2589c46c5217b3fba1e7d18874Glenn Kasten // Add this text when the "on new timestamp" API is added: 1326486918b41584cd2589c46c5217b3fba1e7d18874Glenn Kasten // Use if you need to get the most recent timestamp outside of the event callback handler. 1327596fb8e7969cafdf7f25dfdc97372be4c0950cc3Glenn Kasten public boolean getTimestamp(AudioTimestamp timestamp) 1328948c2e6ff46d65942277f2e0e9ce0c038972b9d8Glenn Kasten { 1329596fb8e7969cafdf7f25dfdc97372be4c0950cc3Glenn Kasten if (timestamp == null) { 1330596fb8e7969cafdf7f25dfdc97372be4c0950cc3Glenn Kasten throw new IllegalArgumentException(); 1331596fb8e7969cafdf7f25dfdc97372be4c0950cc3Glenn Kasten } 1332948c2e6ff46d65942277f2e0e9ce0c038972b9d8Glenn Kasten // It's unfortunate, but we have to either create garbage every time or use synchronized 1333948c2e6ff46d65942277f2e0e9ce0c038972b9d8Glenn Kasten long[] longArray = new long[2]; 1334948c2e6ff46d65942277f2e0e9ce0c038972b9d8Glenn Kasten int ret = native_get_timestamp(longArray); 1335596fb8e7969cafdf7f25dfdc97372be4c0950cc3Glenn Kasten if (ret != SUCCESS) { 1336596fb8e7969cafdf7f25dfdc97372be4c0950cc3Glenn Kasten return false; 1337948c2e6ff46d65942277f2e0e9ce0c038972b9d8Glenn Kasten } 1338596fb8e7969cafdf7f25dfdc97372be4c0950cc3Glenn Kasten timestamp.framePosition = longArray[0]; 1339596fb8e7969cafdf7f25dfdc97372be4c0950cc3Glenn Kasten timestamp.nanoTime = longArray[1]; 1340596fb8e7969cafdf7f25dfdc97372be4c0950cc3Glenn Kasten return true; 1341948c2e6ff46d65942277f2e0e9ce0c038972b9d8Glenn Kasten } 1342948c2e6ff46d65942277f2e0e9ce0c038972b9d8Glenn Kasten 13434e1ccd370fc268f3207c5baee08ac8c943c3fdf9Eric Laurent /** 13444e1ccd370fc268f3207c5baee08ac8c943c3fdf9Eric Laurent * Poll for a timestamp on demand. 13454e1ccd370fc268f3207c5baee08ac8c943c3fdf9Eric Laurent * <p> 13464e1ccd370fc268f3207c5baee08ac8c943c3fdf9Eric Laurent * Same as {@link #getTimestamp(AudioTimestamp)} but with a more useful return code. 13474e1ccd370fc268f3207c5baee08ac8c943c3fdf9Eric Laurent * 13484e1ccd370fc268f3207c5baee08ac8c943c3fdf9Eric Laurent * @param timestamp a reference to a non-null AudioTimestamp instance allocated 13494e1ccd370fc268f3207c5baee08ac8c943c3fdf9Eric Laurent * and owned by caller. 13504e1ccd370fc268f3207c5baee08ac8c943c3fdf9Eric Laurent * @return {@link #SUCCESS} if a timestamp is available 13514e1ccd370fc268f3207c5baee08ac8c943c3fdf9Eric Laurent * {@link #ERROR_WOULD_BLOCK} if called in STOPPED or FLUSHED state, or if called 13524e1ccd370fc268f3207c5baee08ac8c943c3fdf9Eric Laurent * immediately after start/ACTIVE, when the number of frames consumed is less than the 13534e1ccd370fc268f3207c5baee08ac8c943c3fdf9Eric Laurent * overall hardware latency to physical output. In WOULD_BLOCK cases, one might poll 13544e1ccd370fc268f3207c5baee08ac8c943c3fdf9Eric Laurent * again, or use {@link #getPlaybackHeadPosition}, or use 0 position and current time 13554e1ccd370fc268f3207c5baee08ac8c943c3fdf9Eric Laurent * for the timestamp. 13564e1ccd370fc268f3207c5baee08ac8c943c3fdf9Eric Laurent * {@link #ERROR_DEAD_OBJECT} if the AudioTrack is not valid anymore and 13574e1ccd370fc268f3207c5baee08ac8c943c3fdf9Eric Laurent * needs to be recreated. 13584e1ccd370fc268f3207c5baee08ac8c943c3fdf9Eric Laurent * {@link #ERROR_INVALID_OPERATION} if current route does not support 13594e1ccd370fc268f3207c5baee08ac8c943c3fdf9Eric Laurent * timestamps. In this case, the approximate frame position can be obtained 13604e1ccd370fc268f3207c5baee08ac8c943c3fdf9Eric Laurent * using {@link #getPlaybackHeadPosition}. 13614e1ccd370fc268f3207c5baee08ac8c943c3fdf9Eric Laurent * 13624e1ccd370fc268f3207c5baee08ac8c943c3fdf9Eric Laurent * The AudioTimestamp instance is filled in with a position in frame units, together 13634e1ccd370fc268f3207c5baee08ac8c943c3fdf9Eric Laurent * with the estimated time when that frame was presented or is committed to 13644e1ccd370fc268f3207c5baee08ac8c943c3fdf9Eric Laurent * be presented. 13654e1ccd370fc268f3207c5baee08ac8c943c3fdf9Eric Laurent * @hide 13664e1ccd370fc268f3207c5baee08ac8c943c3fdf9Eric Laurent */ 13674e1ccd370fc268f3207c5baee08ac8c943c3fdf9Eric Laurent // Add this text when the "on new timestamp" API is added: 13684e1ccd370fc268f3207c5baee08ac8c943c3fdf9Eric Laurent // Use if you need to get the most recent timestamp outside of the event callback handler. 13694e1ccd370fc268f3207c5baee08ac8c943c3fdf9Eric Laurent public int getTimestampWithStatus(AudioTimestamp timestamp) 13704e1ccd370fc268f3207c5baee08ac8c943c3fdf9Eric Laurent { 13714e1ccd370fc268f3207c5baee08ac8c943c3fdf9Eric Laurent if (timestamp == null) { 13724e1ccd370fc268f3207c5baee08ac8c943c3fdf9Eric Laurent throw new IllegalArgumentException(); 13734e1ccd370fc268f3207c5baee08ac8c943c3fdf9Eric Laurent } 13744e1ccd370fc268f3207c5baee08ac8c943c3fdf9Eric Laurent // It's unfortunate, but we have to either create garbage every time or use synchronized 13754e1ccd370fc268f3207c5baee08ac8c943c3fdf9Eric Laurent long[] longArray = new long[2]; 13764e1ccd370fc268f3207c5baee08ac8c943c3fdf9Eric Laurent int ret = native_get_timestamp(longArray); 13774e1ccd370fc268f3207c5baee08ac8c943c3fdf9Eric Laurent timestamp.framePosition = longArray[0]; 13784e1ccd370fc268f3207c5baee08ac8c943c3fdf9Eric Laurent timestamp.nanoTime = longArray[1]; 13794e1ccd370fc268f3207c5baee08ac8c943c3fdf9Eric Laurent return ret; 13804e1ccd370fc268f3207c5baee08ac8c943c3fdf9Eric Laurent } 1381948c2e6ff46d65942277f2e0e9ce0c038972b9d8Glenn Kasten 13829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //-------------------------------------------------------------------------- 13839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Initialization / configuration 13849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //-------------------- 13859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 13864df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project * Sets the listener the AudioTrack notifies when a previously set marker is reached or 13874df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project * for each periodic playback head position update. 1388ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * Notifications will be received in the same thread as the one in which the AudioTrack 1389ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * instance was created. 13909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param listener 13919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 13924df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project public void setPlaybackPositionUpdateListener(OnPlaybackPositionUpdateListener listener) { 13934df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project setPlaybackPositionUpdateListener(listener, null); 13949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1395fb2ab9efc3805c81521afb9ff91a58ff5097a36eGlenn Kasten 1396ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi /** 1397ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * Sets the listener the AudioTrack notifies when a previously set marker is reached or 1398ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * for each periodic playback head position update. 1399ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * Use this method to receive AudioTrack events in the Handler associated with another 1400ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * thread than the one in which you created the AudioTrack instance. 1401ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * @param listener 1402ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * @param handler the Handler that will receive the event notification messages. 1403ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi */ 1404fb2ab9efc3805c81521afb9ff91a58ff5097a36eGlenn Kasten public void setPlaybackPositionUpdateListener(OnPlaybackPositionUpdateListener listener, 14054df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project Handler handler) { 14064df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project if (listener != null) { 1407d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean mEventHandlerDelegate = new NativePositionEventHandlerDelegate(this, listener, handler); 140895bd2329c6a36211f18be3e089eaa775ec62df62Glenn Kasten } else { 140995bd2329c6a36211f18be3e089eaa775ec62df62Glenn Kasten mEventHandlerDelegate = null; 14109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 141478cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten private static float clampGainOrLevel(float gainOrLevel) { 141578cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten if (Float.isNaN(gainOrLevel)) { 141678cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten throw new IllegalArgumentException(); 141778cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten } 141878cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten if (gainOrLevel < GAIN_MIN) { 141978cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten gainOrLevel = GAIN_MIN; 142078cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten } else if (gainOrLevel > GAIN_MAX) { 142178cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten gainOrLevel = GAIN_MAX; 142278cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten } 142378cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten return gainOrLevel; 142478cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten } 142578cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten 14264df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project 14279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 142878cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * Sets the specified left and right output gain values on the AudioTrack. 142978cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * <p>Gain values are clamped to the closed interval [0.0, max] where 143078cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * max is the value of {@link #getMaxVolume}. 143178cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * A value of 0.0 results in zero gain (silence), and 143278cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * a value of 1.0 means unity gain (signal unchanged). 143378cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * The default value is 1.0 meaning unity gain. 143478cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * <p>The word "volume" in the API name is historical; this is actually a linear gain. 143578cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * @param leftGain output gain for the left channel. 143678cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * @param rightGain output gain for the right channel 14379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return error code or success, see {@link #SUCCESS}, 14389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #ERROR_INVALID_OPERATION} 143978cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * @deprecated Applications should use {@link #setVolume} instead, as it 144078cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * more gracefully scales down to mono, and up to multi-channel content beyond stereo. 14419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 144278cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten public int setStereoVolume(float leftGain, float rightGain) { 14431af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlock if (isRestricted()) { 14441af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlock return SUCCESS; 14451af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlock } 14463b4df62704a6184878afd9272830cf3db7bd2d66Glenn Kasten if (mState == STATE_UNINITIALIZED) { 14479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return ERROR_INVALID_OPERATION; 14489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 145078cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten leftGain = clampGainOrLevel(leftGain); 145178cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten rightGain = clampGainOrLevel(rightGain); 14529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 145378cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten native_setVolume(leftGain, rightGain); 14549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return SUCCESS; 14569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 146078cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * Sets the specified output gain value on all channels of this track. 146178cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * <p>Gain values are clamped to the closed interval [0.0, max] where 146278cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * max is the value of {@link #getMaxVolume}. 146378cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * A value of 0.0 results in zero gain (silence), and 146478cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * a value of 1.0 means unity gain (signal unchanged). 146578cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * The default value is 1.0 meaning unity gain. 146678cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * <p>This API is preferred over {@link #setStereoVolume}, as it 146778cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * more gracefully scales down to mono, and up to multi-channel content beyond stereo. 146878cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * <p>The word "volume" in the API name is historical; this is actually a linear gain. 146978cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * @param gain output gain for all channels. 14703e21cc8140e42bdcd924590e5e12446b6c55ad2aGlenn Kasten * @return error code or success, see {@link #SUCCESS}, 14713e21cc8140e42bdcd924590e5e12446b6c55ad2aGlenn Kasten * {@link #ERROR_INVALID_OPERATION} 1472068225de0197df07a0247b2877666ea91c22c992Glenn Kasten */ 147378cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten public int setVolume(float gain) { 147478cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten return setStereoVolume(gain, gain); 1475068225de0197df07a0247b2877666ea91c22c992Glenn Kasten } 1476068225de0197df07a0247b2877666ea91c22c992Glenn Kasten 1477068225de0197df07a0247b2877666ea91c22c992Glenn Kasten 1478068225de0197df07a0247b2877666ea91c22c992Glenn Kasten /** 14799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets the playback sample rate for this track. This sets the sampling rate at which 14808d7fa137466c833ed422053204fb4c506b7bb209Glenn Kasten * the audio data will be consumed and played back 14818d7fa137466c833ed422053204fb4c506b7bb209Glenn Kasten * (as set by the sampleRateInHz parameter in the 14828d7fa137466c833ed422053204fb4c506b7bb209Glenn Kasten * {@link #AudioTrack(int, int, int, int, int, int)} constructor), 14838d7fa137466c833ed422053204fb4c506b7bb209Glenn Kasten * not the original sampling rate of the 1484e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * content. For example, setting it to half the sample rate of the content will cause the 1485e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * playback to last twice as long, but will also result in a pitch shift down by one octave. 1486e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * The valid sample rate range is from 1 Hz to twice the value returned by 148788e209dcf8c2ebddda5c272f46d1bd5478bc639cEric Laurent * {@link #getNativeOutputSampleRate(int)}. 14882d61e2b97c92ac2de80ebb3782b728ae5cdf5306Wei Jia * Use {@link #setPlaybackParams(PlaybackParams)} for speed control. 1489e90a0a88f4eabdc27c3ef033f38c91ea23362a1eAndy Hung * <p> This method may also be used to repurpose an existing <code>AudioTrack</code> 1490e90a0a88f4eabdc27c3ef033f38c91ea23362a1eAndy Hung * for playback of content of differing sample rate, 1491e90a0a88f4eabdc27c3ef033f38c91ea23362a1eAndy Hung * but with identical encoding and channel mask. 1492ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * @param sampleRateInHz the sample rate expressed in Hz 14939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return error code or success, see {@link #SUCCESS}, {@link #ERROR_BAD_VALUE}, 14949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #ERROR_INVALID_OPERATION} 14959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 14969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int setPlaybackRate(int sampleRateInHz) { 1497f19395db6343efdf80d064e0ba7c3b9aa4dbae75Glenn Kasten if (mState != STATE_INITIALIZED) { 14989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return ERROR_INVALID_OPERATION; 14999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (sampleRateInHz <= 0) { 15019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return ERROR_BAD_VALUE; 15029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 150388e209dcf8c2ebddda5c272f46d1bd5478bc639cEric Laurent return native_set_playback_rate(sampleRateInHz); 15049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 15069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 15079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 15085f68c7a3f8400bcef233bf02d9a722f6d21f5c34Glenn Kasten * Sets the playback parameters. 15095f68c7a3f8400bcef233bf02d9a722f6d21f5c34Glenn Kasten * This method returns failure if it cannot apply the playback parameters. 1510263b4c97823295c41900210515d0c769a236190cAndy Hung * One possible cause is that the parameters for speed or pitch are out of range. 1511263b4c97823295c41900210515d0c769a236190cAndy Hung * Another possible cause is that the <code>AudioTrack</code> is streaming 1512263b4c97823295c41900210515d0c769a236190cAndy Hung * (see {@link #MODE_STREAM}) and the 1513263b4c97823295c41900210515d0c769a236190cAndy Hung * buffer size is too small. For speeds greater than 1.0f, the <code>AudioTrack</code> buffer 1514263b4c97823295c41900210515d0c769a236190cAndy Hung * on configuration must be larger than the speed multiplied by the minimum size 1515263b4c97823295c41900210515d0c769a236190cAndy Hung * {@link #getMinBufferSize(int, int, int)}) to allow proper playback. 15162d61e2b97c92ac2de80ebb3782b728ae5cdf5306Wei Jia * @param params see {@link PlaybackParams}. In particular, 1517263b4c97823295c41900210515d0c769a236190cAndy Hung * speed, pitch, and audio mode should be set. 15185f68c7a3f8400bcef233bf02d9a722f6d21f5c34Glenn Kasten * @throws IllegalArgumentException if the parameters are invalid or not accepted. 1519263b4c97823295c41900210515d0c769a236190cAndy Hung * @throws IllegalStateException if track is not initialized. 1520263b4c97823295c41900210515d0c769a236190cAndy Hung */ 15212d61e2b97c92ac2de80ebb3782b728ae5cdf5306Wei Jia public void setPlaybackParams(@NonNull PlaybackParams params) { 15222d61e2b97c92ac2de80ebb3782b728ae5cdf5306Wei Jia if (params == null) { 15232d61e2b97c92ac2de80ebb3782b728ae5cdf5306Wei Jia throw new IllegalArgumentException("params is null"); 1524263b4c97823295c41900210515d0c769a236190cAndy Hung } 15252d61e2b97c92ac2de80ebb3782b728ae5cdf5306Wei Jia native_set_playback_params(params); 1526263b4c97823295c41900210515d0c769a236190cAndy Hung } 1527263b4c97823295c41900210515d0c769a236190cAndy Hung 1528263b4c97823295c41900210515d0c769a236190cAndy Hung 1529263b4c97823295c41900210515d0c769a236190cAndy Hung /** 1530e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * Sets the position of the notification marker. At most one marker can be active. 1531e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * @param markerInFrames marker position in wrapping frame units similar to 1532e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * {@link #getPlaybackHeadPosition}, or zero to disable the marker. 1533e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * To set a marker at a position which would appear as zero due to wraparound, 1534e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * a workaround is to use a non-zero position near zero, such as -1 or 1. 15359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return error code or success, see {@link #SUCCESS}, {@link #ERROR_BAD_VALUE}, 15369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #ERROR_INVALID_OPERATION} 15379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 15389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int setNotificationMarkerPosition(int markerInFrames) { 15393b4df62704a6184878afd9272830cf3db7bd2d66Glenn Kasten if (mState == STATE_UNINITIALIZED) { 15409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return ERROR_INVALID_OPERATION; 15419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return native_set_marker_pos(markerInFrames); 15439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 15459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 15469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1547ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * Sets the period for the periodic notification event. 1548ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * @param periodInFrames update period expressed in frames. 1549ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * Zero period means no position updates. A negative period is not allowed. 15509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return error code or success, see {@link #SUCCESS}, {@link #ERROR_INVALID_OPERATION} 15519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 15529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int setPositionNotificationPeriod(int periodInFrames) { 15533b4df62704a6184878afd9272830cf3db7bd2d66Glenn Kasten if (mState == STATE_UNINITIALIZED) { 15549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return ERROR_INVALID_OPERATION; 15559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return native_set_pos_update_period(periodInFrames); 15579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 15599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 15609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1561ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * Sets the playback head position within the static buffer. 1562a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten * The track must be stopped or paused for the position to be changed, 1563a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten * and must use the {@link #MODE_STATIC} mode. 1564ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * @param positionInFrames playback head position within buffer, expressed in frames. 1565e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * Zero corresponds to start of buffer. 1566e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * The position must not be greater than the buffer size in frames, or negative. 1567ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * Though this method and {@link #getPlaybackHeadPosition()} have similar names, 1568ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * the position values have different meanings. 1569ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * <br> 1570ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * If looping is currently enabled and the new position is greater than or equal to the 157135e576e79292122fad462ebccd8520822552a6d7Andy Hung * loop end marker, the behavior varies by API level: 15720e3de6cacaffcfeda4d6353be61e2f1f9ed80705Dianne Hackborn * as of {@link android.os.Build.VERSION_CODES#M}, 1573ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * the looping is first disabled and then the position is set. 1574ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * For earlier API levels, the behavior is unspecified. 15759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return error code or success, see {@link #SUCCESS}, {@link #ERROR_BAD_VALUE}, 15769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #ERROR_INVALID_OPERATION} 15779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 15789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int setPlaybackHeadPosition(int positionInFrames) { 157978bfa6322bf34e49d5e4426296c701a64f705e49Andy Hung if (mDataLoadMode == MODE_STREAM || mState == STATE_UNINITIALIZED || 1580a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten getPlayState() == PLAYSTATE_PLAYING) { 1581a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten return ERROR_INVALID_OPERATION; 15829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1583e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten if (!(0 <= positionInFrames && positionInFrames <= mNativeBufferSizeInFrames)) { 1584e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten return ERROR_BAD_VALUE; 1585e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten } 1586a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten return native_set_position(positionInFrames); 15879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 15899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 15909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets the loop points and the loop count. The loop can be infinite. 1591a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten * Similarly to setPlaybackHeadPosition, 1592e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * the track must be stopped or paused for the loop points to be changed, 1593a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten * and must use the {@link #MODE_STATIC} mode. 1594ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * @param startInFrames loop start marker expressed in frames. 1595e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * Zero corresponds to start of buffer. 1596e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * The start marker must not be greater than or equal to the buffer size in frames, or negative. 1597ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * @param endInFrames loop end marker expressed in frames. 1598e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * The total buffer size in frames corresponds to end of buffer. 1599e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * The end marker must not be greater than the buffer size in frames. 1600e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * For looping, the end marker must not be less than or equal to the start marker, 1601e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * but to disable looping 1602e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * it is permitted for start marker, end marker, and loop count to all be 0. 1603ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * If any input parameters are out of range, this method returns {@link #ERROR_BAD_VALUE}. 1604ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * If the loop period (endInFrames - startInFrames) is too small for the implementation to 1605ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * support, 1606ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * {@link #ERROR_BAD_VALUE} is returned. 1607ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * The loop range is the interval [startInFrames, endInFrames). 1608ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * <br> 16090e3de6cacaffcfeda4d6353be61e2f1f9ed80705Dianne Hackborn * As of {@link android.os.Build.VERSION_CODES#M}, the position is left unchanged, 1610ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * unless it is greater than or equal to the loop end marker, in which case 1611ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * it is forced to the loop start marker. 1612ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * For earlier API levels, the effect on position is unspecified. 1613ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * @param loopCount the number of times the loop is looped; must be greater than or equal to -1. 1614e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * A value of -1 means infinite looping, and 0 disables looping. 1615ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * A value of positive N means to "loop" (go back) N times. For example, 1616ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * a value of one means to play the region two times in total. 16179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return error code or success, see {@link #SUCCESS}, {@link #ERROR_BAD_VALUE}, 16189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #ERROR_INVALID_OPERATION} 16199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 16209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int setLoopPoints(int startInFrames, int endInFrames, int loopCount) { 162178bfa6322bf34e49d5e4426296c701a64f705e49Andy Hung if (mDataLoadMode == MODE_STREAM || mState == STATE_UNINITIALIZED || 1622a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten getPlayState() == PLAYSTATE_PLAYING) { 16239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return ERROR_INVALID_OPERATION; 16249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1625e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten if (loopCount == 0) { 1626e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten ; // explicitly allowed as an exception to the loop region range check 1627e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten } else if (!(0 <= startInFrames && startInFrames < mNativeBufferSizeInFrames && 1628e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten startInFrames < endInFrames && endInFrames <= mNativeBufferSizeInFrames)) { 1629e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten return ERROR_BAD_VALUE; 1630e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten } 16319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return native_set_loop(startInFrames, endInFrames, loopCount); 16329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 16339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 16349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 163555a3218f242a611afb3569d88970c0c5dbf8ce54Glenn Kasten * Sets the initialization state of the instance. This method was originally intended to be used 163655a3218f242a611afb3569d88970c0c5dbf8ce54Glenn Kasten * in an AudioTrack subclass constructor to set a subclass-specific post-initialization state. 163755a3218f242a611afb3569d88970c0c5dbf8ce54Glenn Kasten * However, subclasses of AudioTrack are no longer recommended, so this method is obsolete. 16389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param state the state of the AudioTrack instance 163955a3218f242a611afb3569d88970c0c5dbf8ce54Glenn Kasten * @deprecated Only accessible by subclasses, which are not recommended for AudioTrack. 16409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 164155a3218f242a611afb3569d88970c0c5dbf8ce54Glenn Kasten @Deprecated 16429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project protected void setState(int state) { 16439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mState = state; 16449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 16459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 16469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 16479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //--------------------------------------------------------- 16489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Transport control methods 16499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //-------------------- 16509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 16519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Starts playing an AudioTrack. 1652659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * <p> 1653ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * If track's creation mode is {@link #MODE_STATIC}, you must have called one of 1654659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * the write methods ({@link #write(byte[], int, int)}, {@link #write(byte[], int, int, int)}, 1655659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * {@link #write(short[], int, int)}, {@link #write(short[], int, int, int)}, 1656659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * {@link #write(float[], int, int, int)}, or {@link #write(ByteBuffer, int, int)}) prior to 1657659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * play(). 1658659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * <p> 1659659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * If the mode is {@link #MODE_STREAM}, you can optionally prime the data path prior to 1660659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * calling play(), by writing up to <code>bufferSizeInBytes</code> (from constructor). 1661e90a0a88f4eabdc27c3ef033f38c91ea23362a1eAndy Hung * If you don't call write() first, or if you call write() but with an insufficient amount of 1662659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * data, then the track will be in underrun state at play(). In this case, 1663659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * playback will not actually start playing until the data path is filled to a 1664659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * device-specific minimum level. This requirement for the path to be filled 1665659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * to a minimum level is also true when resuming audio playback after calling stop(). 1666659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * Similarly the buffer will need to be filled up again after 1667659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * the track underruns due to failure to call write() in a timely manner with sufficient data. 1668659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * For portability, an application should prime the data path to the maximum allowed 1669659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * by writing data until the write() method returns a short transfer count. 1670659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * This allows play() to start immediately, and reduces the chance of underrun. 167188bde0ce3799c47530ea42ae3665bfa12ae38d11Narayan Kamath * 1672659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * @throws IllegalStateException if the track isn't properly initialized 16739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 16749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void play() 16759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throws IllegalStateException { 16769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mState != STATE_INITIALIZED) { 1677f4e58051e22ad4e21c7cd436c37cc5665c194d1cGlenn Kasten throw new IllegalStateException("play() called on uninitialized AudioTrack."); 16789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 16791af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlock if (isRestricted()) { 16801af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlock setVolume(0); 16811af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlock } 16829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project synchronized(mPlayStateLock) { 16839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project native_start(); 16849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mPlayState = PLAYSTATE_PLAYING; 16859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 16869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 16879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 16881af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlock private boolean isRestricted() { 1689d3969546a8bc4efe1e5e8a72bee07105055d18c2Jean-Michel Trivi if ((mAttributes.getAllFlags() & AudioAttributes.FLAG_BYPASS_INTERRUPTION_POLICY) != 0) { 1690bbfd31a5d4f126167e20fa8bd256c810cf8c2c85John Spurlock return false; 1691bbfd31a5d4f126167e20fa8bd256c810cf8c2c85John Spurlock } 16921af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlock try { 16937b41467704f941b11af6aace3e40993afc7f6c6fJohn Spurlock final int usage = AudioAttributes.usageForLegacyStreamType(mStreamType); 16947b41467704f941b11af6aace3e40993afc7f6c6fJohn Spurlock final int mode = mAppOps.checkAudioOperation(AppOpsManager.OP_PLAY_AUDIO, usage, 16951af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlock Process.myUid(), ActivityThread.currentPackageName()); 16961af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlock return mode != AppOpsManager.MODE_ALLOWED; 16971af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlock } catch (RemoteException e) { 16981af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlock return false; 16991af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlock } 17001af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlock } 17011af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlock 17029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 17039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Stops playing the audio data. 1704a701da8ebabb3d63ac57b7718055698abb21804aJean-Michel Trivi * When used on an instance created in {@link #MODE_STREAM} mode, audio will stop playing 1705a701da8ebabb3d63ac57b7718055698abb21804aJean-Michel Trivi * after the last buffer that was written has been played. For an immediate stop, use 1706a701da8ebabb3d63ac57b7718055698abb21804aJean-Michel Trivi * {@link #pause()}, followed by {@link #flush()} to discard audio data that hasn't been played 1707a701da8ebabb3d63ac57b7718055698abb21804aJean-Michel Trivi * back yet. 17089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws IllegalStateException 17099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 17109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void stop() 17119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throws IllegalStateException { 17129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mState != STATE_INITIALIZED) { 1713f4e58051e22ad4e21c7cd436c37cc5665c194d1cGlenn Kasten throw new IllegalStateException("stop() called on uninitialized AudioTrack."); 17149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 17159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 17169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // stop playing 17179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project synchronized(mPlayStateLock) { 17189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project native_stop(); 17199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mPlayState = PLAYSTATE_STOPPED; 1720cfe964a09ca05778e5dd84f2fd24119b89401696Rachad mAvSyncHeader = null; 1721cfe964a09ca05778e5dd84f2fd24119b89401696Rachad mAvSyncBytesRemaining = 0; 17229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 17239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 17249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 17259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 172688bde0ce3799c47530ea42ae3665bfa12ae38d11Narayan Kamath * Pauses the playback of the audio data. Data that has not been played 172788bde0ce3799c47530ea42ae3665bfa12ae38d11Narayan Kamath * back will not be discarded. Subsequent calls to {@link #play} will play 1728a701da8ebabb3d63ac57b7718055698abb21804aJean-Michel Trivi * this data back. See {@link #flush()} to discard this data. 172988bde0ce3799c47530ea42ae3665bfa12ae38d11Narayan Kamath * 17309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws IllegalStateException 17319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 17329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void pause() 17339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throws IllegalStateException { 17349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mState != STATE_INITIALIZED) { 1735f4e58051e22ad4e21c7cd436c37cc5665c194d1cGlenn Kasten throw new IllegalStateException("pause() called on uninitialized AudioTrack."); 17369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 17379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //logd("pause()"); 17389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 17399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // pause playback 17409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project synchronized(mPlayStateLock) { 17419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project native_pause(); 17429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mPlayState = PLAYSTATE_PAUSED; 17439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 17449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 17459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 17469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 17479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //--------------------------------------------------------- 17489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Audio data supply 17499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //-------------------- 17509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 17519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 175288bde0ce3799c47530ea42ae3665bfa12ae38d11Narayan Kamath * Flushes the audio data currently queued for playback. Any data that has 17537a121563d5c94ca0b88539afd8a7e86cc9118b60Glenn Kasten * been written but not yet presented will be discarded. No-op if not stopped or paused, 1754e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * or if the track's creation mode is not {@link #MODE_STREAM}. 17557a121563d5c94ca0b88539afd8a7e86cc9118b60Glenn Kasten * <BR> Note that although data written but not yet presented is discarded, there is no 17567a121563d5c94ca0b88539afd8a7e86cc9118b60Glenn Kasten * guarantee that all of the buffer space formerly used by that data 17577a121563d5c94ca0b88539afd8a7e86cc9118b60Glenn Kasten * is available for a subsequent write. 17587a121563d5c94ca0b88539afd8a7e86cc9118b60Glenn Kasten * For example, a call to {@link #write(byte[], int, int)} with <code>sizeInBytes</code> 17597a121563d5c94ca0b88539afd8a7e86cc9118b60Glenn Kasten * less than or equal to the total buffer size 17607a121563d5c94ca0b88539afd8a7e86cc9118b60Glenn Kasten * may return a short actual transfer count. 17619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 17629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void flush() { 17639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mState == STATE_INITIALIZED) { 17649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // flush the data in native layer 17659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project native_flush(); 1766cfe964a09ca05778e5dd84f2fd24119b89401696Rachad mAvSyncHeader = null; 1767cfe964a09ca05778e5dd84f2fd24119b89401696Rachad mAvSyncBytesRemaining = 0; 17689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 17699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 17709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 17719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 17729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1773e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * Writes the audio data to the audio sink for playback (streaming mode), 1774e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * or copies audio data for later playback (static buffer mode). 17754aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung * The format specified in the AudioTrack constructor should be 17764aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung * {@link AudioFormat#ENCODING_PCM_8BIT} to correspond to the data in the array. 1777659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * <p> 1778659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * In streaming mode, the write will normally block until all the data has been enqueued for 1779659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * playback, and will return a full transfer count. However, if the track is stopped or paused 1780659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * on entry, or another thread interrupts the write by calling stop or pause, or an I/O error 1781659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * occurs during the write, then the write may return a short transfer count. 1782659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * <p> 1783e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * In static buffer mode, copies the data to the buffer starting at offset 0. 1784659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * Note that the actual playback of this data might occur after this function returns. 178588bde0ce3799c47530ea42ae3665bfa12ae38d11Narayan Kamath * 17869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param audioData the array that holds the data to play. 1787679f1e26d03ebb5574ed389187f2ebc619832d52Glenn Kasten * @param offsetInBytes the offset expressed in bytes in audioData where the data to write 1788ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * starts. 1789679f1e26d03ebb5574ed389187f2ebc619832d52Glenn Kasten * @param sizeInBytes the number of bytes to write in audioData after the offset. 1790659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * @return zero or the positive number of bytes that were written, or 1791659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * {@link #ERROR_INVALID_OPERATION} 1792659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * if the track isn't properly initialized, or {@link #ERROR_BAD_VALUE} if 1793ff0d9f098e51c54e1a030ed21fd980680cb7b405Eric Laurent * the parameters don't resolve to valid data and indexes, or 1794ff0d9f098e51c54e1a030ed21fd980680cb7b405Eric Laurent * {@link AudioManager#ERROR_DEAD_OBJECT} if the AudioTrack is not valid anymore and 1795ff0d9f098e51c54e1a030ed21fd980680cb7b405Eric Laurent * needs to be recreated. 1796659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * The dead object error code is not returned if some data was successfully transferred. 1797659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * In this case, the error is returned at the next write(). 1798659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * 1799659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * This is equivalent to {@link #write(byte[], int, int, int)} with <code>writeMode</code> 1800659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * set to {@link #WRITE_BLOCKING}. 18019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 18024aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung public int write(@NonNull byte[] audioData, int offsetInBytes, int sizeInBytes) { 18034aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung return write(audioData, offsetInBytes, sizeInBytes, WRITE_BLOCKING); 18044aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung } 18059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 18064aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung /** 18074aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung * Writes the audio data to the audio sink for playback (streaming mode), 18084aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung * or copies audio data for later playback (static buffer mode). 18094aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung * The format specified in the AudioTrack constructor should be 18104aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung * {@link AudioFormat#ENCODING_PCM_8BIT} to correspond to the data in the array. 1811659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * <p> 1812659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * In streaming mode, the blocking behavior depends on the write mode. If the write mode is 1813659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * {@link #WRITE_BLOCKING}, the write will normally block until all the data has been enqueued 1814659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * for playback, and will return a full transfer count. However, if the write mode is 1815659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * {@link #WRITE_NON_BLOCKING}, or the track is stopped or paused on entry, or another thread 1816659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * interrupts the write by calling stop or pause, or an I/O error 1817659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * occurs during the write, then the write may return a short transfer count. 1818659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * <p> 1819659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * In static buffer mode, copies the data to the buffer starting at offset 0, 1820659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * and the write mode is ignored. 1821659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * Note that the actual playback of this data might occur after this function returns. 18224aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung * 18234aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung * @param audioData the array that holds the data to play. 1824679f1e26d03ebb5574ed389187f2ebc619832d52Glenn Kasten * @param offsetInBytes the offset expressed in bytes in audioData where the data to write 18254aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung * starts. 1826679f1e26d03ebb5574ed389187f2ebc619832d52Glenn Kasten * @param sizeInBytes the number of bytes to write in audioData after the offset. 18274aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung * @param writeMode one of {@link #WRITE_BLOCKING}, {@link #WRITE_NON_BLOCKING}. It has no 18284aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung * effect in static mode. 18294aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung * <br>With {@link #WRITE_BLOCKING}, the write will block until all data has been written 18304aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung * to the audio sink. 18314aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung * <br>With {@link #WRITE_NON_BLOCKING}, the write will return immediately after 18324aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung * queuing as much audio data for playback as possible without blocking. 1833659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * @return zero or the positive number of bytes that were written, or 1834659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * {@link #ERROR_INVALID_OPERATION} 1835659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * if the track isn't properly initialized, or {@link #ERROR_BAD_VALUE} if 18364aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung * the parameters don't resolve to valid data and indexes, or 18374aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung * {@link AudioManager#ERROR_DEAD_OBJECT} if the AudioTrack is not valid anymore and 18384aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung * needs to be recreated. 1839659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * The dead object error code is not returned if some data was successfully transferred. 1840659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * In this case, the error is returned at the next write(). 18414aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung */ 18424aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung public int write(@NonNull byte[] audioData, int offsetInBytes, int sizeInBytes, 18434aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung @WriteMode int writeMode) { 18449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 184554955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten if (mState == STATE_UNINITIALIZED || mAudioFormat == AudioFormat.ENCODING_PCM_FLOAT) { 18469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return ERROR_INVALID_OPERATION; 18479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 18489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 18494aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung if ((writeMode != WRITE_BLOCKING) && (writeMode != WRITE_NON_BLOCKING)) { 18504aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung Log.e(TAG, "AudioTrack.write() called with invalid blocking mode"); 18514aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung return ERROR_BAD_VALUE; 18524aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung } 18534aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung 1854fb2ab9efc3805c81521afb9ff91a58ff5097a36eGlenn Kasten if ( (audioData == null) || (offsetInBytes < 0 ) || (sizeInBytes < 0) 1855a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten || (offsetInBytes + sizeInBytes < 0) // detect integer overflow 18569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project || (offsetInBytes + sizeInBytes > audioData.length)) { 18579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return ERROR_BAD_VALUE; 18589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 18599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 18607ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi int ret = native_write_byte(audioData, offsetInBytes, sizeInBytes, mAudioFormat, 18614aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung writeMode == WRITE_BLOCKING); 1862a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten 1863a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten if ((mDataLoadMode == MODE_STATIC) 1864a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten && (mState == STATE_NO_STATIC_DATA) 1865a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten && (ret > 0)) { 1866a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten // benign race with respect to other APIs that read mState 1867a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten mState = STATE_INITIALIZED; 1868a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten } 1869a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten 1870a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten return ret; 18719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 18729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 18739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1874e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * Writes the audio data to the audio sink for playback (streaming mode), 1875e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * or copies audio data for later playback (static buffer mode). 18764aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung * The format specified in the AudioTrack constructor should be 18774aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung * {@link AudioFormat#ENCODING_PCM_16BIT} to correspond to the data in the array. 1878659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * <p> 1879659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * In streaming mode, the write will normally block until all the data has been enqueued for 1880659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * playback, and will return a full transfer count. However, if the track is stopped or paused 1881659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * on entry, or another thread interrupts the write by calling stop or pause, or an I/O error 1882659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * occurs during the write, then the write may return a short transfer count. 1883659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * <p> 1884e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * In static buffer mode, copies the data to the buffer starting at offset 0. 1885659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * Note that the actual playback of this data might occur after this function returns. 188688bde0ce3799c47530ea42ae3665bfa12ae38d11Narayan Kamath * 18879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param audioData the array that holds the data to play. 1888ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * @param offsetInShorts the offset expressed in shorts in audioData where the data to play 1889ff14c25339da3f6cd86edd66ef42640e6d0c0787Jean-Michel Trivi * starts. 1890e8c82a37050e568f211d47951480b182a61d42b4Glenn Kasten * @param sizeInShorts the number of shorts to read in audioData after the offset. 1891659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * @return zero or the positive number of shorts that were written, or 1892659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * {@link #ERROR_INVALID_OPERATION} 1893659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * if the track isn't properly initialized, or {@link #ERROR_BAD_VALUE} if 1894136e006248e6416ee30d7af2e6de102d195b8fb6Jean-Michel Trivi * the parameters don't resolve to valid data and indexes, or 1895136e006248e6416ee30d7af2e6de102d195b8fb6Jean-Michel Trivi * {@link AudioManager#ERROR_DEAD_OBJECT} if the AudioTrack is not valid anymore and 1896136e006248e6416ee30d7af2e6de102d195b8fb6Jean-Michel Trivi * needs to be recreated. 1897659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * The dead object error code is not returned if some data was successfully transferred. 1898659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * In this case, the error is returned at the next write(). 1899659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * 1900659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * This is equivalent to {@link #write(short[], int, int, int)} with <code>writeMode</code> 1901659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * set to {@link #WRITE_BLOCKING}. 19029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 19034aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung public int write(@NonNull short[] audioData, int offsetInShorts, int sizeInShorts) { 19044aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung return write(audioData, offsetInShorts, sizeInShorts, WRITE_BLOCKING); 19054aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung } 19069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 19074aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung /** 19084aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung * Writes the audio data to the audio sink for playback (streaming mode), 19094aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung * or copies audio data for later playback (static buffer mode). 19104aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung * The format specified in the AudioTrack constructor should be 19114aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung * {@link AudioFormat#ENCODING_PCM_16BIT} to correspond to the data in the array. 1912659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * <p> 1913659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * In streaming mode, the blocking behavior depends on the write mode. If the write mode is 1914659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * {@link #WRITE_BLOCKING}, the write will normally block until all the data has been enqueued 1915659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * for playback, and will return a full transfer count. However, if the write mode is 1916659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * {@link #WRITE_NON_BLOCKING}, or the track is stopped or paused on entry, or another thread 1917659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * interrupts the write by calling stop or pause, or an I/O error 1918659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * occurs during the write, then the write may return a short transfer count. 1919659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * <p> 19204aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung * In static buffer mode, copies the data to the buffer starting at offset 0. 1921659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * Note that the actual playback of this data might occur after this function returns. 19224aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung * 1923679f1e26d03ebb5574ed389187f2ebc619832d52Glenn Kasten * @param audioData the array that holds the data to write. 1924679f1e26d03ebb5574ed389187f2ebc619832d52Glenn Kasten * @param offsetInShorts the offset expressed in shorts in audioData where the data to write 19254aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung * starts. 19264aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung * @param sizeInShorts the number of shorts to read in audioData after the offset. 19274aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung * @param writeMode one of {@link #WRITE_BLOCKING}, {@link #WRITE_NON_BLOCKING}. It has no 19284aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung * effect in static mode. 19294aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung * <br>With {@link #WRITE_BLOCKING}, the write will block until all data has been written 19304aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung * to the audio sink. 19314aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung * <br>With {@link #WRITE_NON_BLOCKING}, the write will return immediately after 19324aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung * queuing as much audio data for playback as possible without blocking. 1933659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * @return zero or the positive number of shorts that were written, or 1934659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * {@link #ERROR_INVALID_OPERATION} 1935659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * if the track isn't properly initialized, or {@link #ERROR_BAD_VALUE} if 19364aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung * the parameters don't resolve to valid data and indexes, or 19374aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung * {@link AudioManager#ERROR_DEAD_OBJECT} if the AudioTrack is not valid anymore and 19384aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung * needs to be recreated. 1939659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * The dead object error code is not returned if some data was successfully transferred. 1940659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * In this case, the error is returned at the next write(). 19414aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung */ 19424aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung public int write(@NonNull short[] audioData, int offsetInShorts, int sizeInShorts, 19434aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung @WriteMode int writeMode) { 1944fb2ab9efc3805c81521afb9ff91a58ff5097a36eGlenn Kasten 1945c56b8085919771b6f027dc64ed6a44915e392464Glenn Kasten if (mState == STATE_UNINITIALIZED || mAudioFormat == AudioFormat.ENCODING_PCM_FLOAT) { 19469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return ERROR_INVALID_OPERATION; 19479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 19489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 19494aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung if ((writeMode != WRITE_BLOCKING) && (writeMode != WRITE_NON_BLOCKING)) { 19504aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung Log.e(TAG, "AudioTrack.write() called with invalid blocking mode"); 19514aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung return ERROR_BAD_VALUE; 19524aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung } 19534aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung 1954fb2ab9efc3805c81521afb9ff91a58ff5097a36eGlenn Kasten if ( (audioData == null) || (offsetInShorts < 0 ) || (sizeInShorts < 0) 1955a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten || (offsetInShorts + sizeInShorts < 0) // detect integer overflow 19569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project || (offsetInShorts + sizeInShorts > audioData.length)) { 19579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return ERROR_BAD_VALUE; 19589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 19599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 19604aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung int ret = native_write_short(audioData, offsetInShorts, sizeInShorts, mAudioFormat, 19614aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung writeMode == WRITE_BLOCKING); 1962a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten 1963a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten if ((mDataLoadMode == MODE_STATIC) 1964a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten && (mState == STATE_NO_STATIC_DATA) 1965a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten && (ret > 0)) { 1966a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten // benign race with respect to other APIs that read mState 1967a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten mState = STATE_INITIALIZED; 1968a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten } 1969a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten 1970a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten return ret; 19719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 19729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 19739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 19747ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi * Writes the audio data to the audio sink for playback (streaming mode), 19757ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi * or copies audio data for later playback (static buffer mode). 19764aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung * The format specified in the AudioTrack constructor should be 19774aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung * {@link AudioFormat#ENCODING_PCM_FLOAT} to correspond to the data in the array. 197854955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten * <p> 1979659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * In streaming mode, the blocking behavior depends on the write mode. If the write mode is 1980659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * {@link #WRITE_BLOCKING}, the write will normally block until all the data has been enqueued 1981659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * for playback, and will return a full transfer count. However, if the write mode is 1982659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * {@link #WRITE_NON_BLOCKING}, or the track is stopped or paused on entry, or another thread 1983659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * interrupts the write by calling stop or pause, or an I/O error 1984659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * occurs during the write, then the write may return a short transfer count. 198554955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten * <p> 1986659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * In static buffer mode, copies the data to the buffer starting at offset 0, 1987659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * and the write mode is ignored. 1988659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * Note that the actual playback of this data might occur after this function returns. 1989659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * 1990679f1e26d03ebb5574ed389187f2ebc619832d52Glenn Kasten * @param audioData the array that holds the data to write. 199154955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten * The implementation does not clip for sample values within the nominal range 199254955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten * [-1.0f, 1.0f], provided that all gains in the audio pipeline are 199354955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten * less than or equal to unity (1.0f), and in the absence of post-processing effects 199454955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten * that could add energy, such as reverb. For the convenience of applications 199554955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten * that compute samples using filters with non-unity gain, 199654955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten * sample values +3 dB beyond the nominal range are permitted. 199754955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten * However such values may eventually be limited or clipped, depending on various gains 199854955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten * and later processing in the audio path. Therefore applications are encouraged 199954955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten * to provide samples values within the nominal range. 200054955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten * @param offsetInFloats the offset, expressed as a number of floats, 2001679f1e26d03ebb5574ed389187f2ebc619832d52Glenn Kasten * in audioData where the data to write starts. 2002679f1e26d03ebb5574ed389187f2ebc619832d52Glenn Kasten * @param sizeInFloats the number of floats to write in audioData after the offset. 200354955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten * @param writeMode one of {@link #WRITE_BLOCKING}, {@link #WRITE_NON_BLOCKING}. It has no 200454955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten * effect in static mode. 20054aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung * <br>With {@link #WRITE_BLOCKING}, the write will block until all data has been written 200654955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten * to the audio sink. 20074aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung * <br>With {@link #WRITE_NON_BLOCKING}, the write will return immediately after 200854955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten * queuing as much audio data for playback as possible without blocking. 2009659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * @return zero or the positive number of floats that were written, or 2010659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * {@link #ERROR_INVALID_OPERATION} 2011659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * if the track isn't properly initialized, or {@link #ERROR_BAD_VALUE} if 2012136e006248e6416ee30d7af2e6de102d195b8fb6Jean-Michel Trivi * the parameters don't resolve to valid data and indexes, or 2013136e006248e6416ee30d7af2e6de102d195b8fb6Jean-Michel Trivi * {@link AudioManager#ERROR_DEAD_OBJECT} if the AudioTrack is not valid anymore and 2014136e006248e6416ee30d7af2e6de102d195b8fb6Jean-Michel Trivi * needs to be recreated. 2015659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * The dead object error code is not returned if some data was successfully transferred. 2016659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * In this case, the error is returned at the next write(). 201754955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten */ 20184aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung public int write(@NonNull float[] audioData, int offsetInFloats, int sizeInFloats, 201954955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten @WriteMode int writeMode) { 202054955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten 202154955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten if (mState == STATE_UNINITIALIZED) { 202254955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten Log.e(TAG, "AudioTrack.write() called in invalid state STATE_UNINITIALIZED"); 202354955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten return ERROR_INVALID_OPERATION; 202454955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten } 202554955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten 202654955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten if (mAudioFormat != AudioFormat.ENCODING_PCM_FLOAT) { 202754955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten Log.e(TAG, "AudioTrack.write(float[] ...) requires format ENCODING_PCM_FLOAT"); 202854955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten return ERROR_INVALID_OPERATION; 202954955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten } 203054955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten 203154955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten if ((writeMode != WRITE_BLOCKING) && (writeMode != WRITE_NON_BLOCKING)) { 203254955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten Log.e(TAG, "AudioTrack.write() called with invalid blocking mode"); 203354955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten return ERROR_BAD_VALUE; 203454955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten } 203554955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten 203654955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten if ( (audioData == null) || (offsetInFloats < 0 ) || (sizeInFloats < 0) 203754955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten || (offsetInFloats + sizeInFloats < 0) // detect integer overflow 203854955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten || (offsetInFloats + sizeInFloats > audioData.length)) { 203954955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten Log.e(TAG, "AudioTrack.write() called with invalid array, offset, or size"); 204054955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten return ERROR_BAD_VALUE; 204154955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten } 204254955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten 204354955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten int ret = native_write_float(audioData, offsetInFloats, sizeInFloats, mAudioFormat, 204454955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten writeMode == WRITE_BLOCKING); 204554955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten 204654955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten if ((mDataLoadMode == MODE_STATIC) 204754955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten && (mState == STATE_NO_STATIC_DATA) 204854955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten && (ret > 0)) { 204954955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten // benign race with respect to other APIs that read mState 205054955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten mState = STATE_INITIALIZED; 205154955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten } 205254955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten 205354955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten return ret; 205454955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten } 205554955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten 205654955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten 205754955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten /** 205854955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten * Writes the audio data to the audio sink for playback (streaming mode), 205954955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten * or copies audio data for later playback (static buffer mode). 2060659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * The audioData in ByteBuffer should match the format specified in the AudioTrack constructor. 2061659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * <p> 2062659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * In streaming mode, the blocking behavior depends on the write mode. If the write mode is 2063659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * {@link #WRITE_BLOCKING}, the write will normally block until all the data has been enqueued 2064659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * for playback, and will return a full transfer count. However, if the write mode is 2065659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * {@link #WRITE_NON_BLOCKING}, or the track is stopped or paused on entry, or another thread 2066659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * interrupts the write by calling stop or pause, or an I/O error 2067659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * occurs during the write, then the write may return a short transfer count. 2068659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * <p> 2069659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * In static buffer mode, copies the data to the buffer starting at offset 0, 2070659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * and the write mode is ignored. 2071659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * Note that the actual playback of this data might occur after this function returns. 2072659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * 2073679f1e26d03ebb5574ed389187f2ebc619832d52Glenn Kasten * @param audioData the buffer that holds the data to write, starting at the position reported 20747ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi * by <code>audioData.position()</code>. 20755d21f679c58dbb13c8c931ffec6e06b6b8cd454fJean-Michel Trivi * <BR>Note that upon return, the buffer position (<code>audioData.position()</code>) will 20765d21f679c58dbb13c8c931ffec6e06b6b8cd454fJean-Michel Trivi * have been advanced to reflect the amount of data that was successfully written to 20775d21f679c58dbb13c8c931ffec6e06b6b8cd454fJean-Michel Trivi * the AudioTrack. 20785d21f679c58dbb13c8c931ffec6e06b6b8cd454fJean-Michel Trivi * @param sizeInBytes number of bytes to write. 20795d21f679c58dbb13c8c931ffec6e06b6b8cd454fJean-Michel Trivi * <BR>Note this may differ from <code>audioData.remaining()</code>, but cannot exceed it. 20807ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi * @param writeMode one of {@link #WRITE_BLOCKING}, {@link #WRITE_NON_BLOCKING}. It has no 20817ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi * effect in static mode. 20827ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi * <BR>With {@link #WRITE_BLOCKING}, the write will block until all data has been written 20837ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi * to the audio sink. 20847ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi * <BR>With {@link #WRITE_NON_BLOCKING}, the write will return immediately after 20857ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi * queuing as much audio data for playback as possible without blocking. 2086659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * @return zero or the positive number of bytes that were written, or 2087136e006248e6416ee30d7af2e6de102d195b8fb6Jean-Michel Trivi * {@link #ERROR_BAD_VALUE}, {@link #ERROR_INVALID_OPERATION}, or 2088136e006248e6416ee30d7af2e6de102d195b8fb6Jean-Michel Trivi * {@link AudioManager#ERROR_DEAD_OBJECT} if the AudioTrack is not valid anymore and 2089136e006248e6416ee30d7af2e6de102d195b8fb6Jean-Michel Trivi * needs to be recreated. 2090659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * The dead object error code is not returned if some data was successfully transferred. 2091659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * In this case, the error is returned at the next write(). 20927ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi */ 20934aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung public int write(@NonNull ByteBuffer audioData, int sizeInBytes, 20947ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi @WriteMode int writeMode) { 20957ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi 20967ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi if (mState == STATE_UNINITIALIZED) { 20977ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi Log.e(TAG, "AudioTrack.write() called in invalid state STATE_UNINITIALIZED"); 20987ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi return ERROR_INVALID_OPERATION; 20997ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi } 21007ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi 21017ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi if ((writeMode != WRITE_BLOCKING) && (writeMode != WRITE_NON_BLOCKING)) { 21027ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi Log.e(TAG, "AudioTrack.write() called with invalid blocking mode"); 21037ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi return ERROR_BAD_VALUE; 21047ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi } 21057ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi 21065d21f679c58dbb13c8c931ffec6e06b6b8cd454fJean-Michel Trivi if ( (audioData == null) || (sizeInBytes < 0) || (sizeInBytes > audioData.remaining())) { 21075d21f679c58dbb13c8c931ffec6e06b6b8cd454fJean-Michel Trivi Log.e(TAG, "AudioTrack.write() called with invalid size (" + sizeInBytes + ") value"); 21087ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi return ERROR_BAD_VALUE; 21097ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi } 21107ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi 21117ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi int ret = 0; 21127ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi if (audioData.isDirect()) { 21137ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi ret = native_write_native_bytes(audioData, 21145d21f679c58dbb13c8c931ffec6e06b6b8cd454fJean-Michel Trivi audioData.position(), sizeInBytes, mAudioFormat, 21157ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi writeMode == WRITE_BLOCKING); 21167ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi } else { 21177ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi ret = native_write_byte(NioUtils.unsafeArray(audioData), 21185d21f679c58dbb13c8c931ffec6e06b6b8cd454fJean-Michel Trivi NioUtils.unsafeArrayOffset(audioData) + audioData.position(), 21197ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi sizeInBytes, mAudioFormat, 21207ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi writeMode == WRITE_BLOCKING); 21217ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi } 21227ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi 21237ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi if ((mDataLoadMode == MODE_STATIC) 21247ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi && (mState == STATE_NO_STATIC_DATA) 21257ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi && (ret > 0)) { 21267ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi // benign race with respect to other APIs that read mState 21277ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi mState = STATE_INITIALIZED; 21287ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi } 21297ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi 21305d21f679c58dbb13c8c931ffec6e06b6b8cd454fJean-Michel Trivi if (ret > 0) { 21315d21f679c58dbb13c8c931ffec6e06b6b8cd454fJean-Michel Trivi audioData.position(audioData.position() + ret); 21325d21f679c58dbb13c8c931ffec6e06b6b8cd454fJean-Michel Trivi } 21335d21f679c58dbb13c8c931ffec6e06b6b8cd454fJean-Michel Trivi 21347ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi return ret; 21357ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi } 21367ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi 21377ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi /** 2138659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * Writes the audio data to the audio sink for playback in streaming mode on a HW_AV_SYNC track. 2139659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * The blocking behavior will depend on the write mode. 2140679f1e26d03ebb5574ed389187f2ebc619832d52Glenn Kasten * @param audioData the buffer that holds the data to write, starting at the position reported 2141cfe964a09ca05778e5dd84f2fd24119b89401696Rachad * by <code>audioData.position()</code>. 2142cfe964a09ca05778e5dd84f2fd24119b89401696Rachad * <BR>Note that upon return, the buffer position (<code>audioData.position()</code>) will 2143cfe964a09ca05778e5dd84f2fd24119b89401696Rachad * have been advanced to reflect the amount of data that was successfully written to 2144cfe964a09ca05778e5dd84f2fd24119b89401696Rachad * the AudioTrack. 2145cfe964a09ca05778e5dd84f2fd24119b89401696Rachad * @param sizeInBytes number of bytes to write. 2146cfe964a09ca05778e5dd84f2fd24119b89401696Rachad * <BR>Note this may differ from <code>audioData.remaining()</code>, but cannot exceed it. 2147cfe964a09ca05778e5dd84f2fd24119b89401696Rachad * @param writeMode one of {@link #WRITE_BLOCKING}, {@link #WRITE_NON_BLOCKING}. 2148cfe964a09ca05778e5dd84f2fd24119b89401696Rachad * <BR>With {@link #WRITE_BLOCKING}, the write will block until all data has been written 2149cfe964a09ca05778e5dd84f2fd24119b89401696Rachad * to the audio sink. 2150cfe964a09ca05778e5dd84f2fd24119b89401696Rachad * <BR>With {@link #WRITE_NON_BLOCKING}, the write will return immediately after 2151cfe964a09ca05778e5dd84f2fd24119b89401696Rachad * queuing as much audio data for playback as possible without blocking. 2152cfe964a09ca05778e5dd84f2fd24119b89401696Rachad * @param timestamp The timestamp of the first decodable audio frame in the provided audioData. 2153659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * @return zero or a positive number of bytes that were written, or 2154cfe964a09ca05778e5dd84f2fd24119b89401696Rachad * {@link #ERROR_BAD_VALUE}, {@link #ERROR_INVALID_OPERATION}, or 2155cfe964a09ca05778e5dd84f2fd24119b89401696Rachad * {@link AudioManager#ERROR_DEAD_OBJECT} if the AudioTrack is not valid anymore and 2156cfe964a09ca05778e5dd84f2fd24119b89401696Rachad * needs to be recreated. 2157659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * The dead object error code is not returned if some data was successfully transferred. 2158659e31fb2933f16eefa6fb2d48da2622ea40b14aGlenn Kasten * In this case, the error is returned at the next write(). 2159cfe964a09ca05778e5dd84f2fd24119b89401696Rachad */ 216068d5ebd1da6bd4744314749d4fdbaf216414ea94Glenn Kasten public int write(@NonNull ByteBuffer audioData, int sizeInBytes, 2161cfe964a09ca05778e5dd84f2fd24119b89401696Rachad @WriteMode int writeMode, long timestamp) { 2162cfe964a09ca05778e5dd84f2fd24119b89401696Rachad 216368d5ebd1da6bd4744314749d4fdbaf216414ea94Glenn Kasten if (mState == STATE_UNINITIALIZED) { 216468d5ebd1da6bd4744314749d4fdbaf216414ea94Glenn Kasten Log.e(TAG, "AudioTrack.write() called in invalid state STATE_UNINITIALIZED"); 216568d5ebd1da6bd4744314749d4fdbaf216414ea94Glenn Kasten return ERROR_INVALID_OPERATION; 216668d5ebd1da6bd4744314749d4fdbaf216414ea94Glenn Kasten } 216768d5ebd1da6bd4744314749d4fdbaf216414ea94Glenn Kasten 216868d5ebd1da6bd4744314749d4fdbaf216414ea94Glenn Kasten if ((writeMode != WRITE_BLOCKING) && (writeMode != WRITE_NON_BLOCKING)) { 216968d5ebd1da6bd4744314749d4fdbaf216414ea94Glenn Kasten Log.e(TAG, "AudioTrack.write() called with invalid blocking mode"); 217068d5ebd1da6bd4744314749d4fdbaf216414ea94Glenn Kasten return ERROR_BAD_VALUE; 217168d5ebd1da6bd4744314749d4fdbaf216414ea94Glenn Kasten } 217268d5ebd1da6bd4744314749d4fdbaf216414ea94Glenn Kasten 217368d5ebd1da6bd4744314749d4fdbaf216414ea94Glenn Kasten if (mDataLoadMode != MODE_STREAM) { 217468d5ebd1da6bd4744314749d4fdbaf216414ea94Glenn Kasten Log.e(TAG, "AudioTrack.write() with timestamp called for non-streaming mode track"); 217568d5ebd1da6bd4744314749d4fdbaf216414ea94Glenn Kasten return ERROR_INVALID_OPERATION; 217668d5ebd1da6bd4744314749d4fdbaf216414ea94Glenn Kasten } 217768d5ebd1da6bd4744314749d4fdbaf216414ea94Glenn Kasten 2178cfe964a09ca05778e5dd84f2fd24119b89401696Rachad if ((mAttributes.getFlags() & AudioAttributes.FLAG_HW_AV_SYNC) == 0) { 2179cfe964a09ca05778e5dd84f2fd24119b89401696Rachad Log.d(TAG, "AudioTrack.write() called on a regular AudioTrack. Ignoring pts..."); 2180cfe964a09ca05778e5dd84f2fd24119b89401696Rachad return write(audioData, sizeInBytes, writeMode); 2181cfe964a09ca05778e5dd84f2fd24119b89401696Rachad } 2182cfe964a09ca05778e5dd84f2fd24119b89401696Rachad 2183cfe964a09ca05778e5dd84f2fd24119b89401696Rachad if ((audioData == null) || (sizeInBytes < 0) || (sizeInBytes > audioData.remaining())) { 2184cfe964a09ca05778e5dd84f2fd24119b89401696Rachad Log.e(TAG, "AudioTrack.write() called with invalid size (" + sizeInBytes + ") value"); 2185cfe964a09ca05778e5dd84f2fd24119b89401696Rachad return ERROR_BAD_VALUE; 2186cfe964a09ca05778e5dd84f2fd24119b89401696Rachad } 2187cfe964a09ca05778e5dd84f2fd24119b89401696Rachad 2188cfe964a09ca05778e5dd84f2fd24119b89401696Rachad // create timestamp header if none exists 2189cfe964a09ca05778e5dd84f2fd24119b89401696Rachad if (mAvSyncHeader == null) { 2190cfe964a09ca05778e5dd84f2fd24119b89401696Rachad mAvSyncHeader = ByteBuffer.allocate(16); 2191cfe964a09ca05778e5dd84f2fd24119b89401696Rachad mAvSyncHeader.order(ByteOrder.BIG_ENDIAN); 2192cfe964a09ca05778e5dd84f2fd24119b89401696Rachad mAvSyncHeader.putInt(0x55550001); 2193cfe964a09ca05778e5dd84f2fd24119b89401696Rachad mAvSyncHeader.putInt(sizeInBytes); 2194cfe964a09ca05778e5dd84f2fd24119b89401696Rachad mAvSyncHeader.putLong(timestamp); 2195cfe964a09ca05778e5dd84f2fd24119b89401696Rachad mAvSyncHeader.position(0); 2196cfe964a09ca05778e5dd84f2fd24119b89401696Rachad mAvSyncBytesRemaining = sizeInBytes; 2197cfe964a09ca05778e5dd84f2fd24119b89401696Rachad } 2198cfe964a09ca05778e5dd84f2fd24119b89401696Rachad 2199cfe964a09ca05778e5dd84f2fd24119b89401696Rachad // write timestamp header if not completely written already 2200cfe964a09ca05778e5dd84f2fd24119b89401696Rachad int ret = 0; 2201cfe964a09ca05778e5dd84f2fd24119b89401696Rachad if (mAvSyncHeader.remaining() != 0) { 2202cfe964a09ca05778e5dd84f2fd24119b89401696Rachad ret = write(mAvSyncHeader, mAvSyncHeader.remaining(), writeMode); 2203cfe964a09ca05778e5dd84f2fd24119b89401696Rachad if (ret < 0) { 2204cfe964a09ca05778e5dd84f2fd24119b89401696Rachad Log.e(TAG, "AudioTrack.write() could not write timestamp header!"); 2205cfe964a09ca05778e5dd84f2fd24119b89401696Rachad mAvSyncHeader = null; 2206cfe964a09ca05778e5dd84f2fd24119b89401696Rachad mAvSyncBytesRemaining = 0; 2207cfe964a09ca05778e5dd84f2fd24119b89401696Rachad return ret; 2208cfe964a09ca05778e5dd84f2fd24119b89401696Rachad } 2209cfe964a09ca05778e5dd84f2fd24119b89401696Rachad if (mAvSyncHeader.remaining() > 0) { 2210cfe964a09ca05778e5dd84f2fd24119b89401696Rachad Log.v(TAG, "AudioTrack.write() partial timestamp header written."); 2211cfe964a09ca05778e5dd84f2fd24119b89401696Rachad return 0; 2212cfe964a09ca05778e5dd84f2fd24119b89401696Rachad } 2213cfe964a09ca05778e5dd84f2fd24119b89401696Rachad } 2214cfe964a09ca05778e5dd84f2fd24119b89401696Rachad 2215cfe964a09ca05778e5dd84f2fd24119b89401696Rachad // write audio data 2216cfe964a09ca05778e5dd84f2fd24119b89401696Rachad int sizeToWrite = Math.min(mAvSyncBytesRemaining, sizeInBytes); 2217cfe964a09ca05778e5dd84f2fd24119b89401696Rachad ret = write(audioData, sizeToWrite, writeMode); 2218cfe964a09ca05778e5dd84f2fd24119b89401696Rachad if (ret < 0) { 2219cfe964a09ca05778e5dd84f2fd24119b89401696Rachad Log.e(TAG, "AudioTrack.write() could not write audio data!"); 2220cfe964a09ca05778e5dd84f2fd24119b89401696Rachad mAvSyncHeader = null; 2221cfe964a09ca05778e5dd84f2fd24119b89401696Rachad mAvSyncBytesRemaining = 0; 2222cfe964a09ca05778e5dd84f2fd24119b89401696Rachad return ret; 2223cfe964a09ca05778e5dd84f2fd24119b89401696Rachad } 2224cfe964a09ca05778e5dd84f2fd24119b89401696Rachad 2225cfe964a09ca05778e5dd84f2fd24119b89401696Rachad mAvSyncBytesRemaining -= ret; 2226cfe964a09ca05778e5dd84f2fd24119b89401696Rachad if (mAvSyncBytesRemaining == 0) { 2227cfe964a09ca05778e5dd84f2fd24119b89401696Rachad mAvSyncHeader = null; 2228cfe964a09ca05778e5dd84f2fd24119b89401696Rachad } 2229cfe964a09ca05778e5dd84f2fd24119b89401696Rachad 2230cfe964a09ca05778e5dd84f2fd24119b89401696Rachad return ret; 2231cfe964a09ca05778e5dd84f2fd24119b89401696Rachad } 2232cfe964a09ca05778e5dd84f2fd24119b89401696Rachad 2233cfe964a09ca05778e5dd84f2fd24119b89401696Rachad 2234cfe964a09ca05778e5dd84f2fd24119b89401696Rachad /** 2235ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * Sets the playback head position within the static buffer to zero, 2236ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * that is it rewinds to start of static buffer. 2237ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * The track must be stopped or paused, and 2238ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * the track's creation mode must be {@link #MODE_STATIC}. 2239ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * <p> 22400e3de6cacaffcfeda4d6353be61e2f1f9ed80705Dianne Hackborn * As of {@link android.os.Build.VERSION_CODES#M}, also resets the value returned by 2241ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * {@link #getPlaybackHeadPosition()} to zero. 2242ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * For earlier API levels, the reset behavior is unspecified. 2243ac322096d8c7b6198193d6140fc37073f7ccb2feGlenn Kasten * <p> 224435e576e79292122fad462ebccd8520822552a6d7Andy Hung * Use {@link #setPlaybackHeadPosition(int)} with a zero position 224535e576e79292122fad462ebccd8520822552a6d7Andy Hung * if the reset of <code>getPlaybackHeadPosition()</code> is not needed. 22469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return error code or success, see {@link #SUCCESS}, {@link #ERROR_BAD_VALUE}, 22479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #ERROR_INVALID_OPERATION} 22489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 22499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int reloadStaticData() { 2250a501b5b8d5ec0ccc975adbcf302f01a6979e81e1Glenn Kasten if (mDataLoadMode == MODE_STREAM || mState != STATE_INITIALIZED) { 22519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return ERROR_INVALID_OPERATION; 22529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 22539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return native_reload_static(); 22549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 22559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 22567070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent //-------------------------------------------------------------------------- 22577070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent // Audio effects management 22587070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent //-------------------- 22597070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent 22607070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent /** 22611a5149e5d7f2dddc8b324f7695e69fd89af73c52Eric Laurent * Attaches an auxiliary effect to the audio track. A typical auxiliary 22621a5149e5d7f2dddc8b324f7695e69fd89af73c52Eric Laurent * effect is a reverberation effect which can be applied on any sound source 22631a5149e5d7f2dddc8b324f7695e69fd89af73c52Eric Laurent * that directs a certain amount of its energy to this effect. This amount 22641a5149e5d7f2dddc8b324f7695e69fd89af73c52Eric Laurent * is defined by setAuxEffectSendLevel(). 22657070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent * {@see #setAuxEffectSendLevel(float)}. 22661a5149e5d7f2dddc8b324f7695e69fd89af73c52Eric Laurent * <p>After creating an auxiliary effect (e.g. 22671a5149e5d7f2dddc8b324f7695e69fd89af73c52Eric Laurent * {@link android.media.audiofx.EnvironmentalReverb}), retrieve its ID with 22681a5149e5d7f2dddc8b324f7695e69fd89af73c52Eric Laurent * {@link android.media.audiofx.AudioEffect#getId()} and use it when calling 22697070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent * this method to attach the audio track to the effect. 22701a5149e5d7f2dddc8b324f7695e69fd89af73c52Eric Laurent * <p>To detach the effect from the audio track, call this method with a 22711a5149e5d7f2dddc8b324f7695e69fd89af73c52Eric Laurent * null effect id. 22727070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent * 22737070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent * @param effectId system wide unique id of the effect to attach 22747070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent * @return error code or success, see {@link #SUCCESS}, 22757070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent * {@link #ERROR_INVALID_OPERATION}, {@link #ERROR_BAD_VALUE} 22767070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent */ 22777070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent public int attachAuxEffect(int effectId) { 22783b4df62704a6184878afd9272830cf3db7bd2d66Glenn Kasten if (mState == STATE_UNINITIALIZED) { 22797070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent return ERROR_INVALID_OPERATION; 22807070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent } 22817070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent return native_attachAuxEffect(effectId); 22827070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent } 22837070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent 22847070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent /** 22857070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent * Sets the send level of the audio track to the attached auxiliary effect 228678cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * {@link #attachAuxEffect(int)}. Effect levels 228778cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * are clamped to the closed interval [0.0, max] where 228878cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * max is the value of {@link #getMaxVolume}. 228978cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * A value of 0.0 results in no effect, and a value of 1.0 is full send. 2290e2a4b42c5b7f3475c1587f30d19afc12a190f009Glenn Kasten * <p>By default the send level is 0.0f, so even if an effect is attached to the player 22917070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent * this method must be called for the effect to be applied. 229278cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * <p>Note that the passed level value is a linear scalar. UI controls should be scaled 229378cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * logarithmically: the gain applied by audio framework ranges from -72dB to at least 0dB, 22947070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent * so an appropriate conversion from linear UI input x to level is: 22955c17a820f9e46e0756c11795b3e6f89105f2f539Glenn Kasten * x == 0 -> level = 0 22965c17a820f9e46e0756c11795b3e6f89105f2f539Glenn Kasten * 0 < x <= R -> level = 10^(72*(x-R)/20/R) 22977070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent * 229878cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten * @param level linear send level 22997070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent * @return error code or success, see {@link #SUCCESS}, 23003009f0b911e39d3b26c69bd7667d6444eacb9d11Glenn Kasten * {@link #ERROR_INVALID_OPERATION}, {@link #ERROR} 23017070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent */ 23027070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent public int setAuxEffectSendLevel(float level) { 23031af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlock if (isRestricted()) { 23041af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlock return SUCCESS; 23051af30c7ac480e5d335f267a3ac3b2e6c748ce240John Spurlock } 23063b4df62704a6184878afd9272830cf3db7bd2d66Glenn Kasten if (mState == STATE_UNINITIALIZED) { 23077070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent return ERROR_INVALID_OPERATION; 23087070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent } 230978cbd451fd568e8fcc6fcc7c4f875428189aa8b8Glenn Kasten level = clampGainOrLevel(level); 23103009f0b911e39d3b26c69bd7667d6444eacb9d11Glenn Kasten int err = native_setAuxEffectSendLevel(level); 23113009f0b911e39d3b26c69bd7667d6444eacb9d11Glenn Kasten return err == 0 ? SUCCESS : ERROR; 23127070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent } 23139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 231488e1d86a879d8802e775dd0566ffb64425e8e3c8Paul McLean //-------------------------------------------------------------------------- 231588e1d86a879d8802e775dd0566ffb64425e8e3c8Paul McLean // Explicit Routing 231688e1d86a879d8802e775dd0566ffb64425e8e3c8Paul McLean //-------------------- 231788e1d86a879d8802e775dd0566ffb64425e8e3c8Paul McLean private AudioDeviceInfo mPreferredDevice = null; 231888e1d86a879d8802e775dd0566ffb64425e8e3c8Paul McLean 231988e1d86a879d8802e775dd0566ffb64425e8e3c8Paul McLean /** 23202d6de4c38c899707e0596b7fa4dad9bbb3eb6b60Paul McLean * Specifies an audio device (via an {@link AudioDeviceInfo} object) to route 232188e1d86a879d8802e775dd0566ffb64425e8e3c8Paul McLean * the output from this AudioTrack. 23229e29086d5df800532e736d8f31e2b9159b102524Glenn Kasten * @param deviceInfo The {@link AudioDeviceInfo} specifying the audio sink. 23239e29086d5df800532e736d8f31e2b9159b102524Glenn Kasten * If deviceInfo is null, default routing is restored. 232488e1d86a879d8802e775dd0566ffb64425e8e3c8Paul McLean * @return true if succesful, false if the specified {@link AudioDeviceInfo} is non-null and 232588e1d86a879d8802e775dd0566ffb64425e8e3c8Paul McLean * does not correspond to a valid audio output device. 232688e1d86a879d8802e775dd0566ffb64425e8e3c8Paul McLean */ 2327e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean public boolean setPreferredDevice(AudioDeviceInfo deviceInfo) { 232888e1d86a879d8802e775dd0566ffb64425e8e3c8Paul McLean // Do some validation.... 23292d6de4c38c899707e0596b7fa4dad9bbb3eb6b60Paul McLean if (deviceInfo != null && !deviceInfo.isSink()) { 233088e1d86a879d8802e775dd0566ffb64425e8e3c8Paul McLean return false; 233188e1d86a879d8802e775dd0566ffb64425e8e3c8Paul McLean } 23324bcdba848449b33d7022de527c526943aff1f5fdEric Laurent int preferredDeviceId = deviceInfo != null ? deviceInfo.getId() : 0; 23334bcdba848449b33d7022de527c526943aff1f5fdEric Laurent boolean status = native_setOutputDevice(preferredDeviceId); 23344bcdba848449b33d7022de527c526943aff1f5fdEric Laurent if (status == true) { 23354bcdba848449b33d7022de527c526943aff1f5fdEric Laurent synchronized (this) { 23364bcdba848449b33d7022de527c526943aff1f5fdEric Laurent mPreferredDevice = deviceInfo; 23374bcdba848449b33d7022de527c526943aff1f5fdEric Laurent } 23384bcdba848449b33d7022de527c526943aff1f5fdEric Laurent } 23394bcdba848449b33d7022de527c526943aff1f5fdEric Laurent return status; 234088e1d86a879d8802e775dd0566ffb64425e8e3c8Paul McLean } 234188e1d86a879d8802e775dd0566ffb64425e8e3c8Paul McLean 234288e1d86a879d8802e775dd0566ffb64425e8e3c8Paul McLean /** 2343e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean * Returns the selected output specified by {@link #setPreferredDevice}. Note that this 23442d6de4c38c899707e0596b7fa4dad9bbb3eb6b60Paul McLean * is not guaranteed to correspond to the actual device being used for playback. 234588e1d86a879d8802e775dd0566ffb64425e8e3c8Paul McLean */ 2346e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean public AudioDeviceInfo getPreferredDevice() { 23474bcdba848449b33d7022de527c526943aff1f5fdEric Laurent synchronized (this) { 23484bcdba848449b33d7022de527c526943aff1f5fdEric Laurent return mPreferredDevice; 23494bcdba848449b33d7022de527c526943aff1f5fdEric Laurent } 235088e1d86a879d8802e775dd0566ffb64425e8e3c8Paul McLean } 235188e1d86a879d8802e775dd0566ffb64425e8e3c8Paul McLean 2352d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean /** 2353d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean * Returns an {@link AudioDeviceInfo} identifying the current routing of this AudioTrack. 23548e6c9f46172458624349755c9b1bc051f420d36dPaul McLean * Note: The query is only valid if the AudioTrack is currently playing. If it is not, 23558e6c9f46172458624349755c9b1bc051f420d36dPaul McLean * <code>getRoutedDevice()</code> will return null. 2356d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean */ 2357d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean public AudioDeviceInfo getRoutedDevice() { 23584bcdba848449b33d7022de527c526943aff1f5fdEric Laurent int deviceId = native_getRoutedDeviceId(); 23594bcdba848449b33d7022de527c526943aff1f5fdEric Laurent if (deviceId == 0) { 23604bcdba848449b33d7022de527c526943aff1f5fdEric Laurent return null; 23614bcdba848449b33d7022de527c526943aff1f5fdEric Laurent } 23624bcdba848449b33d7022de527c526943aff1f5fdEric Laurent AudioDeviceInfo[] devices = 2363e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean AudioManager.getDevicesStatic(AudioManager.GET_DEVICES_OUTPUTS); 23644bcdba848449b33d7022de527c526943aff1f5fdEric Laurent for (int i = 0; i < devices.length; i++) { 23654bcdba848449b33d7022de527c526943aff1f5fdEric Laurent if (devices[i].getId() == deviceId) { 23664bcdba848449b33d7022de527c526943aff1f5fdEric Laurent return devices[i]; 23674bcdba848449b33d7022de527c526943aff1f5fdEric Laurent } 23684bcdba848449b33d7022de527c526943aff1f5fdEric Laurent } 2369d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean return null; 2370d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean } 2371d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean 2372ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean /* 2373ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean * Call BEFORE adding a routing callback handler. 2374ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean */ 2375ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean private void testEnableNativeRoutingCallbacks() { 2376ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean if (mRoutingChangeListeners.size() == 0 && mNewRoutingChangeListeners.size() == 0) { 2377ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean native_enableDeviceCallback(); 2378ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean } 2379ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean } 2380ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean 2381ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean /* 2382ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean * Call AFTER removing a routing callback handler. 2383ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean */ 2384ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean private void testDisableNativeRoutingCallbacks() { 2385ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean if (mRoutingChangeListeners.size() == 0 && mNewRoutingChangeListeners.size() == 0) { 2386ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean native_disableDeviceCallback(); 2387ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean } 2388ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean } 2389ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean 2390ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean //-------------------------------------------------------------------------- 2391ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean // >= "N" (Re)Routing Info 2392ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean //-------------------- 2393ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean /** 2394ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean * The list of AudioRouting.OnRoutingChangedListener interfaces added (with 2395ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean * {@link AudioTrack#addOnRoutingListener(AudioRouting.OnRoutingChangedListener, 2396ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean * android.os.Handler)} 2397ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean * by an app to receive (re)routing notifications. 2398ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean */ 2399ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean private ArrayMap<AudioRouting.OnRoutingChangedListener, NativeNewRoutingEventHandlerDelegate> 2400ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean mNewRoutingChangeListeners = 2401ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean new ArrayMap<AudioRouting.OnRoutingChangedListener, NativeNewRoutingEventHandlerDelegate>(); 2402ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean 2403ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean /** 2404ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean * Adds an {@link AudioRouting.OnRoutingChangedListener} to receive notifications of routing 2405ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean * changes on this AudioTrack. 2406ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean * @param listener The {@link AudioRouting.OnRoutingChangedListener} interface to receive 2407ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean * notifications of rerouting events. 2408ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean * @param handler Specifies the {@link Handler} object for the thread on which to execute 2409ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean * the callback. If <code>null</code>, the {@link Handler} associated with the main 2410ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean * {@link Looper} will be used. 2411ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean */ 2412ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean public void addOnRoutingListener(AudioRouting.OnRoutingChangedListener listener, 2413ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean Handler handler) { 2414ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean if (listener != null && !mNewRoutingChangeListeners.containsKey(listener)) { 2415ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean synchronized (mNewRoutingChangeListeners) { 2416ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean testEnableNativeRoutingCallbacks(); 2417ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean mNewRoutingChangeListeners.put( 2418ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean listener, new NativeNewRoutingEventHandlerDelegate(this, listener, 2419ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean handler != null ? handler : new Handler(mInitializationLooper))); 2420ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean } 2421ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean } 2422ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean } 2423ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean 2424ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean /** 2425ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean * Removes an {@link AudioRouting.OnRoutingChangedListener} which has been previously added 2426ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean * to receive rerouting notifications. 2427ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean * @param listener The previously added {@link AudioRouting.OnRoutingChangedListener} interface 2428ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean * to remove. 2429ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean */ 2430ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean public void removeOnRoutingListener(AudioRouting.OnRoutingChangedListener listener) { 2431ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean if (mNewRoutingChangeListeners.containsKey(listener)) { 2432ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean mNewRoutingChangeListeners.remove(listener); 2433ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean } 2434ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean testDisableNativeRoutingCallbacks(); 2435ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean } 2436ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean 2437ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean //-------------------------------------------------------------------------- 2438ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean // Marshmallow (Re)Routing Info 2439ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean //-------------------- 2440ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean /** 2441ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean * Defines the interface by which applications can receive notifications of routing 2442ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean * changes for the associated {@link AudioTrack}. 2443ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean */ 2444ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean @Deprecated 2445ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean public interface OnRoutingChangedListener { 2446ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean /** 2447ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean * Called when the routing of an AudioTrack changes from either and explicit or 2448ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean * policy rerouting. Use {@link #getRoutedDevice()} to retrieve the newly routed-to 2449ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean * device. 2450ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean */ 2451ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean @Deprecated 2452ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean public void onRoutingChanged(AudioTrack audioTrack); 2453ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean } 2454ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean 2455d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean /** 24568e6c9f46172458624349755c9b1bc051f420d36dPaul McLean * The list of AudioTrack.OnRoutingChangedListener interfaces added (with 24578e6c9f46172458624349755c9b1bc051f420d36dPaul McLean * {@link AudioTrack#addOnRoutingChangedListener(OnRoutingChangedListener, android.os.Handler)} 24588e6c9f46172458624349755c9b1bc051f420d36dPaul McLean * by an app to receive (re)routing notifications. 2459d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean */ 2460e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean private ArrayMap<OnRoutingChangedListener, NativeRoutingEventHandlerDelegate> 2461d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean mRoutingChangeListeners = 2462e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean new ArrayMap<OnRoutingChangedListener, NativeRoutingEventHandlerDelegate>(); 2463d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean 2464d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean /** 2465e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean * Adds an {@link OnRoutingChangedListener} to receive notifications of routing changes 2466d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean * on this AudioTrack. 24678e6c9f46172458624349755c9b1bc051f420d36dPaul McLean * @param listener The {@link OnRoutingChangedListener} interface to receive notifications 24688e6c9f46172458624349755c9b1bc051f420d36dPaul McLean * of rerouting events. 24698e6c9f46172458624349755c9b1bc051f420d36dPaul McLean * @param handler Specifies the {@link Handler} object for the thread on which to execute 24708e6c9f46172458624349755c9b1bc051f420d36dPaul McLean * the callback. If <code>null</code>, the {@link Handler} associated with the main 24718e6c9f46172458624349755c9b1bc051f420d36dPaul McLean * {@link Looper} will be used. 2472d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean */ 2473ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean @Deprecated 2474e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean public void addOnRoutingChangedListener(OnRoutingChangedListener listener, 2475d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean android.os.Handler handler) { 2476d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean if (listener != null && !mRoutingChangeListeners.containsKey(listener)) { 2477d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean synchronized (mRoutingChangeListeners) { 2478ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean testEnableNativeRoutingCallbacks(); 2479d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean mRoutingChangeListeners.put( 24805be68ede1943354371233ed2511e308f83b77932Paul McLean listener, new NativeRoutingEventHandlerDelegate(this, listener, 24815be68ede1943354371233ed2511e308f83b77932Paul McLean handler != null ? handler : new Handler(mInitializationLooper))); 2482d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean } 2483d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean } 2484d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean } 2485d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean 2486d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean /** 2487e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean * Removes an {@link OnRoutingChangedListener} which has been previously added 24888e6c9f46172458624349755c9b1bc051f420d36dPaul McLean * to receive rerouting notifications. 24898e6c9f46172458624349755c9b1bc051f420d36dPaul McLean * @param listener The previously added {@link OnRoutingChangedListener} interface to remove. 2490d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean */ 2491ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean @Deprecated 2492e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean public void removeOnRoutingChangedListener(OnRoutingChangedListener listener) { 2493d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean synchronized (mRoutingChangeListeners) { 2494d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean if (mRoutingChangeListeners.containsKey(listener)) { 2495d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean mRoutingChangeListeners.remove(listener); 2496d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean } 2497ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean testDisableNativeRoutingCallbacks(); 2498d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean } 2499d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean } 2500d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean 2501d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean /** 2502d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean * Sends device list change notification to all listeners. 2503d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean */ 2504d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean private void broadcastRoutingChange() { 2505ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean AudioManager.resetAudioPortGeneration(); 2506ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean 2507ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean // Marshmallow Routing 2508d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean Collection<NativeRoutingEventHandlerDelegate> values; 2509d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean synchronized (mRoutingChangeListeners) { 2510d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean values = mRoutingChangeListeners.values(); 2511d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean } 2512d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean for(NativeRoutingEventHandlerDelegate delegate : values) { 2513d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean Handler handler = delegate.getHandler(); 2514d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean if (handler != null) { 25154bcdba848449b33d7022de527c526943aff1f5fdEric Laurent handler.sendEmptyMessage(AudioSystem.NATIVE_EVENT_ROUTING_CHANGE); 2516d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean } 2517d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean } 2518ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean // >= "N" Routing 2519ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean Collection<NativeNewRoutingEventHandlerDelegate> newValues; 2520ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean synchronized (mNewRoutingChangeListeners) { 2521ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean newValues = mNewRoutingChangeListeners.values(); 2522ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean } 2523ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean for(NativeNewRoutingEventHandlerDelegate delegate : newValues) { 2524ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean Handler handler = delegate.getHandler(); 2525ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean if (handler != null) { 2526ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean handler.sendEmptyMessage(AudioSystem.NATIVE_EVENT_ROUTING_CHANGE); 2527ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean } 2528ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean } 2529d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean } 2530d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean 25319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //--------------------------------------------------------- 25329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Interface definitions 25339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //-------------------- 25349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 25354df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project * Interface definition for a callback to be invoked when the playback head position of 25364df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project * an AudioTrack has reached a notification marker or has increased by a certain period. 25379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 25384df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project public interface OnPlaybackPositionUpdateListener { 25399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 25409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Called on the listener to notify it that the previously set marker has been reached 25419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * by the playback head. 25429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 25439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project void onMarkerReached(AudioTrack track); 2544fb2ab9efc3805c81521afb9ff91a58ff5097a36eGlenn Kasten 25459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 25469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Called on the listener to periodically notify it that the playback head has reached 25479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * a multiple of the notification period. 25489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 25499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project void onPeriodicNotification(AudioTrack track); 25509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 25519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 25529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //--------------------------------------------------------- 25539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Inner classes 25549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //-------------------- 25559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 25564df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project * Helper class to handle the forwarding of native events to the appropriate listener 25574df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project * (potentially) handled in a different thread 25585c17a820f9e46e0756c11795b3e6f89105f2f539Glenn Kasten */ 2559d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean private class NativePositionEventHandlerDelegate { 25604df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project private final Handler mHandler; 2561fb2ab9efc3805c81521afb9ff91a58ff5097a36eGlenn Kasten 2562d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean NativePositionEventHandlerDelegate(final AudioTrack track, 256395bd2329c6a36211f18be3e089eaa775ec62df62Glenn Kasten final OnPlaybackPositionUpdateListener listener, 256495bd2329c6a36211f18be3e089eaa775ec62df62Glenn Kasten Handler handler) { 25654df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project // find the looper for our new event handler 25664df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project Looper looper; 25674df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project if (handler != null) { 25684df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project looper = handler.getLooper(); 25694df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project } else { 2570105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project // no given handler, use the looper the AudioTrack was created in 2571105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project looper = mInitializationLooper; 25729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2573fb2ab9efc3805c81521afb9ff91a58ff5097a36eGlenn Kasten 25744df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project // construct the event handler with this looper 25754df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project if (looper != null) { 25764df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project // implement the event handler delegate 25774df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project mHandler = new Handler(looper) { 25784df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project @Override 25794df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project public void handleMessage(Message msg) { 258095bd2329c6a36211f18be3e089eaa775ec62df62Glenn Kasten if (track == null) { 25814df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project return; 25824df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project } 25834df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project switch(msg.what) { 25844df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project case NATIVE_EVENT_MARKER: 25854df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project if (listener != null) { 258695bd2329c6a36211f18be3e089eaa775ec62df62Glenn Kasten listener.onMarkerReached(track); 25874df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project } 25884df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project break; 25894df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project case NATIVE_EVENT_NEW_POS: 25904df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project if (listener != null) { 259195bd2329c6a36211f18be3e089eaa775ec62df62Glenn Kasten listener.onPeriodicNotification(track); 25924df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project } 25934df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project break; 25944df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project default: 25951f61d01508651b4475397414e1fe06af1ab8fadaGlenn Kasten loge("Unknown native event type: " + msg.what); 25964df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project break; 25974df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project } 25984df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project } 25994df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project }; 26004df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project } else { 26014df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project mHandler = null; 2602fb2ab9efc3805c81521afb9ff91a58ff5097a36eGlenn Kasten } 26034df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project } 2604fb2ab9efc3805c81521afb9ff91a58ff5097a36eGlenn Kasten 26054df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project Handler getHandler() { 26064df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project return mHandler; 26079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 26089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 26099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2610d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean /** 2611ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean * Marshmallow Routing API. 2612d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean * Helper class to handle the forwarding of native events to the appropriate listener 2613d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean * (potentially) handled in a different thread 2614d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean */ 2615d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean private class NativeRoutingEventHandlerDelegate { 2616d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean private final Handler mHandler; 2617d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean 2618d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean NativeRoutingEventHandlerDelegate(final AudioTrack track, 2619e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean final OnRoutingChangedListener listener, 2620d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean Handler handler) { 2621d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean // find the looper for our new event handler 2622d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean Looper looper; 2623d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean if (handler != null) { 2624d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean looper = handler.getLooper(); 2625d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean } else { 2626d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean // no given handler, use the looper the AudioTrack was created in 2627ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean looper = mInitializationLooper; 2628ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean } 2629ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean 2630ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean // construct the event handler with this looper 2631ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean if (looper != null) { 2632ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean // implement the event handler delegate 2633ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean mHandler = new Handler(looper) { 2634ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean @Override 2635ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean public void handleMessage(Message msg) { 2636ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean if (track == null) { 2637ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean return; 2638ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean } 2639ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean switch(msg.what) { 2640ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean case AudioSystem.NATIVE_EVENT_ROUTING_CHANGE: 2641ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean if (listener != null) { 2642ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean listener.onRoutingChanged(track); 2643ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean } 2644ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean break; 2645ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean default: 2646ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean loge("Unknown native event type: " + msg.what); 2647ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean break; 2648ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean } 2649ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean } 2650ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean }; 2651ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean } else { 2652ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean mHandler = null; 2653ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean } 2654ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean } 2655ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean 2656ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean Handler getHandler() { 2657ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean return mHandler; 2658ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean } 2659ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean } 2660ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean 2661ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean /** 2662ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean * Marshmallow Routing API. 2663ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean * Helper class to handle the forwarding of native events to the appropriate listener 2664ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean * (potentially) handled in a different thread 2665ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean */ 2666ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean private class NativeNewRoutingEventHandlerDelegate { 2667ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean private final Handler mHandler; 2668ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean 2669ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean NativeNewRoutingEventHandlerDelegate(final AudioTrack track, 2670ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean final AudioRouting.OnRoutingChangedListener listener, 2671ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean Handler handler) { 2672ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean // find the looper for our new event handler 2673ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean Looper looper; 2674ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean if (handler != null) { 2675ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean looper = handler.getLooper(); 2676ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean } else { 2677ed36ca3d4f4f8aa0ee2951eab143a3c96b76158bPaul McLean // no given handler, use the looper the AudioTrack was created in 2678d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean looper = mInitializationLooper; 2679d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean } 2680d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean 2681d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean // construct the event handler with this looper 2682d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean if (looper != null) { 2683d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean // implement the event handler delegate 2684d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean mHandler = new Handler(looper) { 2685d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean @Override 2686d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean public void handleMessage(Message msg) { 2687d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean if (track == null) { 2688d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean return; 2689d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean } 2690d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean switch(msg.what) { 26914bcdba848449b33d7022de527c526943aff1f5fdEric Laurent case AudioSystem.NATIVE_EVENT_ROUTING_CHANGE: 2692d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean if (listener != null) { 2693e3383cc4539921756232ae4f3f54e99b95fb20ccPaul McLean listener.onRoutingChanged(track); 2694d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean } 2695d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean break; 2696d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean default: 2697d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean loge("Unknown native event type: " + msg.what); 2698d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean break; 2699d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean } 2700d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean } 2701d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean }; 2702d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean } else { 2703d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean mHandler = null; 2704d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean } 2705d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean } 2706d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean 2707d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean Handler getHandler() { 2708d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean return mHandler; 2709d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean } 2710d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean } 27119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 27129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //--------------------------------------------------------- 27139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Java methods called from the native side 27149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //-------------------- 27159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @SuppressWarnings("unused") 27169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static void postEventFromNative(Object audiotrack_ref, 27179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int what, int arg1, int arg2, Object obj) { 27189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //logd("Event posted from the native side: event="+ what + " args="+ arg1+" "+arg2); 27199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project AudioTrack track = (AudioTrack)((WeakReference)audiotrack_ref).get(); 27209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (track == null) { 27219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return; 27229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 27239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 27244bcdba848449b33d7022de527c526943aff1f5fdEric Laurent if (what == AudioSystem.NATIVE_EVENT_ROUTING_CHANGE) { 27254bcdba848449b33d7022de527c526943aff1f5fdEric Laurent track.broadcastRoutingChange(); 27264bcdba848449b33d7022de527c526943aff1f5fdEric Laurent return; 27274bcdba848449b33d7022de527c526943aff1f5fdEric Laurent } 2728d5bad53a0cfb675d945442f5794ae991dbd035caPaul McLean NativePositionEventHandlerDelegate delegate = track.mEventHandlerDelegate; 272995bd2329c6a36211f18be3e089eaa775ec62df62Glenn Kasten if (delegate != null) { 273095bd2329c6a36211f18be3e089eaa775ec62df62Glenn Kasten Handler handler = delegate.getHandler(); 273195bd2329c6a36211f18be3e089eaa775ec62df62Glenn Kasten if (handler != null) { 273295bd2329c6a36211f18be3e089eaa775ec62df62Glenn Kasten Message m = handler.obtainMessage(what, arg1, arg2, obj); 273395bd2329c6a36211f18be3e089eaa775ec62df62Glenn Kasten handler.sendMessage(m); 273495bd2329c6a36211f18be3e089eaa775ec62df62Glenn Kasten } 27359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 27369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 27379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 27389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 27399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //--------------------------------------------------------- 27409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Native methods called from the Java side 27419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //-------------------- 27429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2743a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi // post-condition: mStreamType is overwritten with a value 2744a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi // that reflects the audio attributes (e.g. an AudioAttributes object with a usage of 2745a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi // AudioAttributes.USAGE_MEDIA will map to AudioManager.STREAM_MUSIC 2746a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi private native final int native_setup(Object /*WeakReference<AudioTrack>*/ audiotrack_this, 2747a1d80e3b1d210c60c6881a55ed39a4077ff66080Jean-Michel Trivi Object /*AudioAttributes*/ attributes, 274830d794360f35592554403922bcc07835fea4737bAndy Hung int sampleRate, int channelMask, int channelIndexMask, int audioFormat, 2749619346f902241736d933657a4fe10f10c50a1ba8Eric Laurent int buffSizeInBytes, int mode, int[] sessionId); 27509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 27519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private native final void native_finalize(); 27529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 27539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private native final void native_release(); 27549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 27559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private native final void native_start(); 27569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 27579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private native final void native_stop(); 27589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 27599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private native final void native_pause(); 27609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 27619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private native final void native_flush(); 27629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 27639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private native final int native_write_byte(byte[] audioData, 27647ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi int offsetInBytes, int sizeInBytes, int format, 27657ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi boolean isBlocking); 27669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 27679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private native final int native_write_short(short[] audioData, 27684aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung int offsetInShorts, int sizeInShorts, int format, 27694aacc903e3f0216a1aec00d57d34f902025d5bd0Andy Hung boolean isBlocking); 27709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 277154955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten private native final int native_write_float(float[] audioData, 277254955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten int offsetInFloats, int sizeInFloats, int format, 277354955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten boolean isBlocking); 277454955e33c8612a737a76177408f3e7c8482cfcf4Glenn Kasten 27757ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi private native final int native_write_native_bytes(Object audioData, 27765d21f679c58dbb13c8c931ffec6e06b6b8cd454fJean-Michel Trivi int positionInBytes, int sizeInBytes, int format, boolean blocking); 27777ca0452fa62b9c15bd45b0fd52aef97442555a6eJean-Michel Trivi 27789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private native final int native_reload_static(); 27799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 278010a33e499c97767f8d6bfc6514ba8b5f485394daPhil Burk private native final int native_get_buffer_size_frames(); 278110a33e499c97767f8d6bfc6514ba8b5f485394daPhil Burk private native final int native_set_buffer_size_frames(int bufferSizeInFrames); 278210a33e499c97767f8d6bfc6514ba8b5f485394daPhil Burk private native final int native_get_buffer_capacity_frames(); 27839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 27849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private native final void native_setVolume(float leftVolume, float rightVolume); 27859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 278688e209dcf8c2ebddda5c272f46d1bd5478bc639cEric Laurent private native final int native_set_playback_rate(int sampleRateInHz); 278788e209dcf8c2ebddda5c272f46d1bd5478bc639cEric Laurent private native final int native_get_playback_rate(); 27889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 27892d61e2b97c92ac2de80ebb3782b728ae5cdf5306Wei Jia private native final void native_set_playback_params(@NonNull PlaybackParams params); 27902d61e2b97c92ac2de80ebb3782b728ae5cdf5306Wei Jia private native final @NonNull PlaybackParams native_get_playback_params(); 2791263b4c97823295c41900210515d0c769a236190cAndy Hung 27929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private native final int native_set_marker_pos(int marker); 27939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private native final int native_get_marker_pos(); 27949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 27959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private native final int native_set_pos_update_period(int updatePeriod); 27969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private native final int native_get_pos_update_period(); 27979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 27989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private native final int native_set_position(int position); 27999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private native final int native_get_position(); 28009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 280161dcdf3764b614c6f01e77cb4342d192e3101f8aOliver Woodman private native final int native_get_latency(); 280261dcdf3764b614c6f01e77cb4342d192e3101f8aOliver Woodman 280303f61bbb2e7293592ad4a304b0f0b8e6ee8e6aacPhil Burk private native final int native_get_underrun_count(); 280403f61bbb2e7293592ad4a304b0f0b8e6ee8e6aacPhil Burk 2805948c2e6ff46d65942277f2e0e9ce0c038972b9d8Glenn Kasten // longArray must be a non-null array of length >= 2 2806948c2e6ff46d65942277f2e0e9ce0c038972b9d8Glenn Kasten // [0] is assigned the frame position 2807948c2e6ff46d65942277f2e0e9ce0c038972b9d8Glenn Kasten // [1] is assigned the time in CLOCK_MONOTONIC nanoseconds 2808948c2e6ff46d65942277f2e0e9ce0c038972b9d8Glenn Kasten private native final int native_get_timestamp(long[] longArray); 2809948c2e6ff46d65942277f2e0e9ce0c038972b9d8Glenn Kasten 28109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private native final int native_set_loop(int start, int end, int loopCount); 28119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 28129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project static private native final int native_get_output_sample_rate(int streamType); 28139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project static private native final int native_get_min_buff_size( 28149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int sampleRateInHz, int channelConfig, int audioFormat); 28159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 28167070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent private native final int native_attachAuxEffect(int effectId); 28173009f0b911e39d3b26c69bd7667d6444eacb9d11Glenn Kasten private native final int native_setAuxEffectSendLevel(float level); 28187070b36549d511d6627538c73dfbab23fbae5b43Eric Laurent 281988e1d86a879d8802e775dd0566ffb64425e8e3c8Paul McLean private native final boolean native_setOutputDevice(int deviceId); 28204bcdba848449b33d7022de527c526943aff1f5fdEric Laurent private native final int native_getRoutedDeviceId(); 28214bcdba848449b33d7022de527c526943aff1f5fdEric Laurent private native final void native_enableDeviceCallback(); 28224bcdba848449b33d7022de527c526943aff1f5fdEric Laurent private native final void native_disableDeviceCallback(); 282325d3c7c49bafb22723138bfab2e315d2d0a926fbGlenn Kasten static private native int native_get_FCC_8(); 282488e1d86a879d8802e775dd0566ffb64425e8e3c8Paul McLean 28259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //--------------------------------------------------------- 28269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Utility methods 28279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //------------------ 28289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 28299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static void logd(String msg) { 28301f61d01508651b4475397414e1fe06af1ab8fadaGlenn Kasten Log.d(TAG, msg); 28319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 28329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 28339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static void loge(String msg) { 28341f61d01508651b4475397414e1fe06af1ab8fadaGlenn Kasten Log.e(TAG, msg); 28359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 28369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project} 2837