OLD | NEW |
| (Empty) |
1 // Copyright (c) 2012 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 CHROME_BROWSER_SYNC_GLUE_DEVICE_INFO_H_ | |
6 #define CHROME_BROWSER_SYNC_GLUE_DEVICE_INFO_H_ | |
7 | |
8 #include <string> | |
9 | |
10 #include "base/basictypes.h" | |
11 #include "base/callback.h" | |
12 #include "sync/protocol/sync.pb.h" | |
13 | |
14 namespace base { | |
15 class DictionaryValue; | |
16 } | |
17 | |
18 namespace browser_sync { | |
19 | |
20 // A class that holds information regarding the properties of a device. | |
21 class DeviceInfo { | |
22 public: | |
23 typedef base::Callback<void(const std::string&)> GetClientNameCallback; | |
24 | |
25 DeviceInfo(const std::string& guid, | |
26 const std::string& client_name, | |
27 const std::string& chrome_version, | |
28 const std::string& sync_user_agent, | |
29 const sync_pb::SyncEnums::DeviceType device_type, | |
30 const std::string& signin_scoped_device_id); | |
31 ~DeviceInfo(); | |
32 | |
33 // Sync specific unique identifier for the device. Note if a device | |
34 // is wiped and sync is set up again this id WILL be different. | |
35 // The same device might have more than 1 guid if the device has multiple | |
36 // accounts syncing. | |
37 const std::string& guid() const; | |
38 | |
39 // The host name for the client. | |
40 const std::string& client_name() const; | |
41 | |
42 // Chrome version string. | |
43 const std::string& chrome_version() const; | |
44 | |
45 // The user agent is the combination of OS type, chrome version and which | |
46 // channel of chrome(stable or beta). For more information see | |
47 // |LocalDeviceInfoProviderImpl::MakeUserAgentForSyncApi|. | |
48 const std::string& sync_user_agent() const; | |
49 | |
50 // Third party visible id for the device. See |public_id_| for more details. | |
51 const std::string& public_id() const; | |
52 | |
53 // Device Type. | |
54 sync_pb::SyncEnums::DeviceType device_type() const; | |
55 | |
56 // Device_id that is stable until user signs out. This device_id is used for | |
57 // annotating login scoped refresh token. | |
58 const std::string& signin_scoped_device_id() const; | |
59 | |
60 // Gets the OS in string form. | |
61 std::string GetOSString() const; | |
62 | |
63 // Gets the device type in string form. | |
64 std::string GetDeviceTypeString() const; | |
65 | |
66 // Compares this object's fields with another's. | |
67 bool Equals(const DeviceInfo& other) const; | |
68 | |
69 // Apps can set ids for a device that is meaningful to them but | |
70 // not unique enough so the user can be tracked. Exposing |guid| | |
71 // would lead to a stable unique id for a device which can potentially | |
72 // be used for tracking. | |
73 void set_public_id(std::string id); | |
74 | |
75 // Converts the |DeviceInfo| values to a JS friendly DictionaryValue, | |
76 // which extension APIs can expose to third party apps. | |
77 base::DictionaryValue* ToValue(); | |
78 | |
79 // Gets the local device name and passes it as a parameter to callback. | |
80 static void GetClientName(const GetClientNameCallback& callback); | |
81 | |
82 private: | |
83 const std::string guid_; | |
84 | |
85 const std::string client_name_; | |
86 | |
87 const std::string chrome_version_; | |
88 | |
89 const std::string sync_user_agent_; | |
90 | |
91 const sync_pb::SyncEnums::DeviceType device_type_; | |
92 | |
93 std::string signin_scoped_device_id_; | |
94 | |
95 // Exposing |guid| would lead to a stable unique id for a device which | |
96 // can potentially be used for tracking. Public ids are privacy safe | |
97 // ids in that the same device will have different id for different apps | |
98 // and they are also reset when app/extension is uninstalled. | |
99 std::string public_id_; | |
100 | |
101 DISALLOW_COPY_AND_ASSIGN(DeviceInfo); | |
102 }; | |
103 | |
104 } // namespace browser_sync | |
105 | |
106 #endif // CHROME_BROWSER_SYNC_GLUE_DEVICE_INFO_H_ | |
OLD | NEW |