chrome.bluetoothLowEnergy

설명

chrome.bluetoothLowEnergy API는 일반 속성 프로필 (GATT)을 사용하여 블루투스 스마트 (저전력) 기기와 통신하는 데 사용됩니다.

매니페스트

이 API를 사용하려면 다음 키를 매니페스트에서 선언해야 합니다.

"bluetooth"

유형

Advertisement

Chrome 47 이상

속성

• manufacturerData

  ManufacturerData[] 선택사항

  광고 데이터의 '제조업체별 데이터' 입력란에 포함할 제조업체별 데이터 목록입니다.

• serviceData

  ServiceData[] 선택사항

  광고 데이터의 '서비스 데이터' 필드에 포함할 서비스 데이터 목록입니다.

• serviceUuids

  string[] 선택사항

  광고 데이터의 '서비스 UUID' 필드에 포함할 UUID 목록입니다. 이러한 UUID는 16비트, 32비트 또는 128비트 형식일 수 있습니다.

• solicitUuids

  string[] 선택사항

  광고 데이터의 'Solicit UUIDs' 필드에 포함할 UUID 목록입니다. 이러한 UUID는 16비트, 32비트 또는 128비트 형식일 수 있습니다.

• 유형

  AdvertisementType

  광고 유형입니다.

AdvertisementType

Chrome 47 이상

광고 유형입니다. 'broadcast'가 선택되면 전송된 광고 유형은 ADV_NONCONN_IND가 되고 기기는 임의의 MAC 주소로 브로드캐스트합니다. 'peripheral'로 설정하면 광고 유형이 ADV_IND 또는 ADV_SCAN_IND가 되고 기기는 실제 블루투스 어댑터의 MAC 주소로 브로드캐스트합니다.

열거형

'broadcast'

'peripheral'

Characteristic

속성

• instanceId

  문자열 선택사항

  이 특성에 할당된 식별자를 반환합니다. 인스턴스 ID를 사용하여 UUID가 동일한 주변기기의 특성을 구분하고 특성 식별자를 사용하는 함수를 호출합니다. 이 인스턴스가 원격 특성을 나타내는 경우 '현재'입니다.

• 속성

  CharacteristicProperty[]

  이 특성의 속성입니다.

• 서비스

  서비스 선택사항

  이 특성이 속한 GATT 서비스입니다.

• uuid

  문자열

  특성의 UUID입니다(예: 00002a37-0000-1000-8000-00805f9b34fb).

• 값

  ArrayBuffer 선택사항

  현재 캐시된 특성 값입니다. 이 값은 알림 또는 표시를 통해 특성의 값이 읽히거나 업데이트될 때 업데이트됩니다.

CharacteristicProperty

특성의 가능한 속성을 나타내는 값입니다. 이러한 속성에서 특성 권한이 추론됩니다. 각 개별 속성의 의미는 블루투스 4.x 사양을 참고하세요.

열거형

'broadcast'

'읽기'

"writeWithoutResponse"

'write'

'notify'

'표시'

"authenticatedSignedWrites"

"extendedProperties"

'reliableWrite'

"writableAuxiliaries"

"encryptRead"

"encryptWrite"

"encryptAuthenticatedRead"

"encryptAuthenticatedWrite"

ConnectProperties

속성

• 영구

  부울

  애플리케이션의 이벤트 페이지가 언로드될 때 기기 연결을 열어 두어야 하는지 나타내는 플래그입니다 (앱 수명 주기 관리 참고). 기본값은 false.입니다.

Descriptor

속성

• 특성

  특성 선택사항

  이 설명자가 속한 GATT 특성입니다.

• instanceId

  문자열 선택사항

  이 설명자에 할당된 식별자를 반환합니다. 인스턴스 ID를 사용하여 UUID가 동일한 주변기기의 설명자를 구분하고 설명자 식별자를 사용하는 함수 호출을 실행합니다. 이 인스턴스가 원격 특성을 나타내는 경우 '현재'입니다.

• 권한

  DescriptorPermission[]

  Chrome 52 이상

  이 설명자의 권한입니다.

• uuid

  문자열

  특성 설명자의 UUID입니다(예: 00002902-0000-1000-8000-00805f9b34fb).

• 값

  ArrayBuffer 선택사항

  현재 캐시된 설명자 값입니다. 이 값은 설명자의 값이 읽힐 때 업데이트됩니다.

DescriptorPermission

Chrome 52 이상

설명자에 가능한 권한을 나타내는 값입니다. 각 개별 권한의 의미는 블루투스 4.x 사양을 참고하세요.

열거형

'읽기'

'write'

"encryptedRead"

"encryptedWrite"

"encryptedAuthenticatedRead"

"encryptedAuthenticatedWrite"

Device

Chrome 52 이상

속성

• 주소

  문자열

  'XX:XX:XX:XX:XX:XX' 형식의 기기 주소입니다.

• deviceClass

  번호 선택사항

  기기의 클래스입니다. http://www.bluetooth.org/en-us/specification/assigned-numbers/baseband에 정의된 비트 필드입니다.

• 이름

  문자열 선택사항

  사람이 읽을 수 있는 기기 이름입니다.

ManufacturerData

Chrome 47 이상

속성

• 데이터

  number[]

• id

  숫자

Notification

Chrome 52 이상

속성

• shouldIndicate

  불리언 선택사항

  알림 대신 표시를 전송하기 위한 선택적 플래그입니다.

• 값

  ArrayBuffer

  특성의 새 값입니다.

NotificationProperties

속성

• 영구

  부울

  애플리케이션의 이벤트 페이지가 언로드될 때 앱이 알림을 수신해야 하는지 여부를 나타내는 플래그입니다 (앱 수명 주기 관리 참고). 기본값은 false입니다.

Request

Chrome 52 이상

속성

• 기기

  기기

  이 요청을 전송하는 기기입니다.

• requestId

  숫자

  이 요청의 고유 ID입니다. 이 요청에 응답할 때 이 ID를 사용하세요.

• 값

  ArrayBuffer 선택사항

  쓸 값 (쓰기 요청인 경우)

Response

Chrome 52 이상

속성

• isError

  부울

  오류 응답인 경우 true여야 합니다.

• requestId

  숫자

  이 요청에 대한 응답인 요청의 ID입니다.

• 값

  ArrayBuffer 선택사항

  응답 값 쓰기 요청 및 오류 응답은 이 매개변수를 무시합니다.

Service

속성

• deviceAddress

  문자열 선택사항

  GATT 서비스가 속한 원격 주변기기의 기기 주소입니다. 이 인스턴스가 원격 서비스를 나타내는 경우 'present'입니다.

• instanceId

  문자열 선택사항

  이 서비스에 할당된 식별자를 반환합니다. 인스턴스 ID를 사용하여 UUID가 동일한 주변기기의 서비스를 구분하고 서비스 식별자를 사용하는 함수를 호출합니다. 이 인스턴스가 원격 서비스를 나타내는 경우 'present'입니다.

• isPrimary

  부울

  이 서비스의 유형이 기본인지 보조인지 나타냅니다.

• uuid

  문자열

  서비스의 UUID입니다(예: 0000180d-0000-1000-8000-00805f9b34fb).

ServiceData

Chrome 47 이상

속성

• 데이터

  number[]

• uuid

  문자열

메서드

connect()

Promise

chrome.bluetoothLowEnergy.connect(
  deviceAddress: string,
  properties?: ConnectProperties,
  callback?: function,
)

지정된 주소를 사용하여 애플리케이션과 기기 간에 연결을 설정합니다. 기기가 이미 연결되어 있고 connect를 호출하지 않고도 GATT 서비스를 사용할 수 있지만, 기기의 GATT 서비스에 액세스하려는 앱은 이 함수를 호출하여 기기와의 연결이 유지되도록 해야 합니다. 기기가 연결되어 있지 않으면 connect를 성공적으로 호출한 후에 기기의 모든 GATT 서비스가 검색됩니다.

매개변수

• deviceAddress

  문자열

  GATT 연결을 열어야 하는 원격 기기의 블루투스 주소입니다.

• 속성

  ConnectProperties 선택사항

  연결 속성 (선택사항)

• 콜백

  함수 선택사항

  callback 매개변수는 다음과 같습니다.

  () => void

반환 값

• Promise<void>

  Chrome 91 이상

  Promise는 Manifest V3 이상에서만 지원되며 다른 플랫폼에서는 콜백을 사용해야 합니다.

createCharacteristic()

Promise Chrome 52 이상

chrome.bluetoothLowEnergy.createCharacteristic(
  characteristic: Characteristic,
  serviceId: string,
  callback?: function,
)

로컬에서 호스팅되는 GATT 특성을 만듭니다. 이 특성은 유효한 서비스 아래에서 호스팅되어야 합니다. 서비스 ID가 유효하지 않으면 lastError가 설정됩니다. 이 함수는 앱에 bluetooth:low_energy 및 bluetooth:peripheral 권한이 모두 true로 설정된 경우에만 사용할 수 있습니다. 일부 앱에서는 주변기기 권한을 사용할 수 없습니다.

매개변수

• 특성

  특성

  만들 특성입니다.

• serviceId

  문자열

  이 특성을 만들 서비스의 ID입니다.

• 콜백

  함수 선택사항

  callback 매개변수는 다음과 같습니다.

  (characteristicId: string) => void

  • characteristicId

    문자열

반환 값

• Promise<string>

  Chrome 91 이상

  Promise는 Manifest V3 이상에서만 지원되며 다른 플랫폼에서는 콜백을 사용해야 합니다.

createDescriptor()

Promise Chrome 52 이상

chrome.bluetoothLowEnergy.createDescriptor(
  descriptor: Descriptor,
  characteristicId: string,
  callback?: function,
)

로컬에서 호스팅되는 GATT 설명자를 만듭니다. 이 설명어는 유효한 특성 아래에 호스팅되어야 합니다. 특성 ID가 유효하지 않으면 lastError가 설정됩니다. 이 함수는 앱에 bluetooth:low_energy 및 bluetooth:peripheral 권한이 모두 true로 설정된 경우에만 사용할 수 있습니다. 일부 앱에서는 주변기기 권한을 사용할 수 없습니다.

매개변수

• 설명어

  Descriptor

  생성할 설명자입니다.

• characteristicId

  문자열

  이 설명자를 만들 특성의 ID입니다.

• 콜백

  함수 선택사항

  callback 매개변수는 다음과 같습니다.

  (descriptorId: string) => void

  • descriptorId

    문자열

반환 값

• Promise<string>

  Chrome 91 이상

  Promise는 Manifest V3 이상에서만 지원되며 다른 플랫폼에서는 콜백을 사용해야 합니다.

createService()

Promise Chrome 52 이상

chrome.bluetoothLowEnergy.createService(
  service: Service,
  callback?: function,
)

로컬에서 호스팅되는 GATT 서비스를 만듭니다. 이 서비스는 로컬 GATT 서버에서 사용할 수 있도록 등록할 수 있습니다. 이 함수는 앱에 bluetooth:low_energy 및 bluetooth:peripheral 권한이 모두 true로 설정된 경우에만 사용할 수 있습니다. 일부 앱에서는 주변기기 권한을 사용할 수 없습니다.

매개변수

• 서비스

  서비스

  만들 서비스입니다.

• 콜백

  함수 선택사항

  callback 매개변수는 다음과 같습니다.

  (serviceId: string) => void

  • serviceId

    문자열

반환 값

• Promise<string>

  Chrome 91 이상

  Promise는 Manifest V3 이상에서만 지원되며 다른 플랫폼에서는 콜백을 사용해야 합니다.

disconnect()

Promise

chrome.bluetoothLowEnergy.disconnect(
  deviceAddress: string,
  callback?: function,
)

지정된 주소로 기기에 대한 앱의 연결을 닫습니다. 연결이 열려 있는 다른 앱이 있을 수 있으므로 물리적 링크 자체가 항상 소멸되는 것은 아닙니다.

매개변수

• deviceAddress

  문자열

  원격 기기의 블루투스 주소입니다.

• 콜백

  함수 선택사항

  callback 매개변수는 다음과 같습니다.

  () => void

반환 값

• Promise<void>

  Chrome 91 이상

  Promise는 Manifest V3 이상에서만 지원되며 다른 플랫폼에서는 콜백을 사용해야 합니다.

getCharacteristic()

Promise

chrome.bluetoothLowEnergy.getCharacteristic(
  characteristicId: string,
  callback?: function,
)

특성이 있는 경우 지정된 GATT 서비스에 속한 지정된 인스턴스 ID가 있는 GATT 특성을 가져옵니다.

매개변수

• characteristicId

  문자열

  요청된 GATT 특성의 인스턴스 ID입니다.

• 콜백

  함수 선택사항

  callback 매개변수는 다음과 같습니다.

  (result: Characteristic) => void

  • 결과

    특성

반환 값

• Promise<Characteristic>

  Chrome 91 이상

  Promise는 Manifest V3 이상에서만 지원되며 다른 플랫폼에서는 콜백을 사용해야 합니다.

getCharacteristics()

Promise

chrome.bluetoothLowEnergy.getCharacteristics(
  serviceId: string,
  callback?: function,
)

지정된 서비스에 속하는 발견된 모든 GATT 특성의 목록을 가져옵니다.

매개변수

• serviceId

  문자열

  특성을 반환해야 하는 GATT 서비스의 인스턴스 ID입니다.

• 콜백

  함수 선택사항

  callback 매개변수는 다음과 같습니다.

  (result: Characteristic[]) => void

  • 결과

    Characteristic[]

반환 값

• Promise<Characteristic[]>

  Chrome 91 이상

  Promise는 Manifest V3 이상에서만 지원되며 다른 플랫폼에서는 콜백을 사용해야 합니다.

getDescriptor()

Promise

chrome.bluetoothLowEnergy.getDescriptor(
  descriptorId: string,
  callback?: function,
)

지정된 인스턴스 ID로 GATT 특성 설명자를 가져옵니다.

매개변수

• descriptorId

  문자열

  요청된 GATT 특성 설명자의 인스턴스 ID입니다.

• 콜백

  함수 선택사항

  callback 매개변수는 다음과 같습니다.

  (result: Descriptor) => void

  • 결과

    Descriptor

반환 값

• Promise<Descriptor>

  Chrome 91 이상

  Promise는 Manifest V3 이상에서만 지원되며 다른 플랫폼에서는 콜백을 사용해야 합니다.

getDescriptors()

Promise

chrome.bluetoothLowEnergy.getDescriptors(
  characteristicId: string,
  callback?: function,
)

지정된 특성에 속하는 GATT 특성 설명자 목록을 가져옵니다.

매개변수

• characteristicId

  문자열

  설명자를 반환해야 하는 GATT 특성의 인스턴스 ID입니다.

• 콜백

  함수 선택사항

  callback 매개변수는 다음과 같습니다.

  (result: Descriptor[]) => void

  • 결과

    Descriptor[]

반환 값

• Promise<Descriptor[]>

  Chrome 91 이상

  Promise는 Manifest V3 이상에서만 지원되며 다른 플랫폼에서는 콜백을 사용해야 합니다.

getIncludedServices()

Promise

chrome.bluetoothLowEnergy.getIncludedServices(
  serviceId: string,
  callback?: function,
)

지정된 서비스에 포함된 GATT 서비스 목록을 가져옵니다.

매개변수

• serviceId

  문자열

  포함된 서비스가 반환되어야 하는 GATT 서비스의 인스턴스 ID입니다.

• 콜백

  함수 선택사항

  callback 매개변수는 다음과 같습니다.

  (result: Service[]) => void

  • 결과

    서비스[]

반환 값

• Promise<Service[]>

  Chrome 91 이상

  Promise는 Manifest V3 이상에서만 지원되며 다른 플랫폼에서는 콜백을 사용해야 합니다.

getService()

Promise

chrome.bluetoothLowEnergy.getService(
  serviceId: string,
  callback?: function,
)

지정된 인스턴스 ID로 GATT 서비스를 가져옵니다.

매개변수

• serviceId

  문자열

  요청된 GATT 서비스의 인스턴스 ID입니다.

• 콜백

  함수 선택사항

  callback 매개변수는 다음과 같습니다.

  (result: Service) => void

  • 결과

    서비스

반환 값

• Promise<Service>

  Chrome 91 이상

  Promise는 Manifest V3 이상에서만 지원되며 다른 플랫폼에서는 콜백을 사용해야 합니다.

getServices()

Promise

chrome.bluetoothLowEnergy.getServices(
  deviceAddress: string,
  callback?: function,
)

지정된 기기 주소로 원격 기기에서 발견된 모든 GATT 서비스를 가져옵니다.

참고: 기기에서 서비스 검색이 아직 완료되지 않은 경우 이 API는 서비스의 하위 집합 (비어 있을 수 있음)을 반환합니다. 해결 방법은 시간 기반 지연을 추가하거나 예상 서비스 수가 반환될 때까지 반복적으로 호출하는 것입니다.

매개변수

• deviceAddress

  문자열

  GATT 서비스를 반환해야 하는 원격 기기의 블루투스 주소입니다.

• 콜백

  함수 선택사항

  callback 매개변수는 다음과 같습니다.

  (result: Service[]) => void

  • 결과

    서비스[]

반환 값

• Promise<Service[]>

  Chrome 91 이상

  Promise는 Manifest V3 이상에서만 지원되며 다른 플랫폼에서는 콜백을 사용해야 합니다.

notifyCharacteristicValueChanged()

Promise Chrome 52 이상

chrome.bluetoothLowEnergy.notifyCharacteristicValueChanged(
  characteristicId: string,
  notification: Notification,
  callback?: function,
)

원격 기기에 특성의 새 값을 알립니다. 알림 객체의 shouldIndicate 플래그가 true이면 알림 대신 표시가 전송됩니다. 이 호출이 성공하려면 특성이 생성 중에 'notify' 또는 'indicate' 속성을 올바르게 설정해야 합니다. 이 함수는 앱에 bluetooth:low_energy 및 bluetooth:peripheral 권한이 모두 true로 설정된 경우에만 사용할 수 있습니다. 일부 앱에서는 주변기기 권한을 사용할 수 없습니다.

매개변수

• characteristicId

  문자열

  알림을 전송할 특성입니다.

• 알림

  알림

• 콜백

  함수 선택사항

  callback 매개변수는 다음과 같습니다.

  () => void

반환 값

• Promise<void>

  Chrome 91 이상

  Promise는 Manifest V3 이상에서만 지원되며 다른 플랫폼에서는 콜백을 사용해야 합니다.

readCharacteristicValue()

Promise

chrome.bluetoothLowEnergy.readCharacteristicValue(
  characteristicId: string,
  callback?: function,
)

원격 주변기기에서 지정된 특성의 값을 검색합니다.

매개변수

• characteristicId

  문자열

  원격 기기에서 값을 읽어야 하는 GATT 특성의 인스턴스 ID입니다.

• 콜백

  함수 선택사항

  callback 매개변수는 다음과 같습니다.

  (result: Characteristic) => void

  • 결과

    특성

반환 값

• Promise<Characteristic>

  Chrome 91 이상

  Promise는 Manifest V3 이상에서만 지원되며 다른 플랫폼에서는 콜백을 사용해야 합니다.

readDescriptorValue()

Promise

chrome.bluetoothLowEnergy.readDescriptorValue(
  descriptorId: string,
  callback?: function,
)

원격 주변기기에서 지정된 특성 설명자의 값을 검색합니다.

매개변수

• descriptorId

  문자열

  원격 기기에서 값을 읽어야 하는 GATT 특성 설명자의 인스턴스 ID입니다.

• 콜백

  함수 선택사항

  callback 매개변수는 다음과 같습니다.

  (result: Descriptor) => void

  • 결과

    Descriptor

반환 값

• Promise<Descriptor>

  Chrome 91 이상

  Promise는 Manifest V3 이상에서만 지원되며 다른 플랫폼에서는 콜백을 사용해야 합니다.

registerAdvertisement()

Promise Chrome 47 이상

chrome.bluetoothLowEnergy.registerAdvertisement(
  advertisement: Advertisement,
  callback?: function,
)

광고를 만들고 광고에 등록합니다. 이 함수를 호출하려면 앱에 bluetooth:low_energy 및 bluetooth:peripheral 권한이 true로 설정되어 있어야 합니다. 또한 이 API는 키오스크 모드에서 자동 실행된 앱 또는 '--enable-ble-advertising-in-apps' 명령줄 스위치를 설정하여만 사용할 수 있습니다. https://developer.chrome.com/apps/manifest/bluetooth 참고: 일부 하드웨어에서는 중앙 모드와 주변기기 모드가 동시에 지원되지만 이를 지원하지 않는 하드웨어에서는 이 호출을 실행하면 기기가 주변기기 모드로 전환됩니다. 중앙 모드와 주변기기 모드를 모두 지원하지 않는 하드웨어의 경우 두 모드 모두에서 기기를 사용하려고 하면 정의되지 않은 동작이 발생하거나 다른 중앙 역할 애플리케이션 (저전력 블루투스 기기 검색 포함)이 올바르게 작동하지 않게 됩니다.

매개변수

• 광고

  광고

  광고할 광고입니다.

• 콜백

  함수 선택사항

  callback 매개변수는 다음과 같습니다.

  (advertisementId: number) => void

  • advertisementId

    숫자

반환 값

• Promise<number>

  Chrome 91 이상

  Promise는 Manifest V3 이상에서만 지원되며 다른 플랫폼에서는 콜백을 사용해야 합니다.

registerService()

Promise Chrome 52 이상

chrome.bluetoothLowEnergy.registerService(
  serviceId: string,
  callback?: function,
)

로컬 GATT 서버에 지정된 서비스를 등록합니다. 서비스 ID가 유효하지 않으면 lastError가 설정됩니다. 이 함수는 앱에 bluetooth:low_energy 및 bluetooth:peripheral 권한이 모두 true로 설정된 경우에만 사용할 수 있습니다. 일부 앱에서는 주변기기 권한을 사용할 수 없습니다.

매개변수

• serviceId

  문자열

  생성된 서비스의 고유 ID입니다.

• 콜백

  함수 선택사항

  callback 매개변수는 다음과 같습니다.

  () => void

반환 값

• Promise<void>

  Chrome 91 이상

  Promise는 Manifest V3 이상에서만 지원되며 다른 플랫폼에서는 콜백을 사용해야 합니다.

removeService()

Promise Chrome 52 이상

chrome.bluetoothLowEnergy.removeService(
  serviceId: string,
  callback?: function,
)

지정된 서비스를 삭제하고 등록된 경우 등록을 취소합니다. 서비스 ID가 유효하지 않으면 lastError가 설정됩니다. 이 함수는 앱에 bluetooth:low_energy 및 bluetooth:peripheral 권한이 모두 true로 설정된 경우에만 사용할 수 있습니다. 일부 앱에서는 주변기기 권한을 사용할 수 없습니다.

매개변수

• serviceId

  문자열

  현재 등록된 서비스의 고유 ID입니다.

• 콜백

  함수 선택사항

  callback 매개변수는 다음과 같습니다.

  () => void

반환 값

• Promise<void>

  Chrome 91 이상

  Promise는 Manifest V3 이상에서만 지원되며 다른 플랫폼에서는 콜백을 사용해야 합니다.

resetAdvertising()

Promise Chrome 61 이상

chrome.bluetoothLowEnergy.resetAdvertising(
  callback?: function,
)

현재 기기의 광고를 재설정합니다. 그러면 모든 기존 광고가 등록 취소되고 중지됩니다.

매개변수

• 콜백

  함수 선택사항

  callback 매개변수는 다음과 같습니다.

  () => void

반환 값

• Promise<void>

  Chrome 91 이상

  Promise는 Manifest V3 이상에서만 지원되며 다른 플랫폼에서는 콜백을 사용해야 합니다.

sendRequestResponse()

Chrome 52 이상

chrome.bluetoothLowEnergy.sendRequestResponse(
  response: Response,
)

특성 또는 설명자 읽기/쓰기 요청에 대한 응답을 전송합니다. 이 함수는 앱에 bluetooth:low_energy 및 bluetooth:peripheral 권한이 모두 true로 설정된 경우에만 사용할 수 있습니다. 일부 앱에서는 주변기기 권한을 사용할 수 없습니다.

매개변수

• 응답

  응답

  요청에 대한 응답입니다.

setAdvertisingInterval()

Promise Chrome 55 이상

chrome.bluetoothLowEnergy.setAdvertisingInterval(
  minInterval: number,
  maxInterval: number,
  callback?: function,
)

연속된 두 광고 사이의 간격을 설정합니다. 참고: 최선의 방식으로 처리됩니다. 실제 간격은 요청된 간격과 상당히 다를 수 있습니다. 일부 하드웨어에서는 최소 간격이 100ms입니다. 최솟값과 최댓값은 블루투스 4.2 사양에서 허용하는 범위를 초과할 수 없습니다.

매개변수

• minInterval

  숫자

  광고 간 최소 간격 (밀리초)입니다. 이 값은 사양에 따라 20밀리초 미만이어야 합니다.

• maxInterval

  숫자

  광고 간 최대 간격 (밀리초)입니다. 사양에 따라 10240ms를 초과할 수 없습니다.

• 콜백

  함수 선택사항

  callback 매개변수는 다음과 같습니다.

  () => void

반환 값

• Promise<void>

  Chrome 91 이상

  Promise는 Manifest V3 이상에서만 지원되며 다른 플랫폼에서는 콜백을 사용해야 합니다.

startCharacteristicNotifications()

Promise

chrome.bluetoothLowEnergy.startCharacteristicNotifications(
  characteristicId: string,
  properties?: NotificationProperties,
  callback?: function,
)

지정된 특성에서 값 알림/표시를 사용 설정합니다. 사용 설정되면 애플리케이션은 onCharacteristicValueChanged 이벤트를 사용하여 알림을 수신 대기할 수 있습니다.

매개변수

• characteristicId

  문자열

  알림을 사용 설정해야 하는 GATT 특성의 인스턴스 ID입니다.

• 속성

  NotificationProperties 선택사항

  알림 세션 속성 (선택사항).

• 콜백

  함수 선택사항

  callback 매개변수는 다음과 같습니다.

  () => void

반환 값

• Promise<void>

  Chrome 91 이상

  Promise는 Manifest V3 이상에서만 지원되며 다른 플랫폼에서는 콜백을 사용해야 합니다.

stopCharacteristicNotifications()

Promise

chrome.bluetoothLowEnergy.stopCharacteristicNotifications(
  characteristicId: string,
  callback?: function,
)

지정된 특성에서 값 알림/표시를 사용 중지합니다. 호출이 성공하면 애플리케이션은 이 특성에서 알림/표시를 더 이상 수신하지 않습니다.

매개변수

• characteristicId

  문자열

  이 앱의 알림 세션을 중지해야 하는 GATT 특성의 인스턴스 ID입니다.

• 콜백

  함수 선택사항

  callback 매개변수는 다음과 같습니다.

  () => void

반환 값

• Promise<void>

  Chrome 91 이상

  Promise는 Manifest V3 이상에서만 지원되며 다른 플랫폼에서는 콜백을 사용해야 합니다.

unregisterAdvertisement()

Promise Chrome 47 이상

chrome.bluetoothLowEnergy.unregisterAdvertisement(
  advertisementId: number,
  callback?: function,
)

광고를 등록 취소하고 광고를 중지합니다. 광고가 등록 취소되지 않으면 광고를 중지하는 유일한 방법은 기기를 다시 시작하는 것입니다.

매개변수

• advertisementId

  숫자

  등록 취소할 광고의 ID입니다.

• 콜백

  함수 선택사항

  callback 매개변수는 다음과 같습니다.

  () => void

반환 값

• Promise<void>

  Chrome 91 이상

  Promise는 Manifest V3 이상에서만 지원되며 다른 플랫폼에서는 콜백을 사용해야 합니다.

unregisterService()

Promise Chrome 52 이상

chrome.bluetoothLowEnergy.unregisterService(
  serviceId: string,
  callback?: function,
)

로컬 GATT 서버에서 지정된 서비스를 등록 취소합니다. 서비스 ID가 유효하지 않으면 lastError가 설정됩니다. 이 함수는 앱에 bluetooth:low_energy 및 bluetooth:peripheral 권한이 모두 true로 설정된 경우에만 사용할 수 있습니다. 일부 앱에서는 주변기기 권한을 사용할 수 없습니다.

매개변수

• serviceId

  문자열

  현재 등록된 서비스의 고유 ID입니다.

• 콜백

  함수 선택사항

  callback 매개변수는 다음과 같습니다.

  () => void

반환 값

• Promise<void>

  Chrome 91 이상

  Promise는 Manifest V3 이상에서만 지원되며 다른 플랫폼에서는 콜백을 사용해야 합니다.

writeCharacteristicValue()

Promise

chrome.bluetoothLowEnergy.writeCharacteristicValue(
  characteristicId: string,
  value: ArrayBuffer,
  callback?: function,
)

원격 주변기기에서 지정된 특성의 값을 씁니다.

매개변수

• characteristicId

  문자열

  값을 써야 하는 GATT 특성의 인스턴스 ID입니다.

• 값

  ArrayBuffer

  쓰기 요청의 일부로 원격 특성에 전송해야 하는 값입니다.

• 콜백

  함수 선택사항

  callback 매개변수는 다음과 같습니다.

  () => void

반환 값

• Promise<void>

  Chrome 91 이상

  Promise는 Manifest V3 이상에서만 지원되며 다른 플랫폼에서는 콜백을 사용해야 합니다.

writeDescriptorValue()

Promise

chrome.bluetoothLowEnergy.writeDescriptorValue(
  descriptorId: string,
  value: ArrayBuffer,
  callback?: function,
)

원격 주변기기에서 지정된 특성 설명자의 값을 씁니다.

매개변수

• descriptorId

  문자열

  값을 써야 하는 GATT 특성 설명자의 인스턴스 ID입니다.

• 값

  ArrayBuffer

  쓰기 요청의 일부로 원격 설명자에 전송해야 하는 값입니다.

• 콜백

  함수 선택사항

  callback 매개변수는 다음과 같습니다.

  () => void

반환 값

• Promise<void>

  Chrome 91 이상

  Promise는 Manifest V3 이상에서만 지원되며 다른 플랫폼에서는 콜백을 사용해야 합니다.

이벤트

onCharacteristicReadRequest

Chrome 52 이상

chrome.bluetoothLowEnergy.onCharacteristicReadRequest.addListener(
  callback: function,
)

연결된 중앙 기기가 로컬 GATT 서버에 등록된 특성의 값을 읽도록 요청할 때 실행됩니다. 이 요청에 장시간 응답하지 않으면 연결이 끊어질 수 있습니다. 이 이벤트는 앱에 bluetooth:low_energy 및 bluetooth:peripheral 권한이 모두 true로 설정된 경우에만 사용할 수 있습니다. 일부 앱에서는 주변기기 권한을 사용할 수 없습니다.

매개변수

• 콜백

  함수

  callback 매개변수는 다음과 같습니다.

  (request: Request, characteristicId: string) => void

  • 요청

    요청

  • characteristicId

    문자열

onCharacteristicValueChanged

chrome.bluetoothLowEnergy.onCharacteristicValueChanged.addListener(
  callback: function,
)

읽기 요청 또는 값 변경 알림/표시의 결과로 원격 GATT 특성의 값이 변경될 때 실행됩니다. 이 이벤트는 앱이 startCharacteristicNotifications를 호출하여 알림을 사용 설정한 경우에만 전송됩니다.

매개변수

• 콜백

  함수

  callback 매개변수는 다음과 같습니다.

  (characteristic: Characteristic) => void

  • 특성

    특성

onCharacteristicWriteRequest

Chrome 52 이상

chrome.bluetoothLowEnergy.onCharacteristicWriteRequest.addListener(
  callback: function,
)

연결된 중앙 기기가 로컬 GATT 서버에 등록된 특성의 값을 쓰도록 요청할 때 실행됩니다. 이 요청에 장시간 응답하지 않으면 연결이 끊어질 수 있습니다. 이 이벤트는 앱에 bluetooth:low_energy 및 bluetooth:peripheral 권한이 모두 true로 설정된 경우에만 사용할 수 있습니다. 일부 앱에서는 주변기기 권한을 사용할 수 없습니다.

매개변수

• 콜백

  함수

  callback 매개변수는 다음과 같습니다.

  (request: Request, characteristicId: string) => void

  • 요청

    요청

  • characteristicId

    문자열

onDescriptorReadRequest

Chrome 52 이상

chrome.bluetoothLowEnergy.onDescriptorReadRequest.addListener(
  callback: function,
)

연결된 중앙 기기가 로컬 GATT 서버에 등록된 설명자의 값을 읽도록 요청할 때 실행됩니다. 이 요청에 장시간 응답하지 않으면 연결이 끊어질 수 있습니다. 이 이벤트는 앱에 bluetooth:low_energy 및 bluetooth:peripheral 권한이 모두 true로 설정된 경우에만 사용할 수 있습니다. 일부 앱에서는 주변기기 권한을 사용할 수 없습니다.

매개변수

• 콜백

  함수

  callback 매개변수는 다음과 같습니다.

  (request: Request, descriptorId: string) => void

  • 요청

    요청

  • descriptorId

    문자열

onDescriptorValueChanged

chrome.bluetoothLowEnergy.onDescriptorValueChanged.addListener(
  callback: function,
)

일반적으로 읽기 요청의 결과로 원격 GATT 특성 설명자의 값이 변경될 때 실행됩니다. 이 이벤트는 주로 편의를 위해 존재하며 readDescriptorValue를 성공적으로 호출한 후에 항상 전송됩니다.

매개변수

• 콜백

  함수

  callback 매개변수는 다음과 같습니다.

  (descriptor: Descriptor) => void

  • 설명어

    Descriptor

onDescriptorWriteRequest

Chrome 52 이상

chrome.bluetoothLowEnergy.onDescriptorWriteRequest.addListener(
  callback: function,
)

연결된 중앙 기기가 로컬 GATT 서버에 등록된 설명자의 값을 쓰도록 요청할 때 실행됩니다. 이 요청에 장시간 응답하지 않으면 연결이 끊어질 수 있습니다. 이 이벤트는 앱에 bluetooth:low_energy 및 bluetooth:peripheral 권한이 모두 true로 설정된 경우에만 사용할 수 있습니다. 일부 앱에서는 주변기기 권한을 사용할 수 없습니다.

매개변수

• 콜백

  함수

  callback 매개변수는 다음과 같습니다.

  (request: Request, descriptorId: string) => void

  • 요청

    요청

  • descriptorId

    문자열

onServiceAdded

chrome.bluetoothLowEnergy.onServiceAdded.addListener(
  callback: function,
)

원격 기기에서 새 GATT 서비스가 감지되면 실행됩니다.

매개변수

• 콜백

  함수

  callback 매개변수는 다음과 같습니다.

  (service: Service) => void

  • 서비스

    서비스

onServiceChanged

chrome.bluetoothLowEnergy.onServiceChanged.addListener(
  callback: function,
)

원격 GATT 서비스의 상태가 변경될 때 실행됩니다. 여기에는 서비스에 추가되거나 삭제되는 모든 특성 또는 설명자와 원격 기기의 'ServiceChanged' 알림이 포함됩니다.

매개변수

• 콜백

  함수

  callback 매개변수는 다음과 같습니다.

  (service: Service) => void

  • 서비스

    서비스

onServiceRemoved

chrome.bluetoothLowEnergy.onServiceRemoved.addListener(
  callback: function,
)

이전에 원격 기기에서 검색된 GATT 서비스가 삭제될 때 실행됩니다.

매개변수

• 콜백

  함수

  callback 매개변수는 다음과 같습니다.

  (service: Service) => void

  • 서비스

    서비스