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[] 선택사항

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

  • 광고 유형입니다.

AdvertisementType

Chrome 47 이상

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

열거형

"broadcast"

'peripheral'

Characteristic

속성

  • instanceId

    문자열 선택사항

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

  • 이 특성의 속성입니다.

  • 서비스

    서비스 선택사항

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

  • uuid

    문자열

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

  • 값

    ArrayBuffer 선택사항

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

CharacteristicProperty

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

열거형

"broadcast"

"read"

'writeWithoutResponse'

"write"

'notify'

'indicate'

"authenticatedSignedWrites"

"extendedProperties"

'reliableWrite'

"writableAuxiliaries"

"encryptRead"

'encryptWrite'

"encryptAuthenticatedRead"

"encryptAuthenticatedWrite"

ConnectProperties

속성

  • 영구

    부울

    애플리케이션의 이벤트 페이지가 언로드될 때 기기에 대한 연결이 열린 상태로 유지되는지 여부를 나타내는 플래그입니다 (앱 수명 주기 관리 참고). 기본값은 false.입니다.

Descriptor

속성

  • 특성

    특성 선택사항

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

  • instanceId

    문자열 선택사항

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

  • Chrome 52 이상

    이 설명자의 권한입니다.

  • uuid

    문자열

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

  • 값

    ArrayBuffer 선택사항

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

DescriptorPermission

Chrome 52 이상

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

열거형

"read"

"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 서비스가 속한 원격 주변기기의 기기 주소입니다. 이 인스턴스가 원격 서비스를 나타내는 경우 표시됩니다.

  • instanceId

    문자열 선택사항

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

  • isPrimary

    부울

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

  • uuid

    문자열

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

ServiceData

Chrome 47 이상

속성

  • 데이터

    number[]

  • uuid

    문자열

메서드

connect()

Promise 
chrome.bluetoothLowEnergy.connect(
  deviceAddress: string,
  properties?: ConnectProperties,
  callback?: function,
): Promise<void>

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

매개변수

  • deviceAddress

    문자열

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

  • 속성

    ConnectProperties 선택사항

    연결 속성 (선택사항)입니다.

  • callback

    함수 선택사항

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

    () => void

반환 값

  • Promise<void>

    Chrome 91 이상

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

createCharacteristic()

Promise Chrome 52 이상 
chrome.bluetoothLowEnergy.createCharacteristic(
  characteristic: Characteristic,
  serviceId: string,
  callback?: function,
): Promise<string>

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

매개변수

  • 특성

    특성

    만들 특성입니다.

  • serviceId

    문자열

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

  • callback

    함수 선택사항

    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,
): Promise<string>

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

매개변수

  • 설명어

    설명어

    생성할 설명자입니다.

  • characteristicId

    문자열

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

  • callback

    함수 선택사항

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

    (descriptorId: string) => void

    • descriptorId

      문자열

반환 값

  • Promise<string>

    Chrome 91 이상

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

createService()

Promise Chrome 52 이상 
chrome.bluetoothLowEnergy.createService(
  service: Service,
  callback?: function,
): Promise<string>

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

매개변수

  • 서비스

    서비스

    만들 서비스입니다.

  • callback

    함수 선택사항

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

    (serviceId: string) => void

    • serviceId

      문자열

반환 값

  • Promise<string>

    Chrome 91 이상

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

disconnect()

Promise 
chrome.bluetoothLowEnergy.disconnect(
  deviceAddress: string,
  callback?: function,
): Promise<void>

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

매개변수

  • deviceAddress

    문자열

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

  • callback

    함수 선택사항

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

    () => void

반환 값

  • Promise<void>

    Chrome 91 이상

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

getCharacteristic()

Promise 
chrome.bluetoothLowEnergy.getCharacteristic(
  characteristicId: string,
  callback?: function,
): Promise<Characteristic>

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

매개변수

  • characteristicId

    문자열

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

  • callback

    함수 선택사항

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

    (result: Characteristic) => void

반환 값

  • Promise<Characteristic>

    Chrome 91 이상

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

getCharacteristics()

Promise 
chrome.bluetoothLowEnergy.getCharacteristics(
  serviceId: string,
  callback?: function,
): Promise<Characteristic[]>

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

매개변수

  • serviceId

    문자열

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

  • callback

    함수 선택사항

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

    (result: Characteristic[]) => void

반환 값

  • Promise<Characteristic[]>

    Chrome 91 이상

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

getDescriptor()

Promise 
chrome.bluetoothLowEnergy.getDescriptor(
  descriptorId: string,
  callback?: function,
): Promise<Descriptor>

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

매개변수

  • descriptorId

    문자열

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

  • callback

    함수 선택사항

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

    (result: Descriptor) => void

반환 값

  • Promise<Descriptor>

    Chrome 91 이상

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

getDescriptors()

Promise 
chrome.bluetoothLowEnergy.getDescriptors(
  characteristicId: string,
  callback?: function,
): Promise<Descriptor[]>

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

매개변수

  • characteristicId

    문자열

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

  • callback

    함수 선택사항

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

    (result: Descriptor[]) => void

반환 값

  • Promise<Descriptor[]>

    Chrome 91 이상

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

getIncludedServices()

Promise 
chrome.bluetoothLowEnergy.getIncludedServices(
  serviceId: string,
  callback?: function,
): Promise<Service[]>

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

매개변수

  • serviceId

    문자열

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

  • callback

    함수 선택사항

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

    (result: Service[]) => void

반환 값

  • Promise<Service[]>

    Chrome 91 이상

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

getService()

Promise 
chrome.bluetoothLowEnergy.getService(
  serviceId: string,
  callback?: function,
): Promise<Service>

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

매개변수

  • serviceId

    문자열

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

  • callback

    함수 선택사항

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

    (result: Service) => void

반환 값

  • Promise<Service>

    Chrome 91 이상

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

getServices()

Promise 
chrome.bluetoothLowEnergy.getServices(
  deviceAddress: string,
  callback?: function,
): Promise<Service[]>

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

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

매개변수

  • deviceAddress

    문자열

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

  • callback

    함수 선택사항

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

    (result: Service[]) => void

반환 값

  • Promise<Service[]>

    Chrome 91 이상

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

notifyCharacteristicValueChanged()

Promise Chrome 52 이상 
chrome.bluetoothLowEnergy.notifyCharacteristicValueChanged(
  characteristicId: string,
  notification: Notification,
  callback?: function,
): Promise<void>

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

매개변수

  • characteristicId

    문자열

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

  • 알림

    알림

  • callback

    함수 선택사항

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

    () => void

반환 값

  • Promise<void>

    Chrome 91 이상

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

readCharacteristicValue()

Promise 
chrome.bluetoothLowEnergy.readCharacteristicValue(
  characteristicId: string,
  callback?: function,
): Promise<Characteristic>

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

매개변수

  • characteristicId

    문자열

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

  • callback

    함수 선택사항

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

    (result: Characteristic) => void

반환 값

  • Promise<Characteristic>

    Chrome 91 이상

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

readDescriptorValue()

Promise 
chrome.bluetoothLowEnergy.readDescriptorValue(
  descriptorId: string,
  callback?: function,
): Promise<Descriptor>

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

매개변수

  • descriptorId

    문자열

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

  • callback

    함수 선택사항

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

    (result: Descriptor) => void

반환 값

  • Promise<Descriptor>

    Chrome 91 이상

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

registerAdvertisement()

Promise Chrome 47 이상 
chrome.bluetoothLowEnergy.registerAdvertisement(
  advertisement: Advertisement,
  callback?: function,
): Promise<number>

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

매개변수

  • 광고

    광고

    광고할 광고입니다.

  • callback

    함수 선택사항

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

    (advertisementId: number) => void

    • advertisementId

      숫자

반환 값

  • Promise<number>

    Chrome 91 이상

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

registerService()

Promise Chrome 52 이상 
chrome.bluetoothLowEnergy.registerService(
  serviceId: string,
  callback?: function,
): Promise<void>

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

매개변수

  • serviceId

    문자열

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

  • callback

    함수 선택사항

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

    () => void

반환 값

  • Promise<void>

    Chrome 91 이상

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

removeService()

Promise Chrome 52 이상 
chrome.bluetoothLowEnergy.removeService(
  serviceId: string,
  callback?: function,
): Promise<void>

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

매개변수

  • serviceId

    문자열

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

  • callback

    함수 선택사항

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

    () => void

반환 값

  • Promise<void>

    Chrome 91 이상

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

resetAdvertising()

Promise Chrome 61 이상 
chrome.bluetoothLowEnergy.resetAdvertising(
  callback?: function,
): Promise<void>

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

매개변수

  • callback

    함수 선택사항

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

    () => void

반환 값

  • Promise<void>

    Chrome 91 이상

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

sendRequestResponse()

Chrome 52 이상 
chrome.bluetoothLowEnergy.sendRequestResponse(
  response: Response,
): void

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

매개변수

  • 응답

    응답

    요청에 대한 응답입니다.

setAdvertisingInterval()

Promise Chrome 55 이상 
chrome.bluetoothLowEnergy.setAdvertisingInterval(
  minInterval: number,
  maxInterval: number,
  callback?: function,
): Promise<void>

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

매개변수

  • minInterval

    숫자

    광고 간 최소 간격 (밀리초)입니다. 이 값은 사양에 따라 20ms보다 작을 수 없습니다.

  • maxInterval

    숫자

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

  • callback

    함수 선택사항

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

    () => void

반환 값

  • Promise<void>

    Chrome 91 이상

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

startCharacteristicNotifications()

Promise 
chrome.bluetoothLowEnergy.startCharacteristicNotifications(
  characteristicId: string,
  properties?: NotificationProperties,
  callback?: function,
): Promise<void>

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

매개변수

  • characteristicId

    문자열

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

  • 속성

    NotificationProperties 선택사항

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

  • callback

    함수 선택사항

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

    () => void

반환 값

  • Promise<void>

    Chrome 91 이상

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

stopCharacteristicNotifications()

Promise 
chrome.bluetoothLowEnergy.stopCharacteristicNotifications(
  characteristicId: string,
  callback?: function,
): Promise<void>

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

매개변수

  • characteristicId

    문자열

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

  • callback

    함수 선택사항

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

    () => void

반환 값

  • Promise<void>

    Chrome 91 이상

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

unregisterAdvertisement()

Promise Chrome 47 이상 
chrome.bluetoothLowEnergy.unregisterAdvertisement(
  advertisementId: number,
  callback?: function,
): Promise<void>

광고를 등록 해제하고 광고를 중지합니다. 광고 등록 해제에 실패하면 광고를 중지하는 유일한 방법은 기기를 다시 시작하는 것일 수 있습니다.

매개변수

  • advertisementId

    숫자

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

  • callback

    함수 선택사항

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

    () => void

반환 값

  • Promise<void>

    Chrome 91 이상

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

unregisterService()

Promise Chrome 52 이상 
chrome.bluetoothLowEnergy.unregisterService(
  serviceId: string,
  callback?: function,
): Promise<void>

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

매개변수

  • serviceId

    문자열

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

  • callback

    함수 선택사항

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

    () => void

반환 값

  • Promise<void>

    Chrome 91 이상

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

writeCharacteristicValue()

Promise 
chrome.bluetoothLowEnergy.writeCharacteristicValue(
  characteristicId: string,
  value: ArrayBuffer,
  callback?: function,
): Promise<void>

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

매개변수

  • characteristicId

    문자열

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

  • 값

    ArrayBuffer

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

  • callback

    함수 선택사항

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

    () => void

반환 값

  • Promise<void>

    Chrome 91 이상

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

writeDescriptorValue()

Promise 
chrome.bluetoothLowEnergy.writeDescriptorValue(
  descriptorId: string,
  value: ArrayBuffer,
  callback?: function,
): Promise<void>

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

매개변수

  • descriptorId

    문자열

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

  • 값

    ArrayBuffer

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

  • callback

    함수 선택사항

    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

    함수

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

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

    • 요청

      요청

    • characteristicId

      문자열

onCharacteristicValueChanged

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

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

매개변수

  • callback

    함수

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

    (characteristic: Characteristic) => void

onCharacteristicWriteRequest

Chrome 52 이상 
chrome.bluetoothLowEnergy.onCharacteristicWriteRequest.addListener(
  callback: function,
)

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

매개변수

  • callback

    함수

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

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

    • 요청

      요청

    • characteristicId

      문자열

onDescriptorReadRequest

Chrome 52 이상 
chrome.bluetoothLowEnergy.onDescriptorReadRequest.addListener(
  callback: function,
)

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

매개변수

  • callback

    함수

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

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

    • 요청

      요청

    • descriptorId

      문자열

onDescriptorValueChanged

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

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

매개변수

  • callback

    함수

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

    (descriptor: Descriptor) => void

onDescriptorWriteRequest

Chrome 52 이상 
chrome.bluetoothLowEnergy.onDescriptorWriteRequest.addListener(
  callback: function,
)

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

매개변수

  • callback

    함수

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

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

    • 요청

      요청

    • descriptorId

      문자열

onServiceAdded

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

원격 기기에서 새 GATT 서비스가 검색될 때 발생합니다.

매개변수

  • callback

    함수

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

    (service: Service) => void

onServiceChanged

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

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

매개변수

  • callback

    함수

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

    (service: Service) => void

onServiceRemoved

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

원격 기기에서 이전에 검색된 GATT 서비스가 삭제될 때 발생합니다.

매개변수

  • callback

    함수

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

    (service: Service) => void