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 주소를 사용하여 브로드캐스트합니다. '주변기기'로 설정할 경우 광고 유형은 ADV_IND 또는 ADV_SCAN_IND이며 기기는 실제 블루투스 어댑터의 MAC 주소로 브로드캐스트합니다.

열거형

"broadcast"

Characteristic

속성

  • instanceId

    문자열 선택사항

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

  • 이 특성의 속성입니다.

  • 서비스

    서비스 선택사항

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

  • uuid

    string

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

  • 값

    ArrayBuffer 선택사항

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

CharacteristicProperty

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

열거형

"broadcast"

"writeWithoutResponse"

"extendedProperties"

"writableAuxiliaries"

"encryptRead"

"encryptWrite"

"encryptAuthenticatedRead"

"encryptAuthenticatedWrite"

ConnectProperties

속성

  • 영구

    boolean

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

Descriptor

속성

  • 특성

    특성 선택사항

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

  • instanceId

    문자열 선택사항

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

  • Chrome 52 이상

    이 설명자의 권한입니다.

  • uuid

    string

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

  • 값

    ArrayBuffer 선택사항

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

DescriptorPermission

Chrome 52 이상

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

열거형

"encryptedRead"

"encryptedWrite"

"encryptedAuthenticatedRead"

"encryptedAuthenticatedWrite"

Device

Chrome 52 이상

속성

  • 주소

    string

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

  • deviceClass

    number 선택사항

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

  • 이름

    문자열 선택사항

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

ManufacturerData

Chrome 47 이상

속성

  • 데이터

    숫자[]

  • id

    숫자

Notification

Chrome 52 이상

속성

  • shouldIndicate

    부울 선택사항

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

  • 값

    ArrayBuffer

    특성의 새 값입니다.

NotificationProperties

속성

  • 영구

    boolean

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

Request

Chrome 52 이상

속성

  • 기기

    기기

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

  • requestId

    숫자

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

  • 값

    ArrayBuffer 선택사항

    쓸 값입니다 (쓰기 요청인 경우).

Response

Chrome 52 이상

속성

  • isError

    boolean

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

  • requestId

    숫자

    응답 대상 요청의 ID입니다.

  • 값

    ArrayBuffer 선택사항

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

Service

속성

  • deviceAddress

    문자열 선택사항

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

  • instanceId

    문자열 선택사항

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

  • isPrimary

    boolean

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

  • uuid

    string

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

ServiceData

Chrome 47 이상

속성

  • 데이터

    숫자[]

  • uuid

    string

방법

connect()

프로미스 
chrome.bluetoothLowEnergy.connect(
  deviceAddress: string,
  properties?: ConnectProperties,
  callback?: function,
)

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

매개변수

  • deviceAddress

    string

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

  • 속성

    ConnectProperties 선택사항

    연결 속성 (선택사항)

  • 콜백

    함수 선택사항

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

    ()=>void

반환 값

  • Promise<void>

    Chrome 91 이상

    프로미스는 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

    string

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

  • 콜백

    함수 선택사항

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

    (characteristicId: string)=>void

    • characteristicId

      string

반환 값

  • 프로미스<string>

    Chrome 91 이상

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

createDescriptor()

Promise Chrome 52 이상 
chrome.bluetoothLowEnergy.createDescriptor(
  descriptor: Descriptor,
  characteristicId: string,
  callback?: function,
)

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

매개변수

  • 설명어

    설명어

    생성할 설명자입니다.

  • characteristicId

    string

    이 설명자를 생성할 특성의 ID입니다.

  • 콜백

    함수 선택사항

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

    (descriptorId: string)=>void

    • descriptorId

      string

반환 값

  • 프로미스<string>

    Chrome 91 이상

    프로미스는 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

      string

반환 값

  • 프로미스<string>

    Chrome 91 이상

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

disconnect()

프로미스 
chrome.bluetoothLowEnergy.disconnect(
  deviceAddress: string,
  callback?: function,
)

지정된 주소를 사용하는 기기에 대한 앱의 연결을 닫습니다. 열려 있는 다른 앱이 있을 수 있으므로 이 경우 실제 링크 자체가 항상 소멸되는 것은 아닙니다.

매개변수

  • deviceAddress

    string

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

  • 콜백

    함수 선택사항

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

    ()=>void

반환 값

  • Promise<void>

    Chrome 91 이상

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

getCharacteristic()

프로미스 
chrome.bluetoothLowEnergy.getCharacteristic(
  characteristicId: string,
  callback?: function,
)

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

매개변수

  • characteristicId

    string

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

  • 콜백

    함수 선택사항

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

    (result: Characteristic)=>void

반환 값

  • Promise<Characteristic>

    Chrome 91 이상

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

getCharacteristics()

프로미스 
chrome.bluetoothLowEnergy.getCharacteristics(
  serviceId: string,
  callback?: function,
)

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

매개변수

  • serviceId

    string

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

  • 콜백

    함수 선택사항

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

    (result: Characteristic[])=>void

반환 값

  • Promise<Characteristic[]>

    Chrome 91 이상

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

getDescriptor()

프로미스 
chrome.bluetoothLowEnergy.getDescriptor(
  descriptorId: string,
  callback?: function,
)

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

매개변수

  • descriptorId

    string

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

  • 콜백

    함수 선택사항

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

    (result: Descriptor)=>void

반환 값

  • Promise<Descriptor>

    Chrome 91 이상

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

getDescriptors()

프로미스 
chrome.bluetoothLowEnergy.getDescriptors(
  characteristicId: string,
  callback?: function,
)

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

매개변수

  • characteristicId

    string

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

  • 콜백

    함수 선택사항

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

    (result: Descriptor[])=>void

반환 값

  • Promise<Descriptor[]>

    Chrome 91 이상

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

getIncludedServices()

프로미스 
chrome.bluetoothLowEnergy.getIncludedServices(
  serviceId: string,
  callback?: function,
)

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

매개변수

  • serviceId

    string

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

  • 콜백

    함수 선택사항

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

    (result: Service[])=>void

반환 값

  • 프로미스<서비스[]>

    Chrome 91 이상

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

getService()

프로미스 
chrome.bluetoothLowEnergy.getService(
  serviceId: string,
  callback?: function,
)

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

매개변수

  • serviceId

    string

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

  • 콜백

    함수 선택사항

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

    (result: Service)=>void

반환 값

  • 프로미스<서비스>

    Chrome 91 이상

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

getServices()

프로미스 
chrome.bluetoothLowEnergy.getServices(
  deviceAddress: string,
  callback?: function,
)

주어진 기기 주소를 사용하여 원격 기기에서 발견된 모든 GATT 서비스를 가져옵니다.

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

매개변수

  • deviceAddress

    string

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

  • 콜백

    함수 선택사항

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

    (result: Service[])=>void

반환 값

  • 프로미스<서비스[]>

    Chrome 91 이상

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

notifyCharacteristicValueChanged()

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

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

매개변수

  • characteristicId

    string

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

  • 알림

    알림

  • 콜백

    함수 선택사항

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

    ()=>void

반환 값

  • Promise<void>

    Chrome 91 이상

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

readCharacteristicValue()

프로미스 
chrome.bluetoothLowEnergy.readCharacteristicValue(
  characteristicId: string,
  callback?: function,
)

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

매개변수

  • characteristicId

    string

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

  • 콜백

    함수 선택사항

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

    (result: Characteristic)=>void

반환 값

  • Promise<Characteristic>

    Chrome 91 이상

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

readDescriptorValue()

프로미스 
chrome.bluetoothLowEnergy.readDescriptorValue(
  descriptorId: string,
  callback?: function,
)

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

매개변수

  • descriptorId

    string

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

  • 콜백

    함수 선택사항

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

    (result: Descriptor)=>void

반환 값

  • Promise<Descriptor>

    Chrome 91 이상

    프로미스는 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

      숫자

반환 값

  • 프로미스<number>

    Chrome 91 이상

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

registerService()

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

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

매개변수

  • serviceId

    string

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

  • 콜백

    함수 선택사항

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

    ()=>void

반환 값

  • Promise<void>

    Chrome 91 이상

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

removeService()

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

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

매개변수

  • serviceId

    string

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

  • 콜백

    함수 선택사항

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

    ()=>void

반환 값

  • Promise<void>

    Chrome 91 이상

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

resetAdvertising()

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

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

매개변수

  • 콜백

    함수 선택사항

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

    ()=>void

반환 값

  • Promise<void>

    Chrome 91 이상

    프로미스는 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

    숫자

    광고 사이의 최소 간격 (밀리초)입니다. 이는 사양에 따라 20ms 이상이어야 합니다.

  • maxInterval

    숫자

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

  • 콜백

    함수 선택사항

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

    ()=>void

반환 값

  • Promise<void>

    Chrome 91 이상

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

startCharacteristicNotifications()

프로미스 
chrome.bluetoothLowEnergy.startCharacteristicNotifications(
  characteristicId: string,
  properties?: NotificationProperties,
  callback?: function,
)

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

매개변수

  • characteristicId

    string

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

  • 속성

    NotificationProperties 선택사항

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

  • 콜백

    함수 선택사항

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

    ()=>void

반환 값

  • Promise<void>

    Chrome 91 이상

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

stopCharacteristicNotifications()

프로미스 
chrome.bluetoothLowEnergy.stopCharacteristicNotifications(
  characteristicId: string,
  callback?: function,
)

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

매개변수

  • characteristicId

    string

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

  • 콜백

    함수 선택사항

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

    ()=>void

반환 값

  • Promise<void>

    Chrome 91 이상

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

unregisterAdvertisement()

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

광고 등록을 취소하고 광고를 중지합니다. 광고가 등록 취소되지 않는 경우 광고를 중지하는 유일한 방법은 기기를 다시 시작하는 것일 수 있습니다.

매개변수

  • advertisementId

    숫자

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

  • 콜백

    함수 선택사항

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

    ()=>void

반환 값

  • Promise<void>

    Chrome 91 이상

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

unregisterService()

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

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

매개변수

  • serviceId

    string

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

  • 콜백

    함수 선택사항

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

    ()=>void

반환 값

  • Promise<void>

    Chrome 91 이상

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

writeCharacteristicValue()

프로미스 
chrome.bluetoothLowEnergy.writeCharacteristicValue(
  characteristicId: string,
  value: ArrayBuffer,
  callback?: function,
)

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

매개변수

  • characteristicId

    string

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

  • 값

    ArrayBuffer

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

  • 콜백

    함수 선택사항

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

    ()=>void

반환 값

  • Promise<void>

    Chrome 91 이상

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

writeDescriptorValue()

프로미스 
chrome.bluetoothLowEnergy.writeDescriptorValue(
  descriptorId: string,
  value: ArrayBuffer,
  callback?: function,
)

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

매개변수

  • descriptorId

    string

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

  • 값

    ArrayBuffer

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

  • 콜백

    함수 선택사항

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

    ()=>void

반환 값

  • Promise<void>

    Chrome 91 이상

    프로미스는 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

      string

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

      string

onDescriptorReadRequest

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

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

매개변수

  • 콜백

    기능

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

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

    • 요청

      요청

    • descriptorId

      string

onDescriptorValueChanged

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

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

매개변수

  • 콜백

    기능

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

    (descriptor: Descriptor)=>void

onDescriptorWriteRequest

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

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

매개변수

  • 콜백

    기능

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

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

    • 요청

      요청

    • descriptorId

      string

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