AudioProvider.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_CAPABILITYAGENTS_AIP_INCLUDE_AIP_AUDIOPROVIDER_H_
#define ALEXA_CLIENT_SDK_CAPABILITYAGENTS_AIP_INCLUDE_AIP_AUDIOPROVIDER_H_

#include <AVSCommon/AVS/AudioInputStream.h>
#include <AVSCommon/Utils/AudioFormat.h>
#include "ASRProfile.h"

namespace alexaClientSDK {
namespace capabilityAgents {
namespace aip {

struct AudioProvider {
    AudioProvider(
        std::shared_ptr<avsCommon::avs::AudioInputStream> stream,
        const avsCommon::utils::AudioFormat& format,
        ASRProfile profile,
        bool alwaysReadable,
        bool canOverride,
        bool canBeOverridden);

    static AudioProvider TapAudioProvider(
        std::shared_ptr<avsCommon::avs::AudioInputStream> stream,
        const avsCommon::utils::AudioFormat& format);

    static AudioProvider WakeAudioProvider(
        std::shared_ptr<avsCommon::avs::AudioInputStream> stream,
        const avsCommon::utils::AudioFormat& format);

    static AudioProvider HoldAudioProvider(
        std::shared_ptr<avsCommon::avs::AudioInputStream> stream,
        const avsCommon::utils::AudioFormat& format);

    static const AudioProvider& null();

    operator bool() const;

    std::shared_ptr<avsCommon::avs::AudioInputStream> stream;

    avsCommon::utils::AudioFormat format;

    ASRProfile profile;

    bool alwaysReadable;

    bool canOverride;

    bool canBeOverridden;
};

inline AudioProvider::AudioProvider(
    std::shared_ptr<avsCommon::avs::AudioInputStream> stream,
    const avsCommon::utils::AudioFormat& format,
    ASRProfile profile,
    bool alwaysReadable,
    bool canOverride,
    bool canBeOverridden)
        // Note: There is an issue with braced initialization of an aggregate type in GCC 4.8, so parentheses are used
        //     below to initialize format.
        :
        stream{stream},
        format(format),
        profile{profile},
        alwaysReadable{alwaysReadable},
        canOverride{canOverride},
        canBeOverridden{canBeOverridden} {
}

inline AudioProvider AudioProvider::TapAudioProvider(
    std::shared_ptr<avsCommon::avs::AudioInputStream> stream,
    const avsCommon::utils::AudioFormat& format) {
    bool alwaysReadable = true;
    bool canOverride = true;
    bool canBeOverridden = true;
    AudioProvider tapProvider{stream, format, ASRProfile::NEAR_FIELD, alwaysReadable, canOverride, canBeOverridden};

    return tapProvider;
}

inline AudioProvider AudioProvider::WakeAudioProvider(
    std::shared_ptr<avsCommon::avs::AudioInputStream> stream,
    const avsCommon::utils::AudioFormat& format) {
    bool alwaysReadable = true;
    bool canOverride = false;
    bool canBeOverridden = true;
    AudioProvider WakeAudioProvider{
        stream, format, ASRProfile::NEAR_FIELD, alwaysReadable, canOverride, canBeOverridden};

    return WakeAudioProvider;
}

inline AudioProvider AudioProvider::HoldAudioProvider(
    std::shared_ptr<avsCommon::avs::AudioInputStream> stream,
    const avsCommon::utils::AudioFormat& format) {
    bool alwaysReadable = false;
    bool canOverride = true;
    bool canBeOverridden = false;
    AudioProvider HoldProvider{stream, format, ASRProfile::CLOSE_TALK, alwaysReadable, canOverride, canBeOverridden};

    return HoldProvider;
}

inline const AudioProvider& AudioProvider::null() {
    static AudioProvider nullAudioProvider{nullptr,
                                           {avsCommon::utils::AudioFormat::Encoding::LPCM,
                                            avsCommon::utils::AudioFormat::Endianness::LITTLE,
                                            0,
                                            0,
                                            0,
                                            true,
                                            avsCommon::utils::AudioFormat::Layout::NON_INTERLEAVED},
                                           ASRProfile::CLOSE_TALK,
                                           false,
                                           false,
                                           false};
    return nullAudioProvider;
}

inline AudioProvider::operator bool() const {
    return stream != nullptr;
}

}  // namespace aip
}  // namespace capabilityAgents
}  // namespace alexaClientSDK

#endif  // ALEXA_CLIENT_SDK_CAPABILITYAGENTS_AIP_INCLUDE_AIP_AUDIOPROVIDER_H_