4cb769e232c1ac5bce7a02f3e1cfb73596b2737d
[platform/core/api/audio-io.git] / include / CAudioIO.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_IO_H__
18 #define __TIZEN_MEDIA_AUDIO_IO_CAUDIO_IO_H__
19
20 #ifdef __cplusplus
21
22 #include <sound_manager.h>
23 #include <mutex>
24 #include <condition_variable>
25
26 namespace tizen_media_audio {
27
28
29     /**
30      *  Abstract Class
31      *  You can't take this object directly.
32      */
33     class IPulseStreamListener;
34     class CAudioIO : public IPulseStreamListener {
35     public:
36         struct SStreamCallback {
37             void* mUserData {};
38             void (*onStream)(size_t nbytes, void* user_data) {};
39
40             void set(void (*callback)(size_t, void*), void* userdata) {
41                 onStream = callback;
42                 mUserData = userdata;
43             }
44
45             void unset() {
46                 onStream = nullptr;
47                 mUserData = nullptr;
48             }
49         };
50
51         struct SStateChangedCallback {
52             void* mUserData {};
53             void (*onStateChanged)(CAudioInfo::EAudioIOState state, CAudioInfo::EAudioIOState statePrev, bool byPolicy, void* user_data) {};
54
55             void set(void (*callback)(CAudioInfo::EAudioIOState, CAudioInfo::EAudioIOState, bool, void*), void* userdata) {
56                 onStateChanged = callback;
57                 mUserData = userdata;
58             }
59
60             void unset() {
61                 onStateChanged = nullptr;
62                 mUserData = nullptr;
63             }
64         };
65
66         /* Constructor & Destructor */
67         explicit CAudioIO(CAudioInfo& audioInfo);
68         virtual ~CAudioIO() = default;
69
70         /* Implemented Handlers */
71         virtual void onStream(CPulseAudioClient* pClient, size_t length);
72         virtual void onStateChanged(CAudioInfo::EAudioIOState state, bool byPolicy);
73         virtual void onStateChanged(CAudioInfo::EAudioIOState state);
74
75         /* Methods */
76         virtual void initialize();
77         virtual void finalize();
78         virtual void prepare();
79         virtual void unprepare();
80         virtual void pause();
81         virtual void resume();
82         virtual void flush();
83         virtual int  getBufferSize() = 0;
84
85         CAudioInfo& getAudioInfo();
86
87         virtual void setStreamCallback(SStreamCallback callback);
88         SStreamCallback getStreamCallback();
89
90         virtual void setStateChangedCallback(SStateChangedCallback callback);
91         SStateChangedCallback getStateChangedCallback();
92
93         void setStreamInfo(sound_stream_info_h stream_info);
94
95         void setState(CAudioInfo::EAudioIOState state);
96         CAudioInfo::EAudioIOState getState() noexcept;
97
98     protected:
99         /* Protected Methods */
100         virtual void setInit(bool flag);
101         virtual bool isInit();
102         virtual bool IsReady();
103
104         CPulseAudioClient*    mpPulseAudioClient {};
105         CAudioInfo            mAudioInfo;
106
107         SStreamCallback       mStreamCallback;
108         SStateChangedCallback mStateChangedCallback;
109
110         CAudioInfo::EAudioDirection mDirection { CAudioInfo::EAudioDirection::AUDIO_DIRECTION_MAX };
111         CAudioInfo::EAudioIOState mState { CAudioInfo::EAudioIOState::AUDIO_IO_STATE_NONE };
112         CAudioInfo::EAudioIOState mStatePrev { CAudioInfo::EAudioIOState::AUDIO_IO_STATE_NONE };
113         bool                  mByPolicy {};
114         std::timed_mutex      mMutex;
115         std::mutex            mCondMutex;
116         std::condition_variable mCond;
117
118     private:
119         bool                  __mIsInit {};
120     };
121
122
123 } /* namespace tizen_media_audio */
124
125 #endif
126 #endif /* __TIZEN_MEDIA_AUDIO_IO_CAUDIO_IO_H__ */