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 UUID'에 포함할 UUID 목록 필드입니다. 이러한 UUID는 16비트, 32비트, 128 형식일 수 있습니다.

  • 광고 유형입니다.

AdvertisementType

Chrome 47 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

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

열거형

"방송"

'주변기기'

Characteristic

속성

  • instanceId

    문자열(선택사항)

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

  • 이 특성의 속성입니다.

  • 서비스

    서비스 선택사항

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

  • uuid

    문자열

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

  • 값

    ArrayBuffer 선택사항

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

CharacteristicProperty

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

열거형

"방송"

"읽기"

"writeWithoutResponse"

"쓰기"

"알림"

"표시"

'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 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

설명자에 가능한 권한을 나타내는 값입니다. 개별 권한의 의미는 Bluetooth 4.x 사양을 참조하세요.

열거형

"읽기"

"쓰기"

"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 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

속성

  • 데이터

    숫자[]

  • id

    숫자

Notification

Chrome 52 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

속성

  • shouldIndicate

    불리언 선택사항

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

  • 값

    배열 버퍼

    특성의 새 값입니다.

NotificationProperties

속성

  • 영구

    부울

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

Request

Chrome 52 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

속성

  • 기기

    기기

    이 요청을 보내는 기기입니다.

  • requestId

    숫자

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

  • 값

    ArrayBuffer 선택사항

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

Response

Chrome 52 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

속성

  • isError

    부울

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

  • requestId

    숫자

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

  • 값

    ArrayBuffer 선택사항

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

Service

속성

  • deviceAddress

    문자열(선택사항)

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

  • instanceId

    문자열(선택사항)

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

  • 기본

    부울

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

  • uuid

    문자열

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

ServiceData

Chrome 47 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

속성

  • 데이터

    숫자[]

  • uuid

    문자열

메서드

connect()

<ph type="x-smartling-placeholder"></ph> 프로미스 를 통해 개인정보처리방침을 정의할 수 있습니다.
chrome.bluetoothLowEnergy.connect(
  deviceAddress: string,
  properties?: ConnectProperties,
  callback?: function,
)

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

매개변수

  • deviceAddress

    문자열

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

  • 속성

    ConnectProperties 선택사항

    연결 속성 (선택사항).

  • 콜백

    함수 선택사항

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

    () => void

반환 값

  • 프로미스<void>

    Chrome 91 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

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

createCharacteristic()

<ph type="x-smartling-placeholder"></ph> 프로미스 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

      문자열

반환 값

  • 프로미스<string>

    Chrome 91 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

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

createDescriptor()

<ph type="x-smartling-placeholder"></ph> 프로미스 Chrome 52 이상 
chrome.bluetoothLowEnergy.createDescriptor(
  descriptor: Descriptor,
  characteristicId: string,
  callback?: function,
)

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

매개변수

  • 설명어

    설명어

    생성할 설명자입니다.

  • characteristicId

    문자열

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

  • 콜백

    함수 선택사항

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

    (descriptorId: string) => void

    • descriptorId

      문자열

반환 값

  • 프로미스<string>

    Chrome 91 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

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

createService()

<ph type="x-smartling-placeholder"></ph> 프로미스 Chrome 52 이상 
chrome.bluetoothLowEnergy.createService(
  service: Service,
  callback?: function,
)

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

매개변수

  • 서비스

    서비스

    만들 서비스입니다.

  • 콜백

    함수 선택사항

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

    (serviceId: string) => void

    • serviceId

      문자열

반환 값

  • 프로미스<string>

    Chrome 91 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

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

disconnect()

<ph type="x-smartling-placeholder"></ph> 프로미스 를 통해 개인정보처리방침을 정의할 수 있습니다.
chrome.bluetoothLowEnergy.disconnect(
  deviceAddress: string,
  callback?: function,
)

지정된 주소를 사용하는 기기와 앱의 연결을 종료합니다. 열려 있는 다른 앱이 있을 수 있으므로 실제 링크 자체가 삭제되지는 않습니다.

매개변수

  • deviceAddress

    문자열

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

  • 콜백

    함수 선택사항

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

    () => void

반환 값

  • 프로미스<void>

    Chrome 91 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

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

getCharacteristic()

<ph type="x-smartling-placeholder"></ph> 프로미스 를 통해 개인정보처리방침을 정의할 수 있습니다.
chrome.bluetoothLowEnergy.getCharacteristic(
  characteristicId: string,
  callback?: function,
)

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

매개변수

  • characteristicId

    문자열

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

  • 콜백

    함수 선택사항

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

    (result: Characteristic) => void

반환 값

  • 프로미스<Characteristic>

    Chrome 91 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

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

getCharacteristics()

<ph type="x-smartling-placeholder"></ph> 프로미스 를 통해 개인정보처리방침을 정의할 수 있습니다.
chrome.bluetoothLowEnergy.getCharacteristics(
  serviceId: string,
  callback?: function,
)

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

매개변수

  • serviceId

    문자열

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

  • 콜백

    함수 선택사항

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

    (result: Characteristic[]) => void

반환 값

  • 프로미스<Characteristic[]>

    Chrome 91 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

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

getDescriptor()

<ph type="x-smartling-placeholder"></ph> 프로미스 를 통해 개인정보처리방침을 정의할 수 있습니다.
chrome.bluetoothLowEnergy.getDescriptor(
  descriptorId: string,
  callback?: function,
)

지정된 인스턴스 ID가 있는 GATT 특성 설명어를 가져옵니다.

매개변수

  • descriptorId

    문자열

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

  • 콜백

    함수 선택사항

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

    (result: Descriptor) => void

반환 값

  • Promise&lt;Descriptor&gt;

    Chrome 91 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

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

getDescriptors()

<ph type="x-smartling-placeholder"></ph> 프로미스 를 통해 개인정보처리방침을 정의할 수 있습니다.
chrome.bluetoothLowEnergy.getDescriptors(
  characteristicId: string,
  callback?: function,
)

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

매개변수

  • characteristicId

    문자열

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

  • 콜백

    함수 선택사항

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

    (result: Descriptor[]) => void

반환 값

  • Promise&lt;Descriptor[]&gt;

    Chrome 91 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

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

getIncludedServices()

<ph type="x-smartling-placeholder"></ph> 프로미스 를 통해 개인정보처리방침을 정의할 수 있습니다.
chrome.bluetoothLowEnergy.getIncludedServices(
  serviceId: string,
  callback?: function,
)

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

매개변수

  • serviceId

    문자열

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

  • 콜백

    함수 선택사항

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

    (result: Service[]) => void

반환 값

  • Promise<Service[]>

    Chrome 91 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

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

getService()

<ph type="x-smartling-placeholder"></ph> 프로미스 를 통해 개인정보처리방침을 정의할 수 있습니다.
chrome.bluetoothLowEnergy.getService(
  serviceId: string,
  callback?: function,
)

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

매개변수

  • serviceId

    문자열

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

  • 콜백

    함수 선택사항

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

    (result: Service) => void

반환 값

  • Promise&lt;Service&gt;

    Chrome 91 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

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

getServices()

<ph type="x-smartling-placeholder"></ph> 프로미스 를 통해 개인정보처리방침을 정의할 수 있습니다.
chrome.bluetoothLowEnergy.getServices(
  deviceAddress: string,
  callback?: function,
)

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

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

매개변수

  • deviceAddress

    문자열

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

  • 콜백

    함수 선택사항

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

    (result: Service[]) => void

반환 값

  • Promise<Service[]>

    Chrome 91 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

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

notifyCharacteristicValueChanged()

<ph type="x-smartling-placeholder"></ph> 프로미스 Chrome 52 이상 
chrome.bluetoothLowEnergy.notifyCharacteristicValueChanged(
  characteristicId: string,
  notification: Notification,
  callback?: function,
)

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

매개변수

  • characteristicId

    문자열

    알림을 보낼 특성입니다.

  • 알림

    알림

  • 콜백

    함수 선택사항

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

    () => void

반환 값

  • 프로미스<void>

    Chrome 91 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

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

readCharacteristicValue()

<ph type="x-smartling-placeholder"></ph> 프로미스 를 통해 개인정보처리방침을 정의할 수 있습니다.
chrome.bluetoothLowEnergy.readCharacteristicValue(
  characteristicId: string,
  callback?: function,
)

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

매개변수

  • characteristicId

    문자열

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

  • 콜백

    함수 선택사항

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

    (result: Characteristic) => void

반환 값

  • 프로미스<Characteristic>

    Chrome 91 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

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

readDescriptorValue()

<ph type="x-smartling-placeholder"></ph> 프로미스 를 통해 개인정보처리방침을 정의할 수 있습니다.
chrome.bluetoothLowEnergy.readDescriptorValue(
  descriptorId: string,
  callback?: function,
)

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

매개변수

  • descriptorId

    문자열

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

  • 콜백

    함수 선택사항

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

    (result: Descriptor) => void

반환 값

  • Promise&lt;Descriptor&gt;

    Chrome 91 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

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

registerAdvertisement()

<ph type="x-smartling-placeholder"></ph> 프로미스 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&lt;number&gt;

    Chrome 91 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

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

registerService()

<ph type="x-smartling-placeholder"></ph> 프로미스 Chrome 52 이상 
chrome.bluetoothLowEnergy.registerService(
  serviceId: string,
  callback?: function,
)

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

매개변수

  • serviceId

    문자열

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

  • 콜백

    함수 선택사항

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

    () => void

반환 값

  • 프로미스<void>

    Chrome 91 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

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

removeService()

<ph type="x-smartling-placeholder"></ph> 프로미스 Chrome 52 이상 
chrome.bluetoothLowEnergy.removeService(
  serviceId: string,
  callback?: function,
)

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

매개변수

  • serviceId

    문자열

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

  • 콜백

    함수 선택사항

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

    () => void

반환 값

  • 프로미스<void>

    Chrome 91 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

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

resetAdvertising()

<ph type="x-smartling-placeholder"></ph> 프로미스 Chrome 61 이상 
chrome.bluetoothLowEnergy.resetAdvertising(
  callback?: function,
)

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

매개변수

  • 콜백

    함수 선택사항

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

    () => void

반환 값

  • 프로미스<void>

    Chrome 91 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

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

sendRequestResponse()

Chrome 52 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.
chrome.bluetoothLowEnergy.sendRequestResponse(
  response: Response,
)

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

매개변수

  • 응답

    응답

    요청에 대한 응답입니다.

setAdvertisingInterval()

<ph type="x-smartling-placeholder"></ph> 프로미스 Chrome 55 이상 
chrome.bluetoothLowEnergy.setAdvertisingInterval(
  minInterval: number,
  maxInterval: number,
  callback?: function,
)

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

매개변수

  • minInterval

    숫자

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

  • maxInterval

    숫자

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

  • 콜백

    함수 선택사항

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

    () => void

반환 값

  • 프로미스<void>

    Chrome 91 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

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

startCharacteristicNotifications()

<ph type="x-smartling-placeholder"></ph> 프로미스 를 통해 개인정보처리방침을 정의할 수 있습니다.
chrome.bluetoothLowEnergy.startCharacteristicNotifications(
  characteristicId: string,
  properties?: NotificationProperties,
  callback?: function,
)

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

매개변수

  • characteristicId

    문자열

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

  • 속성

    NotificationProperties 선택사항

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

  • 콜백

    함수 선택사항

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

    () => void

반환 값

  • 프로미스<void>

    Chrome 91 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

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

stopCharacteristicNotifications()

<ph type="x-smartling-placeholder"></ph> 프로미스 를 통해 개인정보처리방침을 정의할 수 있습니다.
chrome.bluetoothLowEnergy.stopCharacteristicNotifications(
  characteristicId: string,
  callback?: function,
)

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

매개변수

  • characteristicId

    문자열

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

  • 콜백

    함수 선택사항

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

    () => void

반환 값

  • 프로미스<void>

    Chrome 91 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

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

unregisterAdvertisement()

<ph type="x-smartling-placeholder"></ph> 프로미스 Chrome 47 이상 
chrome.bluetoothLowEnergy.unregisterAdvertisement(
  advertisementId: number,
  callback?: function,
)

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

매개변수

  • advertisementId

    숫자

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

  • 콜백

    함수 선택사항

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

    () => void

반환 값

  • 프로미스<void>

    Chrome 91 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

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

unregisterService()

<ph type="x-smartling-placeholder"></ph> 프로미스 Chrome 52 이상 
chrome.bluetoothLowEnergy.unregisterService(
  serviceId: string,
  callback?: function,
)

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

매개변수

  • serviceId

    문자열

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

  • 콜백

    함수 선택사항

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

    () => void

반환 값

  • 프로미스<void>

    Chrome 91 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

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

writeCharacteristicValue()

<ph type="x-smartling-placeholder"></ph> 프로미스 를 통해 개인정보처리방침을 정의할 수 있습니다.
chrome.bluetoothLowEnergy.writeCharacteristicValue(
  characteristicId: string,
  value: ArrayBuffer,
  callback?: function,
)

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

매개변수

  • characteristicId

    문자열

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

  • 값

    배열 버퍼

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

  • 콜백

    함수 선택사항

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

    () => void

반환 값

  • 프로미스<void>

    Chrome 91 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

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

writeDescriptorValue()

<ph type="x-smartling-placeholder"></ph> 프로미스 를 통해 개인정보처리방침을 정의할 수 있습니다.
chrome.bluetoothLowEnergy.writeDescriptorValue(
  descriptorId: string,
  value: ArrayBuffer,
  callback?: function,
)

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

매개변수

  • descriptorId

    문자열

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

  • 값

    배열 버퍼

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

  • 콜백

    함수 선택사항

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

    () => void

반환 값

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

      문자열

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

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