summaryrefslogtreecommitdiffstats
path: root/chrome/common/extensions/api/signed_in_devices.idl
blob: 6a56ee3fd25a7db43913b405ff952cc6241b9497 (plain)
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
// Copyright (c) 2013 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.

// Use the <code>chrome.signedInDevices</code> API to get a list of devices
// signed into chrome with the same account as the current profile.
namespace signedInDevices {
  enum OS {
    win,
    mac,
    linux,
    chrome_os,
    android,
    ios,
    unknown
  };

  enum DeviceType {
    desktop_or_laptop,
    phone,
    tablet,
    unknown
  };

  dictionary DeviceInfo {
    // Name of the device. This name is usually set by the user
    // when setting up a device.
    DOMString name;

    // Unique Id for this device. Note: The id is meaningful only
    // in the current device. This id cannot be used to refer to the
    // same device from another device or extension.
    DOMString id;

    // The OS of the device.
    OS os;

    // Device Type.
    DeviceType type;

    // Version of chrome running in this device.
    DOMString chromeVersion;
  };

  callback DeviceInfoCallback = void(DeviceInfo[] devices);

  interface Functions {
    // Gets the array of signed in devices, signed into the same account
    // as the current profile.
    // |isLocal|: If true only return the information for the local device. If
    // false or omitted return the list of all devices including the local
    // device.
    // |callback|: The callback to be invoked with the array of DeviceInfo
    // objects.
    static void get(optional boolean isLocal, DeviceInfoCallback callback);
  };

  interface Events {
    // Fired if the DeviceInfo object of any of the signed in devices
    // change or a new device is added or a device removed.
    // |callback|: The callback to be invoked with the array of DeviceInfo
    // objects.
    static void onDeviceInfoChange(DeviceInfo[] devices);
  };
};