Chromium Code Reviews
chromiumcodereview-hr@appspot.gserviceaccount.com (chromiumcodereview-hr) | Please choose your nickname with Settings | Help | Chromium Project | Gerrit Changes | Sign out
(985)

Unified Diff: extensions/common/api/bluetooth_low_energy.idl

Issue 1096393002: API stubs for the BLE advertisement API. (Closed) Base URL: https://chromium.googlesource.com/chromium/src.git@master
Patch Set: Created 5 years, 7 months ago
Use n/p to move between diff chunks; N/P to move between comments. Draft comments are only viewable by you.
Jump to:
View side-by-side diff with in-line comments
Download patch
Index: extensions/common/api/bluetooth_low_energy.idl
diff --git a/extensions/common/api/bluetooth_low_energy.idl b/extensions/common/api/bluetooth_low_energy.idl
index 517a81347820a93e62f2a8a7ac18fcb3c0e289ee..a98643a7da1e53f482705eb925d2bee55a0adebd 100644
--- a/extensions/common/api/bluetooth_low_energy.idl
+++ b/extensions/common/api/bluetooth_low_energy.idl
@@ -13,6 +13,11 @@ namespace bluetoothLowEnergy {
extendedProperties, reliableWrite,
writableAuxiliaries};
+ // Type of advertisement. If 'broadcast' is chosen, the sent advertisement
+ // type will be ADV_NONCONN_IND. If set to 'peripheral', the advertisement
+ // type will be ADV_IND or ADV_SCAN_IND.
+ [nodoc] enum AdvertisementType {broadcast, peripheral};
+
// Represents a peripheral's Bluetooth GATT Service, a collection of
// characteristics and relationships to other services that encapsulate
// the behavior of part of a device.
@@ -114,6 +119,42 @@ namespace bluetoothLowEnergy {
boolean persistent;
};
+ // Represents an entry of the "Manufacturer Specific Data" field of Bluetooth
+ // LE advertisement data.
+ [nodoc] dictionary ManufacturerData {
+ long id;
+ long[] data;
+ };
+
+ // Represents an entry of the "Service Data" field of Bluetooth LE advertisement
+ // data.
+ [nodoc] dictionary ServiceData {
+ DOMString uuid;
+ long[] data;
+ };
+
+ // Represents a Bluetooth LE advertisement instance.
+ [nodoc] dictionary Advertisement {
+ // Type of advertisement.
+ AdvertisementType type;
+
+ // List of UUIDs to include in the "Service UUIDs" field of the Advertising
+ // Data. These UUIDs can be of the 16bit, 32bit or 128 formats.
+ DOMString[]? serviceUuids;
+
+ // List of manufacturer specific data to be included in "Manufacturer Specific
+ // Data" fields of the advertising data.
+ ManufacturerData[]? manufacturerData;
+
+ // List of UUIDs to include in the "Solicit UUIDs" field of the Advertising
+ // Data. These UUIDs can be of the 16bit, 32bit or 128 formats.
+ DOMString[]? solicitUuids;
+
+ // List of service data to be included in "Service Data" fields of the advertising
+ // data.
+ ServiceData[]? serviceData;
+ };
+
callback CharacteristicCallback = void(Characteristic result);
callback CharacteristicsCallback = void(Characteristic[] result);
callback DescriptorCallback = void(Descriptor result);
@@ -121,6 +162,7 @@ namespace bluetoothLowEnergy {
callback ResultCallback = void();
callback ServiceCallback = void(Service result);
callback ServicesCallback = void(Service[] result);
+ callback RegisterAdvertisementCallback = void (long advertisementId);
// These functions all report failures via chrome.runtime.lastError.
interface Functions {
@@ -262,6 +304,29 @@ namespace bluetoothLowEnergy {
static void writeDescriptorValue(DOMString descriptorId,
ArrayBuffer value,
ResultCallback callback);
+
+ // Create an advertisement and register it for advertising. To call this
+ // function, the app must have the bluetooth:low_energy and
scheib 2015/05/06 23:17:41 Mentioning the permissions is good. Can we link to
rkc 2015/05/07 17:16:28 Done.
+ // bluetooth:peripheral permissions set to true.
+ // Note: On some hardware central and peripheral modes at the same time is
+ // supported but on hardware that doesn't support this, making this call
+ // will switch the device to peripheral mode. In the case of hardware which
+ // does not support both central and peripheral mode, attempting to use the
+ // device in both modes will lead to undefined behavior or prevent other
+ // central-role applications from behaving correctly (including the
+ // discovery of Bluetooth Low Energy devices).
+ // |advertisement| : The advertisement to advertise.
+ // |callback| : Called once the registeration is done and we've started
+ // advertising. Returns the id of the created advertisement.
+ [nodoc] static void registerAdvertisement(
+ Advertisement advertisement, RegisterAdvertisementCallback callback);
+
+ // Unregisters an advertisement and stops its advertising.
+ // |advertisementId| : Id of the advertisement to unregister.
+ // |callback| : Called once the advertisement is unregistered and is no
+ // longer being advertised.
+ [nodoc] static void unregisterAdvertisement(long advertisementId,
+ ResultCallback callback);
};
interface Events {

Powered by Google App Engine
This is Rietveld 408576698