Web Bluetooth

1. はじめに

このセクションは参考です。

Bluetoothは、機器間の短距離無線通信規格の1つです。クラシックBluetooth ( BR / EDR ) では、バイナリプロトコルの組を定義し、最大約24Mbpsの通信速度をサポートしています。 Bluetooth4.0 では Bluetooth Smart( BLE または LE ) と呼ばれる「省電力」モードが新たに導入されました。 通信速度は1Mbpsに制限されますが、ほとんどの時間は送信機の電源を切ったままにすることができます。 BLEでは、機能の大半を Generic Attribute Profile( GATT ) によるキー/バリューのペアで提供しています。

BLEでは、機器が行う複数の役割を定義しています。Broadcaster と Ovserver の役割 は、それぞれ送信専用、受信専用のアプリケーションです。 Peripheral の役割で動作するデバイスは接続を受信し、Central の役割で動作するデバイスは Peripheral 機器と接続できます。

Peripheral または Central の役割で動作しているデバイスは、GATT server のホストになることが可能で、サーバーは、Service、Characteristic、Descriptor という階層になっています。この階層について、詳しくは §5.1 GATT Information Model を参照してください。BLEトランスポートをサポートするよう設計されていますが、GATTプロトコルはBR/EDRトランスポートでも動作します。

本仕様書の初版では、Central の役割を持つUAで実行すれば、ウェブページが BR/EDR または LEコネクション 経由で GATT server と接続できます。本仕様書では BLUETOOTH42 の仕様書を引用しますが、Bluetooth 4.0 or 4.1 だけ実装したデバイス間通信もサポートする予定です。

let chosenHeartRateService = null;

navigator.bluetooth.requestDevice({
  filters: [{
    services: ['heart_rate'],
  }]
}).then(device => device.gatt.connect())
.then(server => server.getPrimaryService('heart_rate'))
.then(service => {
  chosenHeartRateService = service;
  return Promise.all([
    service.getCharacteristic('body_sensor_location')
      .then(handleBodySensorLocationCharacteristic),
    service.getCharacteristic('heart_rate_measurement')
      .then(handleHeartRateMeasurementCharacteristic),
  ]);
});

function handleBodySensorLocationCharacteristic(characteristic) {
  if (characteristic === null) {
    console.log("Unknown sensor location.");
    return Promise.resolve();
  }
  return characteristic.readValue()
  .then(sensorLocationData => {
    let sensorLocation = sensorLocationData.getUint8(0);
    switch (sensorLocation) {
      case 0: return 'Other';
      case 1: return 'Chest';
      case 2: return 'Wrist';
      case 3: return 'Finger';
      case 4: return 'Hand';
      case 5: return 'Ear Lobe';
      case 6: return 'Foot';
      default: return 'Unknown';
    }
  }).then(location => console.log(location));
}

function handleHeartRateMeasurementCharacteristic(characteristic) {
  characteristic.addEventListener('characteristicvaluechanged', onHeartRateChanged);
  return characteristic.startNotifications();
}

function onHeartRateChanged(event) {
  let characteristic = event.target;
  console.log(parseHeartRate(characteristic.value));
}

function parseHeartRate(data) {
  let flags = data.getUint8(0);
  let rate16Bits = flags & 0x1;
  let result = {};
  let index = 1;
  if (rate16Bits) {
    result.heartRate = data.getUint16(index, /*littleEndian=*/true);
    index += 2;
  } else {
    result.heartRate = data.getUint8(index);
    index += 1;
  }
  let contactDetected = flags & 0x2;
  let contactSensorPresent = flags & 0x4;
  if (contactSensorPresent) {
    result.contactDetected = !!contactDetected;
  }
  let energyPresent = flags & 0x8;
  if (energyPresent) {
    result.energyExpended = data.getUint16(index, /*littleEndian=*/true);
    index += 2;
  }
  let rrIntervalPresent = flags & 0x10;
  if (rrIntervalPresent) {
    let rrIntervals = [];
    for (; index + 1 < data.byteLength; index += 2) {
      rrIntervals.push(data.getUint16(index, /*littleEndian=*/true));
    }
    result.rrIntervals = rrIntervals;
  }
  return result;
}

{
  heartRate: 70,
  contactDetected: true,
  energyExpended: 750,     // Meaning 750kJ.
  rrIntervals: [890, 870]  // Meaning .87s and .85s.
}

function resetEnergyExpended() {
  if (!chosenHeartRateService) {
    return Promise.reject(new Error('No heart rate sensor selected yet.'));
  }
  return chosenHeartRateService.getCharacteristic('heart_rate_control_point')
  .then(controlPoint => {
    let resetEnergyExpended = new Uint8Array([1]);
    return controlPoint.writeValue(resetEnergyExpended);
  });
}

2. セキュリティとプライバシーへの配慮

3. デバイスの検索

dictionary BluetoothRequestDeviceFilter {
  sequence<BluetoothServiceUUID> services;
  DOMString name;
  DOMString namePrefix;
};

dictionary RequestDeviceOptions {
  required sequence<BluetoothRequestDeviceFilter> filters;
  sequence<BluetoothServiceUUID> optionalServices = [];
};

interface Bluetooth {
  [SecureContext]
  readonly attribute BluetoothDevice? referringDevice;
  [SecureContext]
  Promise<BluetoothDevice> requestDevice(RequestDeviceOptions options);
};
Bluetooth implements EventTarget;
Bluetooth implements BluetoothDeviceEventHandlers;
Bluetooth implements CharacteristicEventHandlers;
Bluetooth implements ServiceEventHandlers;

navigator.bluetooth.requestDevice({
  filters: [ {services: [A, B]} ]
});

navigator.bluetooth.requestDevice({
  filters: [
    {services: [A, B]},
    {services: [C, D]}
  ]
});

navigator.bluetooth.requestDevice({
  filters: [ {services: [A, B]} ],
  optionalServices: [E]
});

[{name: "Unique Name"}]

[{namePrefix: "Device"}]

[{name: "First De"},
 {name: "First Device"}]

[{namePrefix: "First"},
 {name: "Unique Name"}]

[{services: [C],
  namePrefix: "Device"},
 {name: "Unique Name"}]

[]

[{}]

[{namePrefix: ""}]

Bluetooth のインスタンスは、以下のテーブルで説明される内部スロットを用いて生成されます：

navigator.bluetooth.referringDevice を取得するには、[[referringDevice]] を必ず返さなければなりません。

いくつかの UA は、ユーザが Bluetooth device に応答して navigate するブラウジングコンテキスト( browsing context )を引き起こすことを可能にします。 例えば、Eddystone ビーコンは、URLをアドバタイズした場合、 UA は、ユーザがこの URL に移動することを可能にします。 これが発生した場合、新しい Document オブジェクトの初期化の一環として、UA は以下のステップを実行しなければなりません。：

1. referringDevice を navigation を発生させたデバイスにします。
2. navigator.bluetooth 内部の referringDevice を表す BluetoothDevice を取得し、referringDeviceObj を結果にします。
3. 以前のステップで例外をスローした場合、以下のステップを中止します。

   注記: これは、UA は、ユーザが referringDevice に現在の realm のアクセス件を承諾するであろうと推測していなかったことを意味します。例えば、ユーザはグローバルに GATT へのアクセスを拒否された可能性があります。

4. navigator.bluetooth@[[referringDevice]] を referringDeviceObj にセットします。

以下のステップで match が返された場合、Bluetooth device は filter#matches-a-filterReferenced in:3. Device Discovery (2) (3) にマッチします。：

1. filter.name が存在し、device の Bluetooth Device Name が完全ではなく、filter.name と一致しない場合、mismatch を返します。
2. filter.namePrefix が存在し、device の Bluetooth Device Name が存在しないまたは filter.namePrefix で始まらない場合、mismatch を返します。
3. filter.services の各 uuid に対して、デバイスが UUID uuid を持つプライマリ(含まれているのではなく)サービスのサポートを示しているアドバタイジングデータ、拡張要求応答( extended inquiry response ) または サービス検索応答( service discovery response ) を UAが受信していない場合、mismatch を返します。
4. match を返します。

デバイスがアドバタイズする Service UUID のリストには、デバイスがサポートする全ての UUID が含まれない場合があります。アドバタイズされるデータは、リストが完全かどうか指定します。ウェブサイトは、近隣のデバイスがサポートはするがアドバタイズしない UUID をフィルターする場合、そのデバイスはユーザに提供されるデバイスリストには含まれていない可能性があります。サポートサービスの完全なリストを検索するため、UA はデバイスと接続する必要がありますが、無線性能の劣化や遅延が起こり得るため本仕様では要求していません。

requestDevice(options) メソッドは、呼び出されると新しい promise promise を返し、同時に以下のステップを実行しなければなりません。：

1. options.filters と options.optionalServices を渡しながら Bluetooth devices をリクエストし、devices を結果にします。
2. 以前のステップで例外をスローした場合、その例外とともに promise を reject し、以下のステップを中止します。
3. devices[0] とともに promise を Resolve します。

Bluetooth devices をリクエストするには、BluetoothRequestDeviceFilter のシーケンス、 filters、BluetoothServiceUUID のシーケンス、および optionalServices が与えられると、UA は以下のステップを実行しなけれなばりません。：

このアルゴリズムの呼び出しは、最終的に複数のデバイスをリクエストできるようになりますが、今のところは単一のデバイスのみを返します。

1. アルゴリズムがユーザの動作によって引き起こされていない場合は、SecurityError をスローし、以下のステップを中止します。
2. service 名とエイリアスからただの UUID に引数を変換するために、以下のサブステップを実行します。：
   1. filters.length === 0 の場合、TypeError をスローし、以下のステップを中止します。
   2. uuidFilters を新しい Array に、requiredServiceUUIDs を新しい Set にします。
   3. filters の各 filter に対して、以下のサブステップを実行します:
      1. filterのservices、name、namePrefix メンバーがいずれも存在しない場合、TypeError をスローし、以下のステップを中止します。
      2. canonicalizedFilter を {} にします。
      3. filter.services が存在する場合、以下のサブステップを実行します。：
         1. filter.services.length === 0 の場合、TypeError をスローし、以下のステップを中止します。
         2. services を Array.prototype.map.call(filter.services, BluetoothUUID.getService) にします。
         3. BluetoothUUID.getService() で例外が発生した場合、例外をスローし、ステップを中止します。
         4. services の service のいずれかが blacklisted の場合、SecurityError をスローし、ステップを中止します。
         5. canonicalizedFilter.services を services にセットします。
         6. services のエレメントを requiredServiceUUIDs に追加します。
      4. filter.name が存在する場合、以下のサブステップを実行します。
         1. filter.name の UTF-8 encoding が248バイトを超える場合、TypeError をスローし、以下のステップを中止します。

            248バイト は Bluetooth Device Name の UTF-8コードユニットの最大値です。

         2. canonicalizedFilter.name を filter.name にセットします。
      5. filter.namePrefix が存在する場合、以下のサブステップを実行します。
         1. filter.namePrefix.length === 0 または filter.namePrefix の UTF-8 encoding が248バイトを超える場合、TypeError をスローし、以下のステップを中止します。

            248バイト は Bluetooth Device Name の UTF-8コードユニットの最大値です。

         2. canonicalizedFilter.namePrefix を filter.namePrefix にセットします。
      6. canonicalizedFilter を uuidFilters にアペンドします。
   4. optionalServiceUUIDs を Array.prototype.map.call(optionalServices, BluetoothUUID.getService) にします。
   5. BluetoothUUID.getService() で例外が発生した場合、例外をスローし、以下のステップを中止します。
   6. optionalServiceUUIDs からblacklisted となっている UUID を削除します。
3. descriptor はこのようになります。

   {
     name: "bluetooth",
     filters: uuidFilters,
     optionalServices: optionalServiceUUIDs,
   }
   

4. requiredServiceUUIDs を Service UUID の集合として持つデバイスをスキャンし、scanResult をその結果とします。
5. uuidFilters でフィルターにマッチしない場合、デバイスを scanResult から削除します。
6. scanResult が空の場合であっても、descriptor に関連付けられた scanResult 内のデバイスのいずれかを選択するようにユーザを促し、device を結果にします。

   UA は、uuidFilters にマッチしない、近隣のデバイスをユーザーが選択できる場合があります。


   UA は、ユーザに書くデバイスの人間に可読な名前を表示する必要があります。例えば、この名前が使用不可の場合、UA の Bluetooth システムはプライバシーを有効にして実行するスキャンをサポートしていないため、UA は、ユーザが関心を示すことを許可します。また、名前を取得するために、プライバシーを無効にしてスキャンを実行する必要があります。

7. device が "denied" の場合、[] を返し、以下のステップを中止します。
8. device を選択することは、おそらく、ユーザが、少なくとも、現在の設定オブジェクト( current settings object ) の "bluetooth" の追加パーミッションデータ( extra permission data ) の許可されたデバイスリスト( allowedDevices list ) に表示するようにしていることを示しています。そして、requiredServiceUUIDs と optionalServiceUUIDs の和集合内の全ての service を、すでに存在している任意の service に加えて、その許可されたデバイスリスト( allowedServices )に表示するようにしていることを示しています。
9. UA は device 内の全ての Service とともに Bluetooth cache を格納することができます。このステップでのエラーは無視します。
10. device 内の コンテキストオブジェクト( context object )を表す BluetoothDevice を取得し、任意の例外を伝搬させ、deviceObj を結果とします。
11. [deviceObj] を返します。

オプションの Service UUID のセット(デフォルトは全UUIDの集合)を用いてデバイスのスキャンをするには、UA は以下のステップを実行しなければなりません。：

1. UA が最近デバイスをスキャンしたことがある場合、TODO: 時間の分量を確定させる。 現在のスキャン用の UUID のスーパーセットである UUID の集合を用いてスキャンしている場合、UAはそのスキャン結果を返し、ステップを中止することができます。
2. nearbyDevices を Bluetooth device の集合とし、初期値は空です。
3. UA が LE トランスポートをサポートする場合、General Discovery Procedure を実行し、発見した Bluetooth device を nearbyDevices に追加します。UA はPrivacy Feature を有効にする必要があります。

   passive scanning と Privacy Feature の両方で、ユニークかつ変更不可能なデバイスIDのリークを防止しています。どちらかを使用するよう UA に要求すべきですが、OS API にはどちらも公開するものがなさそうです。またBluetoothは passive scanning の使用が難しくなっています。Central デバイスが Observation Procedure をサポートする必要がないからです。

4. UA が BR/EDR トランスポートをサポートする場合、Device Discovery Procedure を実行し、発見した Bluetooth device を nearbyDevices に追加します。

   BR/EDR inquiry/discovery の全形式で、ユニークかつ変更不可能なアドレスがリークするようです。

5. result を Bluetooth device の集合とし、初期値は空です。
6. nearbyDevices の各 Bluetooth device device に対して以下のサブステップを実行します。：
   1. device の サポートされた物理トランスポート( supported physical transports )に LE が含まれ、その Bluetooth Device Name が部分的にしか存在しないまたは存在しない場合、UA は完全な名前を取得するために Name Discovery Procedure を実行する必要があります。
   2. アドバタイズされた device の Service UUID が Service UUID の集合 と空でない共通部分がある場合、device を result に追加し、以下のサブステップを中止します。

      BR/EDRデバイスについて、拡張問合せ応答（ Extended Inquiry Response ）で GATT と non-GATT services を区別する方法はありません。あるサイトが non-GATT service の UUID にフィルターする場合、ユーザーは、本APIが交信する方法を持たないrequestDevice の結果としてデバイスを選択できる可能性があります。 


   3. UA は、device に接続し、Service UUID の集合にある全サービスを Bluetooth cache に格納 することができます。 device がサポートする物理トランスポート( supported physical transports ) に BR/EDR が含まれる場合、UA は standard GATT procedures に加え、キャッシュ格納時にサービス探索プロトコル( Service Discovery Protocol [Searching for Services] )を使用できます。

      近隣の全デバイスに接続するサービス検索は、電力を消費し、Bluetooth無線の他の利用を遅くする可能性があります。デバイスに関心が期待できる何かの理由があれば、UA はあるデバイスの特別なサービスだけを検索をすべきです。

      また UA は、開発者がこの特別な検索方法への依存を避けられるようにしなければなりません。例えば、開発者が以前あるデバイスに接続していれば、その UA はデバイスでサポートされるサービスをフルセットで知っています。そして、開発者が non-advertised UUID を用いてフィルターすれば、フィルターがユーザーのマシンでこのデバイスを除外しそうな場合でも、ダイアログにこのデバイスを含むことができます。このような場合、UA は、警告を出すかフィルターにマッチする時にアドバタイズされた service だけを含める、というオプションを開発者に提供できます。


   4. Bluetooth cache が Service UUID 集合に、UUID を持ったデバイス内部の known-present service を含んでいる場合、UA は device を result に追加できます。
7. スキャンから result を返します。

興味のあるデバイスが圏内に来た時に、イベントを受信するためサイトを登録する方法が必要になります。

3.1. Permission API Integration

この [permissions] API は、ウェブサイトが持っている権限を、ユーザやクエリーからリクエストするための統一的な方法を提供します。

navigator.permissions.request({
  name: "bluetooth",
  filters: [{
    services: ['heart_rate'],
  }]
}).then(result => {
  if (result.devices.length > 1) {
    return result.devices[0];
  } else {
    throw new DOMException("Chooser cancelled", "NotFoundError");
  }
}).then(device => {
  sessionStorage.lastDevice = device.id;
});

navigator.permissions.query({
  name: "bluetooth",
  deviceId: sessionStorage.lastDevice,
}).then(result => {
  if (result.devices.length > 1) {
    return result.devices[0];
  } else {
    throw new DOMException("Lost permission", "NotFoundError");
  }
}).then(...);

"bluetooth" の 強力な特徴である、パーミッションが関連するアルゴリズムおよびタイプは以下のように定義されています。：

permission descriptor type

dictionary BluetoothPermissionDescriptor : PermissionDescriptor {
  DOMString deviceId;
  // These match RequestDeviceOptions.
  sequence<BluetoothRequestDeviceFilter> filters;
  sequence<BluetoothServiceUUID> optionalServices = [];
};

extra permission data type

BluetoothPermissionData は以下のように定義されています。：

dictionary AllowedBluetoothDevice {
  required DOMString deviceId;
  // An allowedServices of "all" means all services are allowed.
  required (DOMString or sequence<UUID>) allowedServices;
};
dictionary BluetoothPermissionData {
  required sequence<AllowedBluetoothDevice> allowedDevices = [];
};

AllowedBluetoothDevice インスタンスは Bluetooth device を有する 内部スロット [[device]] を持っています。

allowedDevices の個別の要素は、異なる [[device]] および、異なる deviceId を持っている必要があります。

deviceId は、サイトに、 BluetoothDevice インスタンスと同一インスタンスを表す BluetoothDevice インスタンスの追跡を許可します、おそらく異なる realm です。 UA は、"bluetooth" の extra permission data を返す時に、起こることまたは起きないことを、ユーザーが追跡しようとするかどうか、 を検討する必要があります。

例えば、一般的に、ユーザは、それらが同じデバイスと対話していることを知っているため、2つの異なるオリジンを意図しません。また、ユーザは、クッキーをクリアした後に持続するユニークな識別子も意図しません。

permission result type

interface BluetoothPermissionResult : PermissionStatus {
  attribute FrozenArray<BluetoothDevice> devices;
};

permission request algorithm

BluetoothPermissionDescriptor options と BluetoothPermissionResult status が与えられ、UA は以下のステップを実行しなければなりません。：

1. Bluetooth devices のリクエストでは options.filters と options.optionalServices を渡し、いずれの例外も伝搬させ、devices を結果とします。
2. status.devices を、devices の要素を含む新しい FrozenArray にセットします。

permission query algorithm

BluetoothPermissionDescriptor desc と BluetoothPermissionResult status とともに"bluetooth" permission を問い合わせるためには、UAは以下のステップを実行しなければなりません。：

1. global を status と関連した global object とします。
2. status.state を desc の permission state にセットします。
3. status.state が "denied" の場合、status.devices を空の FrozenArray にセットし、以下のステップを中止します。
4. matchingDevices を新しい Array にします。
5. data ( BluetoothPermissionData ) を、current settings object のために "bluetooth" の extra permission data とします。
6. data.allowedDevices の各 allowedDevice に対して、以下のサブステップを実行します。：
   1. desc.deviceId がセットされ、 allowedDevice.deviceId != desc.deviceId の場合、次の allowedDevice に進みます。
   2. desc.filters がセットされ、allowedDevice@[[device]] が desc.filters のフィルターとマッチしない場合、次の allowedDevice に進みます。
   3. 注記: desc.optionalServices フィールドは結果には影響しません。
   4. global.navigator.bluetooth 内の allowedDevice@[[device]] を表す BluetoothDevice を取得し、結果に matchingDevices を加えます。
7. status.devices を、コンテンツが matchingDevices である新しい FrozenArray にセットします。

permission revocation algorithm

ユーザはデバイスを公開しないよう Bluetooth access を取り消すためには、UA は以下のステップを実行しなければなりません。：

1. data ( BluetoothPermissionData ) を、current settings object のために "bluetooth" の extra permission data とします。
2. current realm の各 BluetoothDevice instance deviceObj に対して、以下のサブステップを実行します。：
   1. data.allowedDevices の中に AllowedBluetoothDevice allowedDevice がある場合、つまり：
      • allowedDevice.[[device]] は deviceObj.[[representedDevice]] と 同一デバイスである。
      • allowedDevice.deviceId === deviceObj.id である。
      その後、deviceObj.[[allowedServices]] を allowedDevice.allowedServices に更新し、次の deviceObj に進みます。
   2. そうでない場合、残りのステップを実行して、そのデバイスから deviceObj を切り離します。
   3. deviceObj.gatt.disconnect() をコールします。

      注記: これは deviceObj で gattserverdisconnected イベントを開始させます。

   4. deviceObj@[[representedDevice]] を null にセットします。

4. デバイスの表現

UA は Bluetoothデバイスproperties をいくつかのレベルで追跡する必要があります。： グローバル、オリジン別、グローバルオブジェクト別

interface BluetoothDevice {
  readonly attribute DOMString id;
  readonly attribute DOMString? name;
  readonly attribute BluetoothRemoteGATTServer gatt;
  readonly attribute FrozenArray<UUID> uuids;

  Promise<void> watchAdvertisements();
  void unwatchAdvertisements();
  readonly attribute boolean watchingAdvertisements;
};
BluetoothDevice implements EventTarget;
BluetoothDevice implements BluetoothDeviceEventHandlers;
BluetoothDevice implements CharacteristicEventHandlers;
BluetoothDevice implements ServiceEventHandlers;

interface BluetoothManufacturerDataMap {
  readonly maplike<unsigned short, DataView>;
};
interface BluetoothServiceDataMap {
  readonly maplike<UUID, DataView>;
};
[Constructor(DOMString type, BluetoothAdvertisingEventInit init)]
interface BluetoothAdvertisingEvent : Event {
  readonly attribute BluetoothDevice device;
  readonly attribute FrozenArray<UUID> uuids;
  readonly attribute DOMString? name;
  readonly attribute unsigned short? appearance;
  readonly attribute byte? txPower;
  readonly attribute byte? rssi;
  readonly attribute BluetoothManufacturerDataMap manufacturerData;
  readonly attribute BluetoothServiceDataMap serviceData;
};
dictionary BluetoothAdvertisingEventInit : EventInit {
  required BluetoothDevice device;
  sequence<(DOMString or unsigned long)> uuids;
  DOMString name;
  unsigned short appearance;
  byte txPower;
  byte rssi;
  Map manufacturerData;
  Map serviceData;
};

var known_service = "A service in the iBeacon’s GATT server";
return navigator.bluetooth.requestDevice({
  filters: [{services: [known_service]}]
}).then(device => {
  device.watchAdvertisements();
  device.addEventListener('advertisementreceived', interpretIBeacon);
});

function interpretIBeacon(event) {
  var rssi = event.rssi;
  var appleData = event.manufacturerData.get(0x004C);
  if (appleData.byteLength != 23 ||
    appleData.getUint16(0, false) !== 0x0215) {
    console.log({isBeacon: false});
  }
  var uuidArray = new Uint8Array(appleData.buffer, 2, 16);
  var major = appleData.getUint16(18, false);
  var minor = appleData.getUint16(20, false);
  var txPowerAt1m = -appleData.getInt8(22);
  console.log({
      isBeacon: true,
      uuidArray,
      major,
      minor,
      pathLossVs1m: txPowerAt1m - rssi});
});

5. GATT Interaction

interface BluetoothRemoteGATTServer {
  readonly attribute BluetoothDevice device;
  readonly attribute boolean connected;
  Promise<BluetoothRemoteGATTServer> connect();
  void disconnect();
  Promise<BluetoothRemoteGATTService> getPrimaryService(BluetoothServiceUUID service);
  Promise<sequence<BluetoothRemoteGATTService>>
    getPrimaryServices(optional BluetoothServiceUUID service);
};

interface BluetoothRemoteGATTService {
  readonly attribute BluetoothDevice device;
  readonly attribute UUID uuid;
  readonly attribute boolean isPrimary;
  Promise<BluetoothRemoteGATTCharacteristic>
    getCharacteristic(BluetoothCharacteristicUUID characteristic);
  Promise<sequence<BluetoothRemoteGATTCharacteristic>>
    getCharacteristics(optional BluetoothCharacteristicUUID characteristic);
  Promise<BluetoothRemoteGATTService>
    getIncludedService(BluetoothServiceUUID service);
  Promise<sequence<BluetoothRemoteGATTService>>
    getIncludedServices(optional BluetoothServiceUUID service);
};
BluetoothRemoteGATTService implements EventTarget;
BluetoothRemoteGATTService implements CharacteristicEventHandlers;
BluetoothRemoteGATTService implements ServiceEventHandlers;

interface BluetoothRemoteGATTCharacteristic {
  readonly attribute BluetoothRemoteGATTService service;
  readonly attribute UUID uuid;
  readonly attribute BluetoothCharacteristicProperties properties;
  readonly attribute DataView? value;
  Promise<BluetoothRemoteGATTDescriptor> getDescriptor(BluetoothDescriptorUUID descriptor);
  Promise<sequence<BluetoothRemoteGATTDescriptor>>
    getDescriptors(optional BluetoothDescriptorUUID descriptor);
  Promise<DataView> readValue();
  Promise<void> writeValue(BufferSource value);
  Promise<void> startNotifications();
  Promise<void> stopNotifications();
};
BluetoothRemoteGATTCharacteristic implements EventTarget;
BluetoothRemoteGATTCharacteristic implements CharacteristicEventHandlers;

interface BluetoothCharacteristicProperties {
  readonly attribute boolean broadcast;
  readonly attribute boolean read;
  readonly attribute boolean writeWithoutResponse;
  readonly attribute boolean write;
  readonly attribute boolean notify;
  readonly attribute boolean indicate;
  readonly attribute boolean authenticatedSignedWrites;
  readonly attribute boolean reliableWrite;
  readonly attribute boolean writableAuxiliaries;
};

interface BluetoothRemoteGATTDescriptor {
  readonly attribute BluetoothRemoteGATTCharacteristic characteristic;
  readonly attribute UUID uuid;
  readonly attribute DataView? value;
  Promise<DataView> readValue();
  Promise<void> writeValue(BufferSource value);
};

[NoInterfaceObject]
interface CharacteristicEventHandlers {
  attribute EventHandler oncharacteristicvaluechanged;
};

[NoInterfaceObject]
interface BluetoothDeviceEventHandlers {
  attribute EventHandler ongattserverdisconnected;
};

[NoInterfaceObject]
interface ServiceEventHandlers {
  attribute EventHandler onserviceadded;
  attribute EventHandler onservicechanged;
  attribute EventHandler onserviceremoved;
};

6. UUIDs

typedef DOMString UUID;

UUID 文字列は128ビットの UUID [RFC4122] を表現します。有効な UUID は次の正規表現とマッチする文字列です。 the [ECMAScript] regexp /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/ つまり、有効な UUID は小文字で、Bluetooth標準で定義されている16ビット/32ビットの短縮版は使用しません。本仕様書の関数と属性から返却されるUUID全ては、有効な UUID でなければなりません。 本仕様書の関数に、UUID または UUID 属性を含む辞書を型とする引数があり、UUID スロットに渡される引数が有効な UUID でない場合、関数は TypeError とともに promise を reject して返し、他のステップを中止しなければなりません。

本標準では、16ビットまたは32ビットの Bluetooth UUID エイリアス を128ビット形式にマップする BluetoothUUID.canonicalUUID(alias) 関数を提供しています。

Bluetoothデバイス は、比較前に（属性タイプに記載されたように）16ビットまたは32ビットの UUID を 128ビットの UUID に変換する必要がありますが、全てのデバイスがそうしているわけではありません。このようなデバイスと相互運用するため、UA が (16-, 32-, または 128-ビット)形式のデバイスから UUID を受信した場合、その UUID の他のエイリアスを同一形式でデバイスに送り返さなければなりません。

interface BluetoothUUID {
  static UUID getService((DOMString or unsigned long) name);
  static UUID getCharacteristic((DOMString or unsigned long) name);
  static UUID getDescriptor((DOMString or unsigned long) name);

  static UUID canonicalUUID([EnforceRange] unsigned long alias);
};

typedef (DOMString or unsigned long) BluetoothServiceUUID;
typedef (DOMString or unsigned long) BluetoothCharacteristicUUID;
typedef (DOMString or unsigned long) BluetoothDescriptorUUID;

7. GATTブラックリスト

本仕様は、ウェブサイトがアクセス可能な GATT 属性 の集合を制限するために https://github.com/WebBluetoothCG/registries にあるブラックリストファイルに依存しています。

URLにあるブラックリストをパース した結果は、以下のアルゴリズムにより生成される、有効な UUID からトークンまたはエラーへのマップです：

1. URLを取得し、そのコンテンツをボディとし、UTF-8 としてデコードします。
2. lines は '\n' で分割された内容とします。
3. result を空のマップにします。
4. lines の各 lineに対して、以下のサブステップを実行します：
   1. line が空行か、先頭文字が '#' の場合、次の行に進みます。
   2. line が 有効な UUID の場合、uuid をその UUID とし、token を "exclude" にします。
   3. line が 有効なUUID、スペース(U+0020)、そして "exclude-reads" または "exclude-writes" のいずれかのトークンからなる場合、uuid をその UUID とし、token をそのトークンにします。
   4. そうでない場合は、エラーを返し、以下のステップを中止します。
   5. uuid がすでに result の中にある場合、エラーを返し、以下のステップを中止します。
   6. uuid から token へのマッピングを result に追加します。
5. result を返します。

GATT blacklist は https://github.com/WebBluetoothCG/registries/blob/master/gatt_blacklist.txt にある ブラックリストをパース した結果です。 UA は定期的にブラックリストを再読み込みすべきですが、頻度は規定されていません。

GATT blacklist の値がエラーか、UUIDが GATT blacklist で "exclude" にマップされる場合、UUID は ブラックリストに加えられます。#blacklistedReferenced in:3. Device Discovery (2)5.1.2. Navigating the Bluetooth Hierarchy

GATT blacklist の値がエラーか、UUIDが GATT blacklist で "exclude" または "exclude-reads" にマップされる場合、UUID は 読み出し用ブラックリストに加えられます。#blacklisted-for-readsReferenced in:5.4. BluetoothRemoteGATTCharacteristic (2)5.5. BluetoothRemoteGATTDescriptor

GATT blacklist の値がエラーか、UUIDが GATT blacklist で "exclude" または "exclude-writes" にマップされる場合、UUID は 書き込み用ブラックリストに加えられます。#blacklisted-for-writesReferenced in:5.4. BluetoothRemoteGATTCharacteristic5.5. BluetoothRemoteGATTDescriptor

8. ナビゲーションインターフェースの拡張

partial interface Navigator {
  readonly attribute Bluetooth bluetooth;
};

9. 用語と規則

本仕様書は、規約と他の仕様書からの用語をいくつか使用します。本セクションでは、これらと主要な定義へのリンクをリストアップします。

Streams仕様書に刺激を受け、本仕様書では、オブジェクトの内部スロットを参照するため、「内部スロットxの [[y]]」という代わりに[[[ x@[[y]] ]]] という表記を使用します。

本仕様書で用いるアルゴリズムが、この仕様書または別の仕様書で定義される名前を用いる場合、その名前は初期値で解決され、現在の実行環境で名前に加えられたいかなる変更も無視しなければなりません。 例えば、requestDevice() アルゴリズムが、Array.prototype.map.call(filter.services, BluetoothUUID.getService) を呼び出す場合、パラメータとアルゴリズムは §6.1 Standardized UUIDs 内の BluetoothUUID.getService で callbackfn パラメータとして定義された、filter.services を使って [ECMAScript] で定義された Array.prototype.map アルゴリズムに適用されなければなりません。これはwindow, Array, Array.prototype, Array.prototype.map, Function, Function.prototype, BluetoothUUID, BluetoothUUID.getService またはその他のオブジェクトに加えられた修正とは関係ありません。

本仕様書では、WebIDLの FrozenArray と同様の読み出し専用タイプを使用しています。

• 読み取り専用 ArrayBuffer には ArrayBuffer の値とインターフェースがあります。このコンテンツへの書き込みまたは転送を試みようとすることを除き、FrozenArray のコンテンツへ書き込もうとした時と同じ影響があります。 ArrayBuffer でラッピングされた TypedArray と DataView にもこれは適用されます。

[BLUETOOTH42]

1. Architecture & Terminology Overview
   1. General Description
      2. Overview of Bluetooth Low Energy Operation (defines advertising events)
   4. Communication Topology and Operation
      2. Operational Procedures and Modes
         1. BR/EDR Procedures
            1. Inquiry (Discovering) Procedure
               1. Extended Inquiry Response
2. Core System Package [BR/EDR Controller volume]
   5. Host Controller Interface Functional Specification
      7. HCI Commands and Events
         4. Informational Parameters
            6. Read BD_ADDR Command
         5. Status Parameters
            4. Read RSSI Command
3. Core System Package [Host volume]
   2. Service Discovery Protocol (SDP) Specification
      2. Overview
         5. Searching for Services
            1. UUID (defines UUID aliases and the algorithm to compute the 128-bit UUID represented by a UUID alias)
   3. Generic Access Profile
      2. Profile Overview
         2. Profile Roles
            2. Roles when Operating over an LE Physical Transport
               1. Broadcaster Role
               2. Observer Role
               3. Peripheral Role
               4. Central Role
      3. User Interface Aspects
         2. Representation of Bluetooth Parameters
            2. Bluetooth Device Name (the user-friendly name)
      6. Idle Mode Procedures — BR/EDR Physical Transport
         4. Device Discovery Procedure
      9. Operational Modes and Procedures — LE Physical Transport
         1. Broadcast Mode and Observation Procedure
            2. Observation Procedure
         2. Discovery Modes and Procedures
            6. General Discovery Procedure
            7. Name Discovery Procedure
         3. Connection Modes and Procedures
      10. Security Aspects — LE Physical Transport
          7. Privacy Feature
          8. Random Device Address
             1. Static Address
             2. Private address
                3. Resolvable Private Address Resolution Procedure
      11. Advertising Data and Scan Response Data Format (defines AD structure)
      15. Bluetooth Device Requirements
          1. Bluetooth Device Address (defines BD_ADDR)
             1. Bluetooth Device Address Types
                1. Public Bluetooth Address
   6. Attribute Protocol (ATT)
      3. Protocol Requirements
         2. Basic Concepts
            1. Attribute Type
            2. Attribute Handle
            9. Long Attribute Values
         4. Attribute Protocol Pdus
            1. Error Handling
               1. Error Response
   7. Generic Attribute Profile (GATT)
      2. Profile Overview
         2. Configurations and Roles (defines GATT Client and GATT Server)
         4. Profile Fundamentals, defines the ATT Bearer
         5. Attribute Protocol
            2. Attribute Caching
         6. GATT Profile Hierarchy
            2. Service
            3. Included Services
            4. Characteristic
      3. Service Interoperability Requirements
         3. Characteristic Definition
            1. Characteristic Declaration
               1. Characteristic Properties
            3. Characteristic Descriptor Declarations
               1. Characteristic Extended Properties
               3. Client Characteristic Configuration
      4. GATT Feature Requirements — defines the GATT procedures.
         4. Primary Service Discovery
            1. Discover All Primary Services
            2. Discover Primary Service by Service UUID
         5. Relationship Discovery
            1. Find Included Services
         6. Characteristic Discovery
            1. Discover All Characteristics of a Service
            2. Discover Characteristics by UUID
         7. Characteristic Descriptor Discovery
            1. Discover All Characteristic Descriptors
         8. Characteristic Value Read
         9. Characteristic Value Write
         10. Characteristic Value Notification
         11. Characteristic Value Indications
         12. Characteristic Descriptors
             1. Read Characteristic Descriptors
             2. Read Long Characteristic Descriptors
             3. Write Characteristic Descriptors
             4. Write Long Characteristic Descriptors
         14. Procedure Timeouts
      6. GAP Interoperability Requirements
         1. BR/EDR GAP Interoperability Requirements
            1. Connection Establishment
         2. LE GAP Interoperability Requirements
            1. Connection Establishment
      7. Defined Generic Attribute Profile Service
         1. Service Changed
   8. Security Manager Specification
      2. Security Manager
         4. Security in Bluetooth Low Energy
            1. Definition of Keys and Values, defines the Identity Resolving Key (IRK)
6. Core System Package [Low Energy Controller volume]
   2. Link Layer Specification
      1. General Description
         3. Device Address
            1. Public Device Address
            2. Random Device Address
               1. Static Device Address
      4. Air Interface Protocol
         4. Non-Connected States
            3. Scanning State
               1. Passive Scanning

[BLUETOOTH-SUPPLEMENT6]

1. Data Types Specification
   1. Data Types Definitions and Formats
      1. Service UUID Data Type
      2. Local Name Data Type
      3. Flags Data Type
      4. Manufacturer Specific Data
      5. TX Power Level
      11. Service Data
      12. Appearance