1 /*
2  * Copyright 2016 The Android Open Source Project
3  *
4  * Licensed under the Apache License, Version 2.0 (the "License");
5  * you may not use this file except in compliance with the License.
6  * You may obtain a copy of the License at
7  *
8  *      http://www.apache.org/licenses/LICENSE-2.0
9  *
10  * Unless required by applicable law or agreed to in writing, software
11  * distributed under the License is distributed on an "AS IS" BASIS,
12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13  * See the License for the specific language governing permissions and
14  * limitations under the License.
15  */
16 
17 //
18 // Interface to the A2DP AAC Encoder
19 //
20 
21 #ifndef A2DP_AAC_ENCODER_H
22 #define A2DP_AAC_ENCODER_H
23 
24 #include "a2dp_aac_constants.h"
25 #include "a2dp_codec_api.h"
26 
27 // Is used in btav_a2dp_codec_config_t.codec_specific_1 when codec is AAC
28 enum class AacEncoderBitrateMode : int64_t {
29   // Variable bitrate mode unsupported when used in a codec report, and upper
30   // layer can use this value as system default (keep current settings)
31   AACENC_BR_MODE_CBR = A2DP_AAC_VARIABLE_BIT_RATE_DISABLED,
32   // Constant bitrate mode when Variable bitrate mode is supported. This can
33   // also be used to disable Variable bitrate mode by upper layer
34   AACENC_BR_MODE_VBR_C = (A2DP_AAC_VARIABLE_BIT_RATE_ENABLED | 0x00),
35   // Variable bitrate mode (very low bitrate for software encoding).
36   AACENC_BR_MODE_VBR_1 = (A2DP_AAC_VARIABLE_BIT_RATE_ENABLED | 0x01),
37   // Variable bitrate mode (low bitrate for software encoding).
38   AACENC_BR_MODE_VBR_2 = (A2DP_AAC_VARIABLE_BIT_RATE_ENABLED | 0x02),
39   // Variable bitrate mode (medium bitrate for software encoding).
40   AACENC_BR_MODE_VBR_3 = (A2DP_AAC_VARIABLE_BIT_RATE_ENABLED | 0x03),
41   // Variable bitrate mode (high bitrate for software encoding).
42   AACENC_BR_MODE_VBR_4 = (A2DP_AAC_VARIABLE_BIT_RATE_ENABLED | 0x04),
43   // Variable bitrate mode (very high bitrate for software encoding).
44   AACENC_BR_MODE_VBR_5 = (A2DP_AAC_VARIABLE_BIT_RATE_ENABLED | 0x05),
45 };
46 
47 // Loads the A2DP AAC encoder.
48 // Return true on success, otherwise false.
49 bool A2DP_LoadEncoderAac(void);
50 
51 // Unloads the A2DP AAC encoder.
52 void A2DP_UnloadEncoderAac(void);
53 
54 // Initialize the A2DP AAC encoder.
55 // |p_peer_params| contains the A2DP peer information
56 // The current A2DP codec config is in |a2dp_codec_config|.
57 // |read_callback| is the callback for reading the input audio data.
58 // |enqueue_callback| is the callback for enqueueing the encoded audio data.
59 void a2dp_aac_encoder_init(const tA2DP_ENCODER_INIT_PEER_PARAMS* p_peer_params,
60                            A2dpCodecConfig* a2dp_codec_config,
61                            a2dp_source_read_callback_t read_callback,
62                            a2dp_source_enqueue_callback_t enqueue_callback);
63 
64 // Cleanup the A2DP AAC encoder.
65 void a2dp_aac_encoder_cleanup(void);
66 
67 // Reset the feeding for the A2DP AAC encoder.
68 void a2dp_aac_feeding_reset(void);
69 
70 // Flush the feeding for the A2DP AAC encoder.
71 void a2dp_aac_feeding_flush(void);
72 
73 // Get the A2DP AAC encoder interval (in milliseconds).
74 uint64_t a2dp_aac_get_encoder_interval_ms(void);
75 
76 // Prepare and send A2DP AAC encoded frames.
77 // |timestamp_us| is the current timestamp (in microseconds).
78 void a2dp_aac_send_frames(uint64_t timestamp_us);
79 
80 #endif  // A2DP_AAC_ENCODER_H
81