앱 개발

BLE 앱 개발 구조, GATT부터 안드로이드 12 권한과 iOS 백그라운드 재연결까지

BLE 앱 개발 구조, GATT부터 안드로이드 12 권한과 iOS 백그라운드 재연결까지

BLE 앱 개발 구조, GATT부터 안드로이드 12 권한과 iOS 백그라운드 재연결까지

BLE 기기의 데이터는 서비스, 특성, 서술자로 이뤄진 GATT 구조로 오가고, 알림을 받으려면 CCCD(0x2902)에 값을 써야 합니다. 안드로이드 12 이후 권한, API 33과 37에서 바뀐 GATT 함수, iOS 백그라운드 제약과 재연결 순서를 다룹니다.

BLE 기기의 데이터는 서비스, 특성, 서술자로 이뤄진 GATT 구조로 오가고, 알림을 받으려면 CCCD(0x2902)에 값을 써야 합니다. 안드로이드 12 이후 권한, API 33과 37에서 바뀐 GATT 함수, iOS 백그라운드 제약과 재연결 순서를 다룹니다.

8분 소요

8분 소요

BLE 기기와 앱은 GATT라는 구조로 데이터를 주고받습니다. 기기 안에 서비스가 있고, 서비스 안에 실제 값이 담긴 특성(characteristic)이 있으며, 앱은 특성을 읽거나 쓰거나 값이 바뀔 때마다 알림을 받습니다. 앱 개발에서 손이 많이 가는 부분은 이 구조 자체보다 그 바깥입니다. 안드로이드는 버전마다 권한이 다르고, iOS는 앱이 백그라운드로 가면 스캔과 연결 방식이 달라지며, 끊긴 연결을 다시 잇는 순서도 두 OS가 다릅니다.

BLE 앱 개발 구조, GATT부터 안드로이드 12 권한과 iOS 백그라운드 재연결까지 대표 이미지

연결이 자주 끊기는 문제를 증상별로 다룬 글은 BLE 기기 연동 앱 연결이 끊길 때 볼 것에 따로 있습니다. 여기서는 개발을 시작할 때 구조를 어떻게 잡는지를 중심으로 봅니다.

GATT는 서비스, 특성, 서술자로 이뤄집니다

GATT(Generic Attribute Profile)는 BLE 기기가 데이터를 어떤 묶음으로 내보일지 정한 규칙입니다. 맨 위가 서비스, 그 안이 특성, 특성에 붙은 설정값이 서술자(descriptor)입니다. 기기가 서버 역할을 하고 앱은 클라이언트가 됩니다.

블루투스 표준 단체(Bluetooth SIG)가 정해 둔 표준 서비스는 16비트 짧은 번호를 씁니다. Bluetooth SIG 할당 번호 목록을 보면 심박은 0x180D, 혈압은 0x1810, 혈당은 0x1808, 체중계는 0x181D, 배터리는 0x180F, 기기 정보는 0x180A입니다. 표준 서비스를 따르는 기기라면 문서만 보고도 값을 해석할 수 있습니다. 제조사가 직접 정한 서비스는 128비트 UUID를 쓰고, 이때는 바이트 구성을 적은 프로토콜 문서가 없으면 앱이 값을 읽을 방법이 없습니다.

구분 예 앱에서 하는 일
서비스 심박 0x180D 연결 뒤 서비스 탐색으로 찾기
특성 심박 측정값 0x2A37 읽기, 쓰기, 알림 받기
서술자 CCCD 0x2902 알림을 켜고 끄기

기기 쪽에서 값이 바뀔 때마다 받으려면 특성에 알림(notify)을 켜야 합니다. 이 스위치가 CCCD(Client Characteristic Configuration Descriptor)라는 서술자이고, 번호는 0x2902입니다. 안드로이드는 BLE 데이터 전송 문서의 예제처럼 setCharacteristicNotification()을 부른 뒤 앱이 이 서술자에 직접 값을 써야 해서, 이 단계를 빠뜨려 "연결은 되는데 값이 안 온다"는 문제가 생기곤 합니다. iOS는 setNotifyValue를 부르면 Core Bluetooth가 이 과정을 처리합니다.

안드로이드는 API 레벨마다 쓰는 함수가 바뀌었습니다

안드로이드 13(API 33)에서 writeCharacteristic(characteristic)과 writeDescriptor(descriptor)가 지원 중단(deprecated)됐습니다. BluetoothGatt 공식 문서는 이유로 메모리 안전성을 듭니다. 예전 함수는 특성 객체 안에 값을 넣어 두고 보내는데, 그 값이 함수 밖에서 바뀔 수 있다는 것입니다. 새 함수는 보낼 바이트 배열을 인자로 직접 받습니다. 오래된 예제 코드를 그대로 가져오면 이 차이에서 간헐적인 오류가 납니다.

2026년 문서에는 변화가 하나 더 있습니다. GATT 서버 연결 문서에 따르면 connectGatt(Context, boolean, BluetoothGattCallback)가 API 37에서 지원 중단됐고, BluetoothGattConnectionSettings를 받는 새 connectGatt를 쓰라고 안내합니다. 지금 당장 동작이 막히는 것은 아니지만, 타깃 API를 올릴 때 연결 코드를 함께 정리할 계획을 세워 두는 편이 좋습니다.

안드로이드 권한은 12를 기준으로 갈립니다

안드로이드 버전 스캔에 필요한 것 연결과 통신
11(API 30) 이하 ACCESS_FINE_LOCATION, 위치 서비스 켜짐 BLUETOOTH, BLUETOOTH_ADMIN
12(API 31) 이상 BLUETOOTH_SCAN BLUETOOTH_CONNECT
14(API 34) 이상 백그라운드 위와 같음 포그라운드 서비스 connectedDevice 유형 선언

안드로이드 12부터는 사용자에게 "근처 기기" 권한 하나로 보이지만, 앱은 스캔과 연결 권한을 따로 선언합니다. 스캔 결과로 위치를 추정하지 않는다면 neverForLocation 표시를 붙여 위치 권한 없이 쓸 수 있습니다. 다만 안드로이드 블루투스 권한 문서에 이 표시를 쓰면 일부 BLE 비콘이 스캔 결과에서 걸러진다고 적혀 있어서, 비콘을 다루는 앱에는 맞지 않습니다.

실무에서는 앱이 지원하는 가장 낮은 버전부터 이 표의 각 줄을 실제 휴대폰으로 확인합니다. 안드로이드 11 이하 휴대폰에서 위치 서비스가 꺼져 있으면 권한을 다 줘도 기기가 하나도 잡히지 않기 때문입니다.

iOS는 MFi 없이 Core Bluetooth로 연결합니다

BLE만 쓰는 기기는 Apple의 MFi 인증 대상이 아닙니다. MFi 프로그램 FAQ는 BLE만 쓰는 액세서리를 프로그램 대상에서 빼고 있고, 예외는 BLE를 쓰는 HomeKit 액세서리와 MFi 보청기입니다. 그래서 일반 헬스케어 기기나 생활 기기는 Core Bluetooth 프레임워크만으로 앱을 만들 수 있습니다.

iOS 앱은 Core Bluetooth가 붙여 주는 식별자(identifier)로 기기를 구분합니다. 이 값은 앱이 휴대폰 안에서 기기를 다시 찾을 때 쓰는 것이라, 서버에 "이 사용자의 기기"를 저장하는 고유 번호로 쓰기에는 맞지 않습니다. 기기 고유 번호가 필요하면 펌웨어가 특성으로 일련번호를 내주도록 프로토콜 문서에 넣어 둡니다.

iOS 백그라운드에서는 동작이 달라집니다

bluetooth-central 백그라운드 모드를 켜면 앱이 백그라운드에서도 BLE 이벤트를 받을 수 있습니다. 대신 Core Bluetooth 백그라운드 처리 문서에 적힌 제약이 붙습니다.

  • 스캔 옵션 CBCentralManagerScanOptionAllowDuplicatesKey가 무시되고, 같은 기기를 여러 번 발견해도 한 번으로 합쳐집니다.
  • 스캔하는 앱이 모두 백그라운드에 있으면 스캔 간격이 길어져 기기를 찾는 데 시간이 더 걸립니다.
  • 휴대폰이 반대로 기기 역할(광고)을 할 때는 로컬 이름이 광고되지 않고, 서비스 UUID는 별도 영역에 들어가 그 UUID를 명시해 스캔하는 iOS 기기만 찾을 수 있습니다.

메모리 부족으로 시스템이 앱을 종료한 경우에 대비하는 기능이 상태 보존과 복원입니다. CBCentralManager를 만들 때 CBCentralManagerOptionRestoreIdentifierKey로 복원 식별자를 넣어 두면, 시스템이 연결 중이던 기기와 스캔 조건을 기억했다가 관련 이벤트가 생길 때 앱을 다시 띄워 줍니다. 문서가 설명하는 경우는 시스템이 메모리를 확보하려고 앱을 종료할 때입니다. 그래서 복원에만 기대지 않고, 사용자가 앱을 다시 열 때 그사이 기기에 쌓인 기록을 받아 오는 동기화 흐름도 함께 만들어 둡니다.

끊긴 연결은 정해진 순서로 다시 잇습니다

Core Bluetooth 모범 사례 문서는 iOS에서 기기에 다시 연결할 때 세 가지 방법을 순서대로 시도하도록 안내합니다. 먼저 retrievePeripheralsWithIdentifiers로 예전에 찾았던 기기를 식별자로 불러오고, 없으면 retrieveConnectedPeripheralsWithServices로 이미 시스템에 연결된 기기 중 필요한 서비스를 가진 것을 찾고, 그래도 없으면 다시 스캔합니다. 문서는 시스템에 이미 연결된 기기라도 앱에서 다시 연결해야 통신할 수 있다고 적고 있습니다.

iOS 재연결 순서
식별자로 불러오기retrievePeripheralsWithIdentifiers로 예전에 찾은 기기
연결된 기기에서 찾기retrieveConnectedPeripheralsWithServices로 서비스 지정
다시 스캔앞의 두 방법으로 못 찾았을 때

안드로이드는 connectGatt의 autoConnect 값으로 방식을 고릅니다. 공식 문서 설명대로 true면 기기가 범위에 들어오는 대로 자동으로 연결하고, false면 지금 바로 연결을 시도합니다. 사용자가 버튼을 눌러 연결하는 화면에서는 false로 빠르게 붙이고, 연결이 끊긴 뒤 다시 기다리는 동안은 true로 걸어 두는 식으로 나눠 쓰는 경우가 많습니다. 어느 쪽이든 연결이 더 필요 없을 때는 close()를 불러 닫습니다. 공식 문서도 휴대폰 배터리 소모를 막으려면 이 단계가 꼭 필요하다고 적고 있습니다.

기기 연동 앱을 처음 기획하신다면 BLE와 IoT 기기 연동 앱 개발 페이지에서 상담 전에 준비할 자료를 볼 수 있습니다. 모바일파트너스는 알코파인드 음주측정기 연동 앱처럼 기기와 앱이 한 제품으로 움직이는 서비스를 개발해 왔습니다.

자주 묻는 질문

표준 서비스가 아닌 기기도 앱과 연결할 수 있나요?

연결할 수 있습니다. 다만 제조사가 정한 128비트 UUID 서비스는 바이트 구성과 명령 형식을 적은 프로토콜 문서가 있어야 앱이 값을 해석할 수 있습니다. 문서가 없다면 제조사에 요청하는 것이 먼저입니다.

안드로이드 12 이상만 지원하면 위치 권한은 필요 없나요?

스캔 결과로 위치를 추정하지 않고 BLUETOOTH_SCAN에 neverForLocation을 붙였다면 위치 권한 없이 쓸 수 있습니다. 비콘을 다루거나 스캔 결과로 위치를 쓰는 앱이라면 여전히 위치 권한이 필요합니다.

iOS에서 앱이 종료돼도 기기 데이터를 계속 받을 수 있나요?

시스템이 메모리를 확보하려고 앱을 종료한 경우라면, 상태 보존과 복원을 켜 두었을 때 관련 이벤트가 생기면 시스템이 앱을 다시 띄워 줍니다. 그 밖의 경우까지 대비해 앱을 다시 열 때 기기에 쌓인 기록을 받아 오는 동기화도 함께 설계합니다.

iOS 앱용 BLE 기기도 MFi 인증을 받아야 하나요?

BLE만 쓰는 기기라면 MFi 대상이 아닙니다. Apple MFi FAQ 기준으로 예외는 BLE를 쓰는 HomeKit 액세서리와 MFi 보청기이고, 클래식 블루투스로 임의 데이터를 주고받는 기기는 별도로 확인해야 합니다.

앱 개발이 고민되시나요?
앱 개발이 고민되시나요?

기획부터 출시까지, 모바일파트너스가 함께합니다

다른 아티클 살펴보기

다른 아티클 살펴보기

다른 아티클 살펴보기