| OLD | NEW |
| (Empty) |
| 1 // Copyright (c) 2013 The Chromium Authors. All rights reserved. | |
| 2 // Use of this source code is governed by a BSD-style license that can be | |
| 3 // found in the LICENSE file. | |
| 4 | |
| 5 #ifndef ASH_SESSION_STATE_DELEGATE_H_ | |
| 6 #define ASH_SESSION_STATE_DELEGATE_H_ | |
| 7 | |
| 8 #include <string> | |
| 9 #include <vector> | |
| 10 | |
| 11 #include "ash/ash_export.h" | |
| 12 #include "base/strings/string16.h" | |
| 13 | |
| 14 namespace aura { | |
| 15 class Window; | |
| 16 } // namespace aura | |
| 17 | |
| 18 namespace content { | |
| 19 class BrowserContext; | |
| 20 } | |
| 21 | |
| 22 namespace gfx { | |
| 23 class ImageSkia; | |
| 24 } // namespace gfx | |
| 25 | |
| 26 namespace ash { | |
| 27 | |
| 28 class SessionStateObserver; | |
| 29 | |
| 30 // The index for the multi-profile item to use. The list is always LRU sorted | |
| 31 // So that the index #0 is the currently active user. | |
| 32 typedef int MultiProfileIndex; | |
| 33 | |
| 34 // A list of user_id. | |
| 35 typedef std::vector<std::string> UserIdList; | |
| 36 | |
| 37 // Delegate for checking and modifying the session state. | |
| 38 // TODO(oshima): Replace MultiProfileIndex with BrowsreContext, bacause | |
| 39 // GetUserXXX are useful for non multi profile scenario in ash_shell. | |
| 40 class ASH_EXPORT SessionStateDelegate { | |
| 41 public: | |
| 42 // Defines the cycle direction for |CycleActiveUser|. | |
| 43 enum CycleUser { | |
| 44 CYCLE_TO_NEXT_USER = 0, // Cycle to the next user. | |
| 45 CYCLE_TO_PREVIOUS_USER, // Cycle to the previous user. | |
| 46 }; | |
| 47 | |
| 48 // Defines session state i.e. whether session is running or not and | |
| 49 // whether user session is blocked by things like multi-profile login. | |
| 50 enum SessionState { | |
| 51 // When primary user login UI is shown i.e. after boot or sign out, | |
| 52 // no active user session exists yet. | |
| 53 SESSION_STATE_LOGIN_PRIMARY = 0, | |
| 54 | |
| 55 // Inside user session (including lock screen), | |
| 56 // no login UI (primary or multi-profiles) is shown. | |
| 57 SESSION_STATE_ACTIVE, | |
| 58 | |
| 59 // When secondary user login UI is shown i.e. other users are | |
| 60 // already logged in and is currently adding another user to the session. | |
| 61 SESSION_STATE_LOGIN_SECONDARY, | |
| 62 }; | |
| 63 | |
| 64 virtual ~SessionStateDelegate() {}; | |
| 65 | |
| 66 // Returns the browser context for the user given by |index|. | |
| 67 virtual content::BrowserContext* GetBrowserContextByIndex( | |
| 68 MultiProfileIndex index) = 0; | |
| 69 | |
| 70 // Returns the browser context associated with the window. | |
| 71 virtual content::BrowserContext* GetBrowserContextForWindow( | |
| 72 aura::Window* window) = 0; | |
| 73 | |
| 74 // Returns the maximum possible number of logged in users. | |
| 75 virtual int GetMaximumNumberOfLoggedInUsers() const = 0; | |
| 76 | |
| 77 // Returns the number of signed in users. If 0 is returned, there is either | |
| 78 // no session in progress or no active user. | |
| 79 virtual int NumberOfLoggedInUsers() const = 0; | |
| 80 | |
| 81 // Returns |true| if the session has been fully started for the active user. | |
| 82 // When a user becomes active, the profile and browser UI are not immediately | |
| 83 // available. Only once this method starts returning |true| is the browser | |
| 84 // startup complete and both profile and UI are fully available. | |
| 85 virtual bool IsActiveUserSessionStarted() const = 0; | |
| 86 | |
| 87 // Returns true if the screen can be locked. | |
| 88 virtual bool CanLockScreen() const = 0; | |
| 89 | |
| 90 // Returns true if the screen is currently locked. | |
| 91 virtual bool IsScreenLocked() const = 0; | |
| 92 | |
| 93 // Returns true if the screen should be locked when the system is about to | |
| 94 // suspend. | |
| 95 virtual bool ShouldLockScreenBeforeSuspending() const = 0; | |
| 96 | |
| 97 // Locks the screen. The locking happens asynchronously. | |
| 98 virtual void LockScreen() = 0; | |
| 99 | |
| 100 // Unlocks the screen. | |
| 101 virtual void UnlockScreen() = 0; | |
| 102 | |
| 103 // Returns |true| if user session blocked by some overlying UI. It can be | |
| 104 // login screen, lock screen or screen for adding users into multi-profile | |
| 105 // session. | |
| 106 virtual bool IsUserSessionBlocked() const = 0; | |
| 107 | |
| 108 // Returns current session state. | |
| 109 virtual SessionState GetSessionState() const = 0; | |
| 110 | |
| 111 // Gets the displayed name for the user with the given |index|. | |
| 112 // Note that |index| can at maximum be |NumberOfLoggedInUsers() - 1|. | |
| 113 virtual const base::string16 GetUserDisplayName( | |
| 114 MultiProfileIndex index) const = 0; | |
| 115 | |
| 116 // Gets the given name of the user with |index|. An empty string can be | |
| 117 // returned if the given name of the user is unknown. | |
| 118 // Note that |index| can at maximum be |NumberOfLoggedInUsers() - 1|. | |
| 119 virtual const base::string16 GetUserGivenName( | |
| 120 MultiProfileIndex index) const = 0; | |
| 121 | |
| 122 // Gets the display email address for the user with the given |index|. | |
| 123 // The display email address might contains some periods in the email name | |
| 124 // as well as capitalized letters. For example: "Foo.Bar@mock.com". | |
| 125 // Note that |index| can at maximum be |NumberOfLoggedInUsers() - 1|. | |
| 126 virtual const std::string GetUserEmail(MultiProfileIndex index) const = 0; | |
| 127 | |
| 128 // Gets the user id (sanitized email address) for the user with the given | |
| 129 // |index|. The function would return something like "foobar@mock.com". | |
| 130 // Note that |index| can at maximum be |NumberOfLoggedInUsers() - 1|. | |
| 131 virtual const std::string GetUserID(MultiProfileIndex index) const = 0; | |
| 132 | |
| 133 // Gets the avatar image for the user associated with the |context|. | |
| 134 virtual const gfx::ImageSkia& GetUserImage( | |
| 135 content::BrowserContext* context) const = 0; | |
| 136 | |
| 137 // Whether or not the window's title should show the avatar. | |
| 138 virtual bool ShouldShowAvatar(aura::Window* window) = 0; | |
| 139 | |
| 140 // Switches to another active user with |user_id| | |
| 141 // (if that user has already signed in). | |
| 142 virtual void SwitchActiveUser(const std::string& user_id) = 0; | |
| 143 | |
| 144 // Switches the active user to the next or previous user, with the same | |
| 145 // ordering as GetLoggedInUsers. | |
| 146 virtual void CycleActiveUser(CycleUser cycle_user) = 0; | |
| 147 | |
| 148 // Adds or removes sessions state observer. | |
| 149 virtual void AddSessionStateObserver(SessionStateObserver* observer) = 0; | |
| 150 virtual void RemoveSessionStateObserver(SessionStateObserver* observer) = 0; | |
| 151 }; | |
| 152 | |
| 153 } // namespace ash | |
| 154 | |
| 155 #endif // ASH_SESSION_STATE_DELEGATE_H_ | |
| OLD | NEW |