Host fingerprint mojo service within the device service.

services/device/public/interfaces/fingerprint.mojom

Index: services/device/public/interfaces/fingerprint.mojom
diff --git a/services/device/public/interfaces/fingerprint.mojom b/services/device/public/interfaces/fingerprint.mojom
new file mode 100644
index 0000000000000000000000000000000000000000..32c6d5a1874d58e6c9736f9c5b239b1003c19f5d
--- /dev/null
+++ b/services/device/public/interfaces/fingerprint.mojom
@@ -0,0 +1,60 @@
+// Copyright 2017 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.
+
+module device.mojom;
+
+// Interface for obeserving biod signals.

[blundell, 2017/02/23 14:10:41]

It's a little strange that we're putting a ChromeOS-specific interface in the
Device Service (as opposed to a generic interface that at the present time only
has a ChromeOS implementation). Can you add a comment at the top of this file
that says something like:

"This interface is ChromeOS-specific (e.g., the references to Biod). If it is
ever desired to support a more general fingerprint service across more
platforms, the interface would need to be generalized." 

+interface BiodObserver{
+  // Called when biometics device powers up or is restarted.
+  OnRestarted();
+
+  // Called whenever a user attempts a scan. |scan_result| tells whether the
+  // scan was succesful. |is_complete| tells whether enrollment is complete
+  // and now over.
+  OnScanned(uint32 scan_result, bool is_complete);
+
+  // Called to indicate a bad scan of any kind, or a succesful scan. If scan
+  // is successful, |recognized_user_ids| will equal all the enrollment IDs
+  // that match the scan.
+  OnAttempt(uint32 scan_result, array<string> recognized_user_ids);
+
+  // Called during either mode to indicate a failure. Any enrollment that was
+  // underway is thrown away and authentication will no longer be happening.
+  OnFailure();
+};
+
+// Interface for communicating with biod through dbus.
+interface Fingerprint {
+  // Gets all the enrollments registered with this biometric.
+  GetFingerprintsList() => (array<string> enrollments);
+
+  // Starts the biometric enrollment.
+  StartEnroll(string user_id, string label);
+
+  // Ends the current enroll.
+  CancelCurrentEnroll();
+
+  // Gets label of the enrollment.
+  GetLabel(int32 index) => (string label);
+
+  // Changes the label of the enrollment to |label|.
+  SetLabel(string label, int32 index);
+
+  // Removes the enrollment. This enrollment will no longer
+  // be able to used for authentication.
+  RemoveEnrollment(int32 index);
+
+  // Starts the biometric authentication.
+  StartAuthentication();
+
+  // Ends the current autentication.
+  EndCurrentAuthentication();
+
+  // Irreversibly destroys all enrollments registered with this biometric.
+  DestroyAllEnrollments();
+
+  // Adds biod observers and notifies them when receiving signals.
+  AddBiodObserver(BiodObserver observer);
+};
+