mirror of
https://github.com/Evolution-X/hardware_interfaces
synced 2026-02-02 20:24:19 +00:00
e400c835a2
The effect instance may choose to reallocate the input data message queue under specific conditions. For example, when the input format changes, requiring an update to the data message queue allocated during the open time. In such cases, the effect instance can destroy the existing data message queue, when the audio framework see a valid status MQ and invalid data MQ, it call reopen to get the new data message queue. Bug: 302036943 Test: m android.hardware.audio.effect-update-api, m Change-Id: Ia245b154176f64bc3cc6e6049bca4f9c68ad482d
89 lines
3.6 KiB
C++
89 lines
3.6 KiB
C++
/*
|
|
* Copyright (C) 2022 The Android Open Source Project
|
|
*
|
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
|
* you may not use this file except in compliance with the License.
|
|
* You may obtain a copy of the License at
|
|
*
|
|
* http://www.apache.org/licenses/LICENSE-2.0
|
|
*
|
|
* Unless required by applicable law or agreed to in writing, software
|
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
* See the License for the specific language governing permissions and
|
|
* limitations under the License.
|
|
*/
|
|
|
|
#pragma once
|
|
#include <cstdlib>
|
|
#include <memory>
|
|
|
|
#include <aidl/android/hardware/audio/effect/BnEffect.h>
|
|
#include <fmq/AidlMessageQueue.h>
|
|
|
|
#include "EffectContext.h"
|
|
#include "EffectThread.h"
|
|
#include "EffectTypes.h"
|
|
#include "effect-impl/EffectContext.h"
|
|
#include "effect-impl/EffectThread.h"
|
|
#include "effect-impl/EffectTypes.h"
|
|
|
|
extern "C" binder_exception_t destroyEffect(
|
|
const std::shared_ptr<aidl::android::hardware::audio::effect::IEffect>& instanceSp);
|
|
|
|
namespace aidl::android::hardware::audio::effect {
|
|
|
|
class EffectImpl : public BnEffect, public EffectThread {
|
|
public:
|
|
EffectImpl() = default;
|
|
virtual ~EffectImpl() = default;
|
|
|
|
virtual ndk::ScopedAStatus open(const Parameter::Common& common,
|
|
const std::optional<Parameter::Specific>& specific,
|
|
OpenEffectReturn* ret) override;
|
|
virtual ndk::ScopedAStatus close() override;
|
|
virtual ndk::ScopedAStatus command(CommandId id) override;
|
|
virtual ndk::ScopedAStatus reopen(OpenEffectReturn* ret) override;
|
|
|
|
virtual ndk::ScopedAStatus getState(State* state) override;
|
|
virtual ndk::ScopedAStatus setParameter(const Parameter& param) override;
|
|
virtual ndk::ScopedAStatus getParameter(const Parameter::Id& id, Parameter* param) override;
|
|
|
|
virtual ndk::ScopedAStatus setParameterCommon(const Parameter& param);
|
|
virtual ndk::ScopedAStatus getParameterCommon(const Parameter::Tag& tag, Parameter* param);
|
|
|
|
/* Methods MUST be implemented by each effect instances */
|
|
virtual ndk::ScopedAStatus getDescriptor(Descriptor* desc) = 0;
|
|
virtual ndk::ScopedAStatus setParameterSpecific(const Parameter::Specific& specific) = 0;
|
|
virtual ndk::ScopedAStatus getParameterSpecific(const Parameter::Id& id,
|
|
Parameter::Specific* specific) = 0;
|
|
|
|
virtual std::string getEffectName() = 0;
|
|
virtual IEffect::Status effectProcessImpl(float* in, float* out, int samples) override;
|
|
|
|
/**
|
|
* Effect context methods must be implemented by each effect.
|
|
* Each effect can derive from EffectContext and define its own context, but must upcast to
|
|
* EffectContext for EffectImpl to use.
|
|
*/
|
|
virtual std::shared_ptr<EffectContext> createContext(const Parameter::Common& common) = 0;
|
|
virtual std::shared_ptr<EffectContext> getContext() = 0;
|
|
virtual RetCode releaseContext() = 0;
|
|
|
|
protected:
|
|
State mState = State::INIT;
|
|
|
|
IEffect::Status status(binder_status_t status, size_t consumed, size_t produced);
|
|
void cleanUp();
|
|
|
|
/**
|
|
* Optional CommandId handling methods for effects to override.
|
|
* For CommandId::START, EffectImpl call commandImpl before starting the EffectThread
|
|
* processing.
|
|
* For CommandId::STOP and CommandId::RESET, EffectImpl call commandImpl after stop the
|
|
* EffectThread processing.
|
|
*/
|
|
virtual ndk::ScopedAStatus commandImpl(CommandId id);
|
|
};
|
|
} // namespace aidl::android::hardware::audio::effect
|