File: contextual_suggestions_result.h

package info (click to toggle)
chromium-browser 70.0.3538.110-1~deb9u1
  • links: PTS, VCS
  • area: main
  • in suites: stretch
  • size: 1,619,476 kB
  • sloc: cpp: 13,024,755; ansic: 1,349,823; python: 916,672; xml: 314,489; java: 280,047; asm: 276,936; perl: 75,771; objc: 66,634; sh: 45,860; cs: 28,354; php: 11,064; makefile: 10,911; yacc: 9,109; tcl: 8,403; ruby: 4,065; lex: 1,779; pascal: 1,411; lisp: 1,055; awk: 41; jsp: 39; sed: 17; sql: 3
file content (108 lines) | stat: -rw-r--r-- 3,411 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
// Copyright 2018 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 COMPONENTS_NTP_SNIPPETS_CONTEXTUAL_CONTEXTUAL_SUGGESTIONS_RESULT_H_
#define COMPONENTS_NTP_SNIPPETS_CONTEXTUAL_CONTEXTUAL_SUGGESTIONS_RESULT_H_

#include "components/ntp_snippets/contextual/contextual_suggestion.h"

#include <string>
#include <utility>
#include <vector>

#include "base/containers/flat_map.h"

namespace contextual_suggestions {

// Encapsulates conditions under which to show or "peek" the contextual
// suggestions UI.
struct PeekConditions {
  PeekConditions();
  // A measure of confidence that auto-peek should be enabled for this response
  // in the range [0, 1].
  float confidence = 1.0;

  // The percentage of the page that the user scrolls required for an auto
  // peek to occur.
  float page_scroll_percentage;

  // The minimum time (seconds) the user spends on the page required for
  // auto peek.
  float minimum_seconds_on_page;

  // The maximum number of auto peeks that we can show for this page.
  uint64_t maximum_number_of_peeks;
};

// A structure representing a suggestion cluster.
struct Cluster {
  Cluster();
  Cluster(const Cluster&);
  Cluster(Cluster&&) noexcept;
  ~Cluster();

  Cluster& operator=(const Cluster&);

  std::string title;
  std::vector<ContextualSuggestion> suggestions;
};

// Allows concise construction of a cluster.
class ClusterBuilder {
 public:
  explicit ClusterBuilder(const std::string& title);

  // Allow copying for ease of validation when testing.
  ClusterBuilder(const ClusterBuilder& other);
  ClusterBuilder& AddSuggestion(ContextualSuggestion suggestion);
  Cluster Build();

 private:
  Cluster cluster_;
};

// Synthetic field trials driven by the server.
struct ServerExperimentInfo {
  ServerExperimentInfo();
  ServerExperimentInfo(std::string name, std::string group);
  ServerExperimentInfo(const ServerExperimentInfo&);
  ServerExperimentInfo(ServerExperimentInfo&&) noexcept;
  ~ServerExperimentInfo();

  ServerExperimentInfo& operator=(ServerExperimentInfo&&);
  ServerExperimentInfo& operator=(const ServerExperimentInfo&);

  std::string name;
  std::string group;
};

using ServerExperimentInfos = std::vector<ServerExperimentInfo>;

// Struct that holds the data from a ContextualSuggestions response that we care
// about for UI purposes.
struct ContextualSuggestionsResult {
  ContextualSuggestionsResult();
  ContextualSuggestionsResult(std::string peek_text,
                              std::vector<Cluster> clusters,
                              PeekConditions peek_conditions,
                              ServerExperimentInfos experiment_infos);
  ContextualSuggestionsResult(const ContextualSuggestionsResult&);
  ContextualSuggestionsResult(ContextualSuggestionsResult&&) noexcept;
  ~ContextualSuggestionsResult();

  ContextualSuggestionsResult& operator=(ContextualSuggestionsResult&&);
  ContextualSuggestionsResult& operator=(const ContextualSuggestionsResult&);

  std::vector<Cluster> clusters;
  std::string peek_text;
  PeekConditions peek_conditions;
  ServerExperimentInfos experiment_infos;
};

using FetchClustersCallback =
    base::OnceCallback<void(ContextualSuggestionsResult result)>;

}  // namespace contextual_suggestions

#endif  // COMPONENTS_NTP_SNIPPETS_CONTEXTUAL_CONTEXTUAL_SUGGESTIONS_RESULT_H_