RangeControllerInterface.h

Go to the documentation of this file.

/*
 * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
 *
 * Licensed under the Apache License, Version 2.0 (the "License").
 * You may not use this file except in compliance with the License.
 * A copy of the License is located at
 *
 *     http://aws.amazon.com/apache2.0/
 *
 * or in the "license" file accompanying this file. This file 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.
 */

#ifndef ALEXA_CLIENT_SDK_AVSCOMMON_SDKINTERFACES_INCLUDE_AVSCOMMON_SDKINTERFACES_RANGECONTROLLER_RANGECONTROLLERINTERFACE_H_
#define ALEXA_CLIENT_SDK_AVSCOMMON_SDKINTERFACES_INCLUDE_AVSCOMMON_SDKINTERFACES_RANGECONTROLLER_RANGECONTROLLERINTERFACE_H_

#include <AVSCommon/AVS/AlexaResponseType.h>
#include <AVSCommon/SDKInterfaces/AlexaStateChangeCauseType.h>
#include <AVSCommon/SDKInterfaces/RangeController/RangeControllerObserverInterface.h>
#include <AVSCommon/Utils/Optional.h>

namespace alexaClientSDK {
namespace avsCommon {
namespace sdkInterfaces {
namespace rangeController {

class RangeControllerInterface {
public:
    using RangeState = avsCommon::sdkInterfaces::rangeController::RangeControllerObserverInterface::RangeState;

    virtual ~RangeControllerInterface() = default;

    struct RangeControllerConfiguration {
        double minimumValue;

        double maximumValue;

        double precision;
    };

    virtual RangeControllerConfiguration getConfiguration() = 0;

    virtual std::pair<avsCommon::avs::AlexaResponseType, std::string> setRangeValue(
        double range,
        AlexaStateChangeCauseType cause) = 0;

    virtual std::pair<avsCommon::avs::AlexaResponseType, std::string> adjustRangeValue(
        double deltaRange,
        AlexaStateChangeCauseType cause) = 0;

    virtual std::pair<avsCommon::avs::AlexaResponseType, utils::Optional<RangeState>> getRangeState() = 0;

    virtual bool addObserver(std::shared_ptr<RangeControllerObserverInterface> observer) = 0;

    virtual void removeObserver(const std::shared_ptr<RangeControllerObserverInterface>& observer) = 0;
};

}  // namespace rangeController
}  // namespace sdkInterfaces
}  // namespace avsCommon
}  // namespace alexaClientSDK

#endif  // ALEXA_CLIENT_SDK_AVSCOMMON_SDKINTERFACES_INCLUDE_AVSCOMMON_SDKINTERFACES_RANGECONTROLLER_RANGECONTROLLERINTERFACE_H_