text: // Copyright 2017 The Chromium Authors. All rights reserved.
  // Use of this source code is governed by a BSD-style license that can be
  // found in the LICENSE file.
  
  #ifndef CHROMECAST_BASE_CAST_FEATURES_H_
  #define CHROMECAST_BASE_CAST_FEATURES_H_
  
  #include <cstdint>
  #include <memory>
  #include <string>
  #include <unordered_set>
  #include <vector>
  
  #include "base/feature_list.h"
  
  namespace base {
  class Value;
  }  // namespace base
  
  namespace chromecast {
  
  // Add Cast Features here.
  extern const base::Feature kAllowUserMediaAccess;
  extern const base::Feature kEnableQuic;
  extern const base::Feature kTripleBuffer720;
  extern const base::Feature kSingleBuffer;
  extern const base::Feature kDisableIdleSocketsCloseOnMemoryPressure;
  extern const base::Feature kEnableGeneralAudienceBrowsing;
  extern const base::Feature kEnableSideGesturePassThrough;
  extern const base::Feature kEnableChromeAudioManagerAndroid;
  extern const base::Feature kEnableCastAudioOutputDevice;
  
  // Get an iterable list of all of the cast features for checking all features as
  // a collection.
  const std::vector<const base::Feature*>& GetFeatures();
  
  // Below are utilities needed by the Cast receiver to persist feature
  // information. Client code which is simply querying the status of a feature
  // will not need to use these utilities.
  
  // Initialize the global base::FeatureList instance, taking into account
  // overrides from DCS and the command line. |dcs_features| and
  // |dcs_experiment_ids| are read from the PrefService in the browser process.
  // |cmd_line_enable_features| and |cmd_line_disable_features| should be passed
  // to this function, unmodified from the command line. |extra_enable_features|
  // should contain any extra features to be enabled.
  //
  // This function should be called before the browser's main loop. After this is
  // called, the other functions in this file may be called on any thread.
  // TODO(juke): Keep type info of params by passing in base::flat_map and
  // std::vector instead of base::Value.
  void InitializeFeatureList(const base::Value& dcs_features,
                             const base::Value& dcs_experiment_ids,
                             const std::string& cmd_line_enable_features,
                             const std::string& cmd_line_disable_features,
                             const std::string& extra_enable_features,
                             const std::string& extra_disable_features);
  
  // Determine whether or not a feature is enabled. This replaces
  // base::FeatureList::IsEnabled for Cast builds.
  bool IsFeatureEnabled(const base::Feature& feature);
  
  // Given a dictionary of features, create a copy that is ready to be persisted
  // to disk. Encodes all values as strings,  which is how the FieldTrial
  // classes expect the param data.
  base::Value GetOverriddenFeaturesForStorage(const base::Value& features);
  
  // Query the set of experiment ids set for this run. Intended only for metrics
  // reporting. Must be called after InitializeFeatureList(). May be called on any
  // thread.
  const std::unordered_set<int32_t>& GetDCSExperimentIds();
  
  // Reset static state to ensure clean unittests. For tests only.
  void ResetCastFeaturesForTesting();
  
  // Set the response to GetFeatures(). Calls to this function should
  // be cleaned up by a call to ResetCastFeaturesForTesting() otherwise
  // your test will leak the overridden feature state.
  void SetFeaturesForTest(std::vector<const base::Feature*> features);
  }  // namespace chromecast
  
  #endif  // CHROMECAST_BASE_CAST_FEATURES_H_
  