File: permission_update_message_controller_android.h

package info (click to toggle)
chromium 138.0.7204.157-1
  • links: PTS, VCS
  • area: main
  • in suites: sid, trixie
  • size: 6,071,864 kB
  • sloc: cpp: 34,936,859; ansic: 7,176,967; javascript: 4,110,704; python: 1,419,953; asm: 946,768; xml: 739,967; pascal: 187,324; sh: 89,623; perl: 88,663; objc: 79,944; sql: 50,304; cs: 41,786; fortran: 24,137; makefile: 21,806; php: 13,980; tcl: 13,166; yacc: 8,925; ruby: 7,485; awk: 3,720; lisp: 3,096; lex: 1,327; ada: 727; jsp: 228; sed: 36
file content (91 lines) | stat: -rw-r--r-- 3,834 bytes parent folder | download | duplicates (4)
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
// Copyright 2021 The Chromium Authors
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.

#ifndef CHROME_BROWSER_PERMISSIONS_PERMISSION_UPDATE_MESSAGE_CONTROLLER_ANDROID_H_
#define CHROME_BROWSER_PERMISSIONS_PERMISSION_UPDATE_MESSAGE_CONTROLLER_ANDROID_H_

#include <string>
#include <vector>

#include "base/functional/callback.h"
#include "chrome/browser/permissions/permission_update_message_delegate_android.h"
#include "components/content_settings/core/common/content_settings_types.h"
#include "content/public/browser/web_contents_user_data.h"

namespace content {
class WebContents;
}

// A message controller to be used for requesting missing Android runtime
// permissions for previously allowed ContentSettingsTypes.
// This class exists to hold strong pointers to pending
// |PermissionUpdateMessageDelegate| instances.
// Message UI is an alternative ui to infobars.
class PermissionUpdateMessageController
    : public content::WebContentsUserData<PermissionUpdateMessageController> {
 public:
  // Creates a message to resolve conflicts in Android runtime permissions.
  //
  // This function can only be called with |content_settings_types| as follow:
  // // ContentSettingsType::MEDIASTREAM_MIC,
  // ContentSettingsType::MEDIASTREAM_CAMERA,
  // ContentSettingsType::GEOLOCATION, or
  // ContentSettingsType::AR or with both
  // ContentSettingsType::MEDIASTREAM_MIC and
  // ContentSettingsType::MEDIASTREAM_CAMERA.
  //
  // The |callback| will not be triggered if `this` is deleted.
  void ShowMessage(
      const std::vector<ContentSettingsType>& content_settings_types,
      const std::vector<ContentSettingsType>& filtered_content_settings_types,
      const std::vector<std::string>& required_permissions,
      const std::vector<std::string>& optional_permissions,
      PermissionUpdatedCallback callback);

  void ShowMessage(const std::vector<std::string>& required_android_permissions,
                   int permission_icon_id,
                   int permission_msg_title_id,
                   int permission_msg_description_id,
                   PermissionUpdatedCallback callback);

  ~PermissionUpdateMessageController() override;

 private:
  friend class content::WebContentsUserData<PermissionUpdateMessageController>;
  friend class PermissionUpdateMessageControllerAndroidTest;
  explicit PermissionUpdateMessageController(
      content::WebContents* web_contents);
  void ShowMessageInternal(
      const std::vector<std::string>& required_android_permissions,
      const std::vector<std::string>& optional_android_permissions,
      const std::vector<ContentSettingsType> content_settings_types,
      int icon_id,
      int title_id,
      int description_id,
      PermissionUpdatedCallback callback);
  void DeleteMessage(PermissionUpdateMessageDelegate* delegate);

  // This function determines the expected drawables and string based on
  // given content setting types and populates the required permissions
  // and optional permissions in the meantime.
  // Returns a tuple composed of icon drawable id, title string id and
  // description string id.
  //
  // This function can only be called with one of
  // ContentSettingsType::MEDIASTREAM_MIC,
  // ContentSettingsType::MEDIASTREAM_CAMERA,
  // ContentSettingsType::GEOLOCATION, or
  // ContentSettingsType::AR or with both
  // ContentSettingsType::MEDIASTREAM_MIC and
  // ContentSettingsType::MEDIASTREAM_CAMERA.
  std::tuple<int, int, int> GetPermissionUpdateUiResourcesId(
      const std::vector<ContentSettingsType>& content_settings_types);

  std::vector<std::unique_ptr<PermissionUpdateMessageDelegate>>
      message_delegates_;

  WEB_CONTENTS_USER_DATA_KEY_DECL();
};

#endif  // CHROME_BROWSER_PERMISSIONS_PERMISSION_UPDATE_MESSAGE_CONTROLLER_ANDROID_H_