AlexaClientSDK  3.0.0
A cross-platform, modular SDK for interacting with the Alexa Voice Service
Public Member Functions | Static Public Member Functions | List of all members
alexaClientSDK::settings::CloudControlledSettingProtocol Class Reference

#include <CloudControlledSettingProtocol.h>

Inheritance diagram for alexaClientSDK::settings::CloudControlledSettingProtocol:
Inheritance graph
[legend]
Collaboration diagram for alexaClientSDK::settings::CloudControlledSettingProtocol:
Collaboration graph
[legend]

Public Member Functions

 ~CloudControlledSettingProtocol ()=default
 
SettingProtocolInterface methods.
SetSettingResult localChange (ApplyChangeFunction applyChange, RevertChangeFunction revertChange, SettingNotificationFunction notifyObservers) override
 
bool avsChange (ApplyChangeFunction applyChange, RevertChangeFunction revertChange, SettingNotificationFunction notifyObservers) override
 
bool restoreValue (ApplyDbChangeFunction applyChange, SettingNotificationFunction notifyObservers) override
 
bool clearData () override
 
- Public Member Functions inherited from alexaClientSDK::settings::SettingProtocolInterface
virtual ~SettingProtocolInterface ()=default
 

Static Public Member Functions

static std::unique_ptr< CloudControlledSettingProtocolcreate (const SettingEventMetadata &metadata, std::shared_ptr< SettingEventSenderInterface > eventSender, std::shared_ptr< storage::DeviceSettingStorageInterface > settingStorage, std::shared_ptr< avsCommon::sdkInterfaces::AVSConnectionManagerInterface > connectionManager, const std::shared_ptr< avsCommon::utils::metrics::MetricRecorderInterface > &metricRecorder)
 

Additional Inherited Members

- Public Types inherited from alexaClientSDK::settings::SettingProtocolInterface
using ApplyChangeFunction = std::function< std::pair< bool, std::string >()>
 
using ApplyDbChangeFunction = std::function< std::pair< bool, std::string >(const std::string &dbValue)>
 
using SettingNotificationFunction = std::function< void(SettingNotifications notification)>
 
using RevertChangeFunction = std::function< std::string()>
 

Detailed Description

Implement the protocol for cloud controlled settings.

Constructor & Destructor Documentation

◆ ~CloudControlledSettingProtocol()

alexaClientSDK::settings::CloudControlledSettingProtocol::~CloudControlledSettingProtocol ( )
default

Destructor.

Member Function Documentation

◆ avsChange()

bool alexaClientSDK::settings::CloudControlledSettingProtocol::avsChange ( ApplyChangeFunction  applyChange,
RevertChangeFunction  revertChange,
SettingNotificationFunction  notifyObservers 
)
overridevirtual

Implements the protocol for changing a setting value triggered by an AVS directive.

Parameters
applyChangeFunction that can be used to apply the new value.
revertChangeFunction that can be used to revert the change. This function should only be called if the apply change succeeded but some other part of the protocol has failed.
notifyObserversFunction used to notify the observers of the protocol result.
Returns
true if the directive was enqueued correctly; false otherwise.

Implements alexaClientSDK::settings::SettingProtocolInterface.

◆ clearData()

bool alexaClientSDK::settings::CloudControlledSettingProtocol::clearData ( )
overridevirtual

Clear the data for this setting.

Returns
true if it data is cleared; otherwise.

Implements alexaClientSDK::settings::SettingProtocolInterface.

◆ create()

static std::unique_ptr<CloudControlledSettingProtocol> alexaClientSDK::settings::CloudControlledSettingProtocol::create ( const SettingEventMetadata metadata,
std::shared_ptr< SettingEventSenderInterface eventSender,
std::shared_ptr< storage::DeviceSettingStorageInterface settingStorage,
std::shared_ptr< avsCommon::sdkInterfaces::AVSConnectionManagerInterface connectionManager,
const std::shared_ptr< avsCommon::utils::metrics::MetricRecorderInterface > &  metricRecorder 
)
static

Create a cloud controlled protocol object.

Parameters
metadataSpecifies the parameters used to construct setting changed and report event.
eventSenderObject used to send events to AVS in order to report changes from the device.
settingStorageThe setting storage object.
connectionManagerAn AVSConnectionManagerInterface instance to listen for connection status updates.
metricRecorderAn MetricRecorderInterface instance to log metrics.
Returns
A pointer to the new CloudControlledSettingProtocol object if it succeeds; nullptr otherwise.

◆ localChange()

SetSettingResult alexaClientSDK::settings::CloudControlledSettingProtocol::localChange ( ApplyChangeFunction  applyChange,
RevertChangeFunction  revertChange,
SettingNotificationFunction  notifyObservers 
)
overridevirtual

Implements the protocol for changing a setting value through local UI.

Parameters
applyChangeFunction that can be used to apply the new value.
revertChangeFunction that can be used to revert the change. This function should only be called if the apply change succeeded but some other part of the protocol has failed.
notifyObserversFunction used to notify the observers of the protocol result.
Returns
Returns what was the set result.

Implements alexaClientSDK::settings::SettingProtocolInterface.

◆ restoreValue()

bool alexaClientSDK::settings::CloudControlledSettingProtocol::restoreValue ( ApplyDbChangeFunction  applyChange,
SettingNotificationFunction  notifyObservers 
)
overridevirtual

Implements the protocol for restoring a value from the storage.

Parameters
applyChangeFunction that can be used to apply the value restored from the storage. This function will be called with empty string if no value was found in the database.
notifyObserversFunction used to notify the observers of the protocol result.
Returns
true if the directive was enqueued correctly; false otherwise.

Implements alexaClientSDK::settings::SettingProtocolInterface.


The documentation for this class was generated from the following file:

AlexaClientSDK 3.0.0 - Copyright 2016-2022 Amazon.com, Inc. or its affiliates. All Rights Reserved. Licensed under the Apache License, Version 2.0