Merge pull request rdkcentral#348 from sithanda/R4_4

RDK-48604: New UserSettings Thunder Plugin

interfaces/IUserSettings.h

@@ -0,0 +1,144 @@
+/*
+ * If not stated otherwise in this file or this component's LICENSE file the
+ * following copyright and licenses apply:
+ *
+ * Copyright 2024 RDK Management
+ *
+ * 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 "Module.h"
+
+namespace WPEFramework {
+namespace Exchange {
+ // @json
+struct EXTERNAL IUserSettings : virtual public Core::IUnknown {
+  enum { ID = ID_USER_SETTINGS };
+
+  // @event
+  struct EXTERNAL INotification : virtual public Core::IUnknown {
+    enum { ID = ID_USER_SETTINGS_NOTIFICATION };
+
+    // @brief The AudioDescription setting has changed.
+    // @param enabled: Enabled/Disabled.
+    virtual void OnAudioDescriptionChanged(const bool enabled) = 0;
+
+    // @brief The preferredLanguages setting has changed.
+    // @param preferredLanguages: PreferredLanguages.
+    virtual void OnPreferredAudioLanguagesChanged(const string& preferredLanguages) = 0;
+
+    // @brief The PresentationLanguages setting has changed.
+    // @param presentationLanguages: PresentationLanguages.
+    virtual void OnPresentationLanguageChanged(const string& presentationLanguages) = 0;
+
+    // @brief The Captions setting has changed.
+    // @param enabled: Enabled/Disabled.
+    virtual void OnCaptionsChanged(const bool enabled) = 0;
+
+    // @brief The PreferredCaptionsLanguages setting has changed.
+    // @param preferredLanguages: PreferredLanguages.
+    virtual void OnPreferredCaptionsLanguagesChanged(const string& preferredLanguages) = 0;
+
+    // @brief The PreferredClosedCaptionService setting has changed.
+    // @param service: "CC[1-4]", "TEXT[1-4]", "SERVICE[1-64]".
+    virtual void OnPreferredClosedCaptionServiceChanged(const string& service) = 0;
+  };
+
+  virtual uint32_t Register(Exchange::IUserSettings::INotification* notification /* @in */) = 0;
+  virtual uint32_t Unregister(Exchange::IUserSettings::INotification* notification /* @in */) = 0;
+
+  // @property
+  // @brief Sets AudioDescription ON/OFF. Players should preferred Audio Descriptive tracks over normal audio track when enabled
+  // @param enabled: Enabled/Disabled
+  virtual uint32_t SetAudioDescription(const bool enabled /* @in */) = 0;
+
+  // @property
+  // @brief Gets the current AudioDescription setting
+  // @param enabled: Enabled/Disabled
+  virtual uint32_t GetAudioDescription(bool &enabled /* @out */) const = 0;
+
+  // @property
+  // @brief A prioritized list of ISO 639-2/B codes for the preferred audio languages,
+  // expressed as a comma separated lists of languages of zero of more elements.
+  // The players will pick the audio track that has the best match compared with
+  // this list. In the absence of a matching track, the player should by best
+  // effort select the preferred audio track.*/
+  // @param preferredLanguages: PreferredLanguages
+  virtual uint32_t SetPreferredAudioLanguages(const string& preferredLanguages  /* @in */) = 0;
+
+  // @property  
+  // @brief Gets the current PreferredAudioLanguages setting
+  // @param preferredLanguages: PreferredLanguages
+  virtual uint32_t GetPreferredAudioLanguages(string &preferredLanguages /* @out */) const = 0;
+
+  // @property  
+  // @brief Sets the presentationLanguages in a full BCP 47 value, including script, region, variant
+  // @param presentationLanguages: "en-US", "es-US", "en-CA", "fr-CA"
+  virtual uint32_t SetPresentationLanguage(const string& presentationLanguages /* @in */) = 0;
+
+  // @property  
+  // @brief Gets the presentationLanguages
+  // @param presentationLanguages: "en-US", "es-US", "en-CA", "fr-CA"
+  virtual uint32_t GetPresentationLanguage(string &presentationLanguages /* @out */) const = 0;
+
+  // @property  
+  // @brief brief Sets Captions ON/OFF.
+  // @details A setting of ON indicates that Players should select a subtitle track for presentation
+  // The Setting does not influence any running sessions. It is up to the player to enforce the setting.
+  // This is a global state persisted by the TextTrack plug-in applying to all forms of text; closed captions, Captions
+  // and timed text types.
+  // Media players should to listen to OnCaptionsChanged notifications to react to platform wide dynamic state changes
+  // of this state while a playback is active.
+  // When media players start playback, they should also call the GetCaptions method to retrieve the current enabled state.
+  // This holds true for media players that utilize TextTrack render sessions for text track decode-display and also for media
+  // players or apps that decode-display internally 
+  // @param enabled Sets the state
+  virtual uint32_t SetCaptions(const bool enabled  /* @in */) = 0;
+
+  // @property  
+  // @brief Gets the Captions setting.
+  // @param enabled Receives the state
+  virtual uint32_t GetCaptions(bool &enabled /* @out */) const = 0;
+
+  // @property  
+  // @brief Set preferred languages for captions.
+  // @details A prioritized list of ISO 639-2/B codes for the preferred Captions languages,
+  // expressed as a comma separated lists of languages of zero of more elements.
+  // The players will pick the subtitle track that has the best match compared with
+  // this list. In the absence of a matching track, the player should by best
+  // effort select the preferred subtitle track. 
+  // @param preferredLanguages Is the list to set (e.g. "eng,fra")
+  virtual uint32_t SetPreferredCaptionsLanguages(const string& preferredLanguages  /* @in */) = 0;
+
+  // @property  
+  // @brief Gets the current PreferredCaptionsLanguages setting.
+  // @param preferredLanguages (e.g. "eng,fra")
+  virtual uint32_t GetPreferredCaptionsLanguages(string &preferredLanguages /* @out */) const = 0;
+
+  // @property  
+  // @brief Sets the PreferredClosedCaptionService.
+  // @details The setting should be honored by the player. The behaviour of AUTO may be player specific.
+  // Valid input for service is "CC[1-4]", "TEXT[1-4]", "SERVICE[1-64]" 
+  // @param service Identifies the service to display e.g. "CC3".
+
+  virtual uint32_t SetPreferredClosedCaptionService(const string& service  /* @in */) = 0;
+
+  // @property  
+  // @brief Gets the current PreferredClosedCaptionService setting.
+  // @param service Identifies the service to display e.g. "CC3".
+  virtual uint32_t GetPreferredClosedCaptionService(string &service /* @out */) const = 0;
+};
+} // namespace Exchange
+} // namespace WPEFramework

interfaces/Ids.h

@@ -359,7 +359,10 @@ namespace Exchange {
         ID_SCRIPT_ENGINE_NOTIFICATION                = ID_SCRIPT_ENGINE + 1,
 
         ID_TEXT_TO_SPEECH                            = RPC::IDS::ID_EXTERNAL_INTERFACE_OFFSET + 0x4C0,
-        ID_TEXT_TO_SPEECH_NOTIFICATION               = ID_TEXT_TO_SPEECH + 1
+        ID_TEXT_TO_SPEECH_NOTIFICATION               = ID_TEXT_TO_SPEECH + 1,
+
+        ID_USER_SETTINGS                             = RPC::IDS::ID_EXTERNAL_INTERFACE_OFFSET + 0x4D0,
+        ID_USER_SETTINGS_NOTIFICATION                = ID_USER_SETTINGS + 1
     };
 }
 }