설명
chrome.bluetooth
API를 사용하여 블루투스 기기에 연결합니다. 모든 함수는 chrome.runtime.lastError를 통해 실패를 보고합니다.
매니페스트
유형
AdapterState
속성
-
주소
문자열
어댑터의 주소이며 형식은 'XX:XX:XX:XX:XX:XX'입니다.
-
사용 가능
boolean
어댑터의 사용 가능 여부를 나타냅니다 (사용 설정됨).
-
새로운 발견
boolean
어댑터가 현재 검색 중인지 여부를 나타냅니다.
-
이름
문자열
사람이 읽을 수 있는 어댑터 이름입니다.
-
제공
boolean
어댑터에 전원이 공급되는지 여부를 나타냅니다.
BluetoothFilter
속성
-
filterType
FilterType 선택사항
기기 목록에 적용할 필터 유형입니다. 기본값은 all입니다.
-
제한
number 선택사항
반환할 블루투스 기기의 최대 개수입니다. 지정되지 않은 경우 기본값은 0 (제한 없음)입니다.
Device
속성
-
주소
문자열
기기의 주소로, 'XX:XX:XX:XX:XX:XX' 형식입니다.
-
batteryPercentage
number 선택사항
Chrome 77 이상기기의 배터리 잔량입니다.
-
연결 가능
부울 선택사항
Chrome 48 이상기기 연결 가능 여부를 나타냅니다.
-
연결됨
부울 선택사항
기기가 현재 시스템에 연결되어 있는지 여부를 나타냅니다.
-
연결편
부울 선택사항
Chrome 48 이상기기가 현재 시스템에 연결되어 있는지 여부를 나타냅니다.
-
deviceClass
number 선택사항
기기의 클래스로, http://www.bluetooth.org/en-us/specification/assigned-numbers/baseband로 정의된 비트 필드입니다.
-
deviceId
number 선택사항
-
inquiryRssi
number 선택사항
Chrome 44 이상수신된 신호 강도(dBm)입니다. 이 필드는 검색 중에만 사용할 수 있으며 유효합니다. 검색 이외의 값은 지정되지 않았습니다.
-
inquiryTxPower
number 선택사항
Chrome 44 이상전송된 전력 수준입니다. 이 입력란은 AD에 이 입력란이 포함된 저전력 기기에만 사용할 수 있습니다. 탐색 중에만 사용할 수 있으며 유효합니다.
-
이름
문자열 선택사항
사람이 읽을 수 있는 기기 이름입니다.
-
페어링됨
부울 선택사항
기기가 시스템과 페어링되어 있는지 여부를 나타냅니다.
-
productId
number 선택사항
-
전송
전송 선택사항
Chrome 76 이상블루투스 기기의 전송 유형입니다.
-
유형
DeviceType 선택사항
Chrome에서 인식되는 경우 기기 유형입니다.
deviceClass
필드에서 가져온 것으로, 가능한 기기 유형의 소수만 나타냅니다. 확실하지 않은 경우에는deviceClass
필드를 직접 사용해야 합니다. -
UID
string[] 선택사항
기기에서 공지하는 프로토콜, 프로필 및 서비스의 UUID입니다. 기존 블루투스 기기의 경우 이 목록은 EIR 데이터 및 SDP 테이블에서 가져온 것입니다. 저전력 기기의 경우 이 목록은 AD 및 GATT 기본 서비스에서 가져온 것입니다. 듀얼 모드 기기의 경우 둘 모두에서 얻을 수 있습니다.
-
vendorId
number 선택사항
-
vendorIdSource
VendorIdSource 선택사항
기기의 기기 ID 레코드입니다(가능한 경우).
DeviceType
Chrome에서 인식하는 일반적인 기기 유형입니다.
enum
"carAudio"
"keyboardMouseCombo"
FilterType
블루투스 기기 필터링을 위한 유형입니다.
enum
Transport
블루투스 기기의 전송 유형입니다.
enum
"le"
VendorIdSource
공급업체 ID에 대한 할당 권한
enum
"usb"
메서드
getAdapterState()
chrome.bluetooth.getAdapterState(
callback?: function,
)
블루투스 어댑터에 관한 정보를 확인합니다.
매개변수
-
콜백
함수 선택사항
callback
매개변수는 다음과 같습니다.(adapterInfo: AdapterState) => void
-
adapterInfo
어댑터 정보를 포함하는 객체입니다.
-
반환 값
-
Promise<AdapterState>
Chrome 91 이상프로미스는 Manifest V3 이상에서만 지원되며 다른 플랫폼에서는 콜백을 사용해야 합니다.
getDevice()
chrome.bluetooth.getDevice(
deviceAddress: string,
callback?: function,
)
시스템에 알려진 블루투스 기기에 대한 정보를 가져옵니다.
매개변수
-
deviceAddress
문자열
가져올 기기의 주소입니다.
-
콜백
함수 선택사항
callback
매개변수는 다음과 같습니다.(deviceInfo: Device) => void
-
deviceInfo
기기 정보를 포함하는 객체입니다.
-
반환 값
-
프로미스<기기>
Chrome 91 이상프로미스는 Manifest V3 이상에서만 지원되며 다른 플랫폼에서는 콜백을 사용해야 합니다.
getDevices()
chrome.bluetooth.getDevices(
filter?: BluetoothFilter,
callback?: function,
)
페어링되었거나 최근에 발견된 기기를 포함하여 시스템에 알려진 블루투스 기기 목록을 가져옵니다.
매개변수
-
filter
BluetoothFilter 선택사항
Chrome 67 이상반환된 블루투스 기기 목록을 필터링하기 위한 몇 가지 기준. 필터가 설정되지 않거나
{}
로 설정되면 반환된 기기 목록에 모든 블루투스 기기가 포함됩니다. 현재 이 기능은 ChromeOS에서만 지원되며 다른 플랫폼의 경우 전체 목록이 반환됩니다. -
콜백
함수 선택사항
callback
매개변수는 다음과 같습니다.(deviceInfos: Device[]) => void
-
deviceInfos
기기[]
기기 정보를 포함하는 객체의 배열입니다.
-
반환 값
-
프로미스<기기[]>
Chrome 91 이상프로미스는 Manifest V3 이상에서만 지원되며 다른 플랫폼에서는 콜백을 사용해야 합니다.
startDiscovery()
chrome.bluetooth.startDiscovery(
callback?: function,
)
검색을 시작하세요. 새로 검색된 기기는 onDeviceAdded 이벤트를 통해 반환됩니다. 어댑터에 이미 알려진 이전에 발견된 기기는 getDevices를 사용하여 가져와야 하며 관련 정보가 변경되는 경우에만 onDeviceChanged
이벤트를 사용하여 업데이트됩니다.
이 애플리케이션에서 이미 startDiscovery를 호출한 경우 검색을 시작할 수 없습니다. 검색은 리소스를 많이 사용할 수 있습니다. 즉, stopDiscovery를 최대한 빨리 호출해야 합니다.
매개변수
-
콜백
함수 선택사항
callback
매개변수는 다음과 같습니다.() => void
반환 값
-
Promise<void>
Chrome 91 이상프로미스는 Manifest V3 이상에서만 지원되며 다른 플랫폼에서는 콜백을 사용해야 합니다.
stopDiscovery()
chrome.bluetooth.stopDiscovery(
callback?: function,
)
검색 중지
매개변수
-
콜백
함수 선택사항
callback
매개변수는 다음과 같습니다.() => void
반환 값
-
Promise<void>
Chrome 91 이상프로미스는 Manifest V3 이상에서만 지원되며 다른 플랫폼에서는 콜백을 사용해야 합니다.
이벤트
onAdapterStateChanged
chrome.bluetooth.onAdapterStateChanged.addListener(
callback: function,
)
블루투스 어댑터의 상태가 변경되면 시작됩니다.
매개변수
-
콜백
기능
callback
매개변수는 다음과 같습니다.(state: AdapterState) => void
-
state
-
onDeviceAdded
chrome.bluetooth.onDeviceAdded.addListener(
callback: function,
)
새 블루투스 기기에 대한 정보를 사용할 수 있을 때 시작됩니다.
onDeviceChanged
chrome.bluetooth.onDeviceChanged.addListener(
callback: function,
)
알려진 블루투스 기기에 대한 정보가 변경되면 시작됩니다.
onDeviceRemoved
chrome.bluetooth.onDeviceRemoved.addListener(
callback: function,
)
이전에 발견된 블루투스 기기가 다시 사용할 수 없을 정도로 오랫동안 범위를 벗어났거나 페어링된 기기가 제거되면 실행됩니다.