Refactor codes of setting stream info. and add support for setting internal stream...
[platform/core/api/audio-io.git] / include / CAudioInfo.h
1 /*
2  * Copyright (c) 2015 Samsung Electronics Co., Ltd All Rights Reserved
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 #ifndef __TIZEN_MEDIA_AUDIO__IO_CAUDIO_INFO_H__
18 #define __TIZEN_MEDIA_AUDIO__IO_CAUDIO_INFO_H__
19
20
21 #ifdef __cplusplus
22
23
24 namespace tizen_media_audio {
25
26
27     /**
28      * Audio Information
29      */
30     class CAudioInfo {
31     public:
32         enum class EChannel : unsigned int {
33             CHANNEL_MONO = 1,               /**< 1 channel, mono */
34             CHANNEL_STEREO,                 /**< 2 channel, stereo */
35             CHANNEL_MAX
36         };
37
38         enum class ESampleType : unsigned int {
39             SAMPLE_TYPE_U8 = 1,             /**< Unsigned 8-bit audio samples */
40             SAMPLE_TYPE_S16_LE,             /**< Signed 16-bit audio samples */
41             SAMPLE_TYPE_MAX
42         };
43
44         enum class EAudioType : unsigned int {
45             /* Input Type */
46             AUDIO_IN_TYPE_MEDIA = 0,
47             //AUDIO_IN_TYPE_SYSTEM,
48             //AUDIO_IN_TYPE_ALARM,
49             //AUDIO_IN_TYPE_NOTIFICATION,
50             //AUDIO_IN_TYPE_EMERGENCY,
51             //AUDIO_IN_TYPE_VOICE_INFORMATION,
52             AUDIO_IN_TYPE_VOICE_RECOGNITION,
53             //AUDIO_IN_TYPE_RINGTONE_VOIP,
54             AUDIO_IN_TYPE_VOIP,
55             AUDIO_IN_TYPE_MEDIA_EXTERNAL_ONLY,
56             //AUDIO_IN_TYPE_RINGTONE_CALL,
57             //AUDIO_IN_TYPE_VOICE_CALL,
58             //AUDIO_IN_TYPE_VIDEO_CALL,
59             //AUDIO_IN_TYPE_RADIO,
60             AUDIO_IN_TYPE_LOOPBACK,
61
62             /* Output Type */
63             AUDIO_OUT_TYPE_MEDIA,
64             AUDIO_OUT_TYPE_SYSTEM,
65             AUDIO_OUT_TYPE_ALARM,
66             AUDIO_OUT_TYPE_NOTIFICATION,
67             AUDIO_OUT_TYPE_EMERGENCY,
68             AUDIO_OUT_TYPE_VOICE_INFORMATION,
69             //AUDIO_OUT_TYPE_VOICE_RECOGNITION,
70             AUDIO_OUT_TYPE_RINGTONE_VOIP,
71             AUDIO_OUT_TYPE_VOIP,
72             AUDIO_OUT_TYPE_MEDIA_EXTERNAL_ONLY,
73             AUDIO_OUT_TYPE_RINGTONE_CALL,
74             //AUDIO_OUT_TYPE_VOICE_CALL,
75             //AUDIO_OUT_TYPE_VIDEO_CALL,
76             //AUDIO_OUT_TYPE_RADIO,
77             //AUDIO_OUT_TYPE_LOOPBACK,
78
79             AUDIO_TYPE_MAX
80         };
81
82         enum class EAudioIOState : unsigned int {
83             AUDIO_IO_STATE_NONE,      /**< Audio-io handle is not created */
84             AUDIO_IO_STATE_IDLE,      /**< Audio-io handle is created, but not prepared */
85             AUDIO_IO_STATE_RUNNING,   /**< Audio-io handle is ready and the stream is running */
86             AUDIO_IO_STATE_PAUSED,    /**< Audio-io handle is ready and the stream is paused */
87             AUDIO_IO_STATE_MAX
88         };
89
90         enum class EAudioDirection : unsigned int {
91             AUDIO_DIRECTION_IN,       /**< Audio direction input */
92             AUDIO_DIRECTION_OUT,      /**< Audio direction output */
93             AUDIO_DIRECTION_MAX
94         };
95
96         const static unsigned int MIN_SYSTEM_SAMPLERATE = 8000;
97         const static unsigned int MAX_SYSTEM_SAMPLERATE = 48000;
98
99         /* Constructors */
100         CAudioInfo();
101         CAudioInfo(unsigned int sampleRate, EChannel channel, ESampleType sampleType, EAudioType audioType, int audioIndex) throw(CAudioError);
102
103         /* Setter & Getter */
104         unsigned int getSampleRate();
105         EChannel getChannel();
106         ESampleType getSampleType();
107         EAudioType getAudioType();
108         void setAudioType(EAudioType audioType);
109         int getAudioIndex();
110         void setAudioIndex(int audioIndex);
111         void convertAudioType2StreamType(CAudioInfo::EAudioType audioType, char **streamType);
112         void convertInputStreamType2AudioType(char *streamType, CAudioInfo::EAudioType *audioType);
113         void convertOutputStreamType2AudioType(char *streamType, CAudioInfo::EAudioType *audioType);
114         int getSampleSize();
115
116     private:
117         const char *__STREAM_TYPE_TABLE[(unsigned int)EAudioType::AUDIO_TYPE_MAX] = {
118             /* Input Type */
119             "media",                  /**< AUDIO_IN_TYPE_MEDIA */
120             //"system",               /**< AUDIO_IN_TYPE_SYSTEM */
121             //"alarm",                /**< AUDIO_IN_TYPE_ALARM */
122             //"notification",         /**< AUDIO_IN_TYPE_NOTIFICATION */
123             //"emergency",            /**< AUDIO_IN_TYPE_EMERGENCY */
124             //"voice-information",    /**< AUDIO_IN_TYPE_VOICE_INFORMATION */
125             "voice-recognition",      /**< AUDIO_IN_TYPE_VOICE_RECOGNITION */
126             //"ringtone-voip",        /**< AUDIO_IN_TYPE_RINGTONE_VOIP */
127             "voip",                   /**< AUDIO_IN_TYPE_VOIP */
128             "ext-media",              /**< AUDIO_IN_TYPE_MEDIA_EXTERNAL_ONLY */
129             //"ringtone-call",        /**< AUDIO_IN_TYPE_RINGTONE_CALL */
130             //"call-voice",           /**< AUDIO_IN_TYPE_VOICE_CALL */
131             //"call-video",           /**< AUDIO_IN_TYPE_VIDEO_CALL */
132             //"radio",                /**< AUDIO_IN_TYPE_RADIO */
133             "loopback-mirroring",     /**< AUDIO_IN_TYPE_LOOPBACK */
134
135             /* Output Type */
136             "media",                  /**< AUDIO_OUT_TYPE_MEDIA */
137             "system",                 /**< AUDIO_OUT_TYPE_SYSTEM */
138             "alarm",                  /**< AUDIO_OUT_TYPE_ALARM */
139             "notification",           /**< AUDIO_OUT_TYPE_NOTIFICATION */
140             "emergency",              /**< AUDIO_OUT_TYPE_EMERGENCY */
141             "voice-information",      /**< AUDIO_OUT_TYPE_VOICE_INFORMATION */
142             //"voice-recognition",    /**< AUDIO_OUT_TYPE_VOICE_RECOGNITION */
143             "ringtone-voip",          /**< AUDIO_OUT_TYPE_RINGTONE_VOIP */
144             "voip",                   /**< AUDIO_OUT_TYPE_VOIP */
145             "ext-media",              /**< AUDIO_OUT_TYPE_MEDIA_EXTERNAL_ONLY */
146             "ringtone-call",          /**< AUDIO_OUT_TYPE_RINGTONE_CALL */
147             //"call-voice",           /**< AUDIO_OUT_TYPE_VOICE_CALL */
148             //"call-video",           /**< AUDIO_OUT_TYPE_VIDEO_CALL */
149             //"radio",                /**< AUDIO_OUT_TYPE_RADIO */
150             //"loopback-mirroring",   /**< AUDIO_OUT_TYPE_LOOPBACK */
151         };
152
153         unsigned int __mSampleRate;
154         EChannel     __mChannel;
155         ESampleType  __mSampleType;
156         EAudioType   __mAudioType;
157         int          __mAudioIndex;
158     };
159
160
161 } /* namespace tizen_media_audio */
162
163 #endif
164 #endif /* __TIZEN_MEDIA_AUDIO__IO_CAUDIO_INFO_H__ */