APLViewhostInterface.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_LIBIPCSERVERSAMPLEAPP_INCLUDE_IPCSERVERSAMPLEAPP_ALEXAPRESENTATION_APLVIEWHOSTINTERFACE_H_
#define ALEXA_CLIENT_SDK_LIBIPCSERVERSAMPLEAPP_INCLUDE_IPCSERVERSAMPLEAPP_ALEXAPRESENTATION_APLVIEWHOSTINTERFACE_H_

#include <chrono>
#include <memory>
#include <rapidjson/document.h>
#include <string>

#include <acsdk/APLCapabilityCommonInterfaces/PresentationSession.h>
#include <acsdk/APLCapabilityCommonInterfaces/VisualStateProviderInterface.h>
#include <AVSCommon/SDKInterfaces/MediaPropertiesInterface.h>
#include <AVSCommon/Utils/Metrics/MetricRecorderInterface.h>
#include "APLViewhostObserverInterface.h"

namespace alexaClientSDK {
namespace sampleApplications {
namespace ipcServerSampleApp {

class APLViewhostInterface : public aplCapabilityCommonInterfaces::VisualStateProviderInterface {
public:
    virtual ~APLViewhostInterface() = default;

    virtual void addObserver(const APLViewhostObserverInterfacePtr& observer) = 0;

    virtual void removeObserver(const APLViewhostObserverInterfacePtr& observer) = 0;

    virtual void renderDocument(
        const aplCapabilityCommonInterfaces::PresentationSession& presentationSession,
        const std::string& token,
        const std::string& document,
        const std::string& datasources,
        const std::string& supportedViewports,
        const std::string& windowId) = 0;

    virtual void clearDocument() {
        clearDocument("");
    }

    virtual void clearDocument(const std::string& token) {
        // no-op by default for backwards compatibility
    }

    virtual void executeCommands(const std::string& commands, const std::string& token) = 0;

    virtual void dataSourceUpdate(const std::string& sourceType, const std::string& data, const std::string& token) = 0;

    virtual void interruptCommandSequence() {
        interruptCommandSequence("");
    }

    virtual void interruptCommandSequence(const std::string& token) {
        // no-op by default for backwards compatibility
    }

    virtual void onRenderDirectiveReceived(
        const std::string& token,
        const std::chrono::steady_clock::time_point& receiveTime){
        // no-op by default for compatibility
    };

    virtual std::string getMaxAPLVersion() const = 0;

    virtual void setMetricRecorder(
        std::shared_ptr<avsCommon::utils::metrics::MetricRecorderInterface> metricRecorder) = 0;

    virtual bool handleBack(const std::string& windowId) = 0;
};

using APLViewhostInterfacePtr = std::shared_ptr<APLViewhostInterface>;
}  // namespace ipcServerSampleApp
}  // namespace sampleApplications
}  // namespace alexaClientSDK

#endif  // ALEXA_CLIENT_SDK_LIBIPCSERVERSAMPLEAPP_INCLUDE_IPCSERVERSAMPLEAPP_ALEXAPRESENTATION_APLVIEWHOSTINTERFACE_H_