• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1 /*
2  * Copyright (C) 2015 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 #pragma once
18 
19 #include "EngineBase.h"
20 #include <EngineInterface.h>
21 #include <AudioPolicyPluginInterface.h>
22 #include "Collection.h"
23 
24 namespace android {
25 class AudioPolicyManagerObserver;
26 
27 namespace audio_policy {
28 
29 class ParameterManagerWrapper;
30 class VolumeProfile;
31 
32 class Engine : public EngineBase, AudioPolicyPluginInterface
33 {
34 public:
35     Engine();
36     virtual ~Engine();
37 
38     template <class RequestedInterface>
39     RequestedInterface *queryInterface();
40 
41     ///
42     /// from EngineBase
43     ///
44     android::status_t initCheck() override;
45 
46     status_t setPhoneState(audio_mode_t mode) override;
47 
48     audio_mode_t getPhoneState() const override;
49 
50     status_t setForceUse(audio_policy_force_use_t usage, audio_policy_forced_cfg_t config) override;
51 
52     audio_policy_forced_cfg_t getForceUse(audio_policy_force_use_t usage) const override;
53 
54     android::status_t setDeviceConnectionState(const sp<DeviceDescriptor> devDesc,
55                                                audio_policy_dev_state_t state) override;
56 
57     DeviceVector getOutputDevicesForAttributes(const audio_attributes_t &attr,
58                                                const sp<DeviceDescriptor> &preferedDevice = nullptr,
59                                                bool fromCache = false) const override;
60 
61     DeviceVector getOutputDevicesForStream(audio_stream_type_t stream,
62                                            bool fromCache = false) const override;
63 
64     sp<DeviceDescriptor> getInputDeviceForAttributes(const audio_attributes_t &attr,
65                                                      uid_t uid = 0,
66                                                      sp<AudioPolicyMix> *mix = nullptr)
67                                                      const override;
68 
69     void updateDeviceSelectionCache() override;
70 
71     ///
72     /// from AudioPolicyPluginInterface
73     ///
addStream(const std::string & name,audio_stream_type_t stream)74     status_t addStream(const std::string &name, audio_stream_type_t stream) override
75     {
76         return add<audio_stream_type_t>(name, stream);
77     }
addInputSource(const std::string & name,audio_source_t source)78     status_t addInputSource(const std::string &name, audio_source_t source) override
79     {
80         return add<audio_source_t>(name, source);
81     }
82     bool setVolumeProfileForStream(const audio_stream_type_t &stream,
83                                    const audio_stream_type_t &volumeProfile) override;
84 
85     bool setDeviceForInputSource(const audio_source_t &inputSource, uint64_t device) override;
86 
87     void setDeviceAddressForProductStrategy(product_strategy_t strategy,
88                                                     const std::string &address) override;
89 
90     bool setDeviceTypesForProductStrategy(product_strategy_t strategy, uint64_t devices) override;
91 
getProductStrategyByName(const std::string & name)92     product_strategy_t getProductStrategyByName(const std::string &name) override
93     {
94         return EngineBase::getProductStrategyByName(name);
95     }
96 
97 private:
98     /* Copy facilities are put private to disable copy. */
99     Engine(const Engine &object);
100     Engine &operator=(const Engine &object);
101 
102     StreamCollection mStreamCollection; /**< Streams indexed by their enum id.  */
103     InputSourceCollection mInputSourceCollection; /**< Input sources indexed by their enum id. */
104 
105     template <typename Key>
106     status_t add(const std::string &name, const Key &key);
107 
108     template <typename Key>
109     Element<Key> *getFromCollection(const Key &key) const;
110 
111     template <typename Key>
112     const Collection<Key> &getCollection() const;
113 
114     template <typename Key>
115     Collection<Key> &getCollection();
116 
117     template <typename Property, typename Key>
118     Property getPropertyForKey(Key key) const;
119 
120     template <typename Property, typename Key>
121     bool setPropertyForKey(const Property &property, const Key &key);
122 
123     status_t loadAudioPolicyEngineConfig();
124 
125     DeviceVector getDevicesForProductStrategy(product_strategy_t strategy) const;
126     DeviceVector getCachedDevices(product_strategy_t ps) const;
127 
128     /**
129      * Policy Parameter Manager hidden through a wrapper.
130      */
131     ParameterManagerWrapper *mPolicyParameterMgr;
132 
133     DeviceStrategyMap mDevicesForStrategies;
134 };
135 
136 } // namespace audio_policy
137 
138 } // namespace android
139 
140