React Native에서 Bluetooth 기능 구현하기

React Native에서 Bluetooth 기능을 활용하여 외부 디바이스와의 통신을 구현하는 방법을 알아보겠습니다. 라이브러리 설치부터 권한 설정, 데이터 송수신까지 단계별로 자세히 살펴보겠습니다.

 

React Native와 Bluetooth 개요

React Native와 Bluetooth 통신의 구현은 IoT와 같은 스마트 디바이스의 시대에서 중요한 역할을 하고 있습니다. Bluetooth는 로컬 환경에서 무선으로 데이터 통신을 가능하게 하는 기술로, 스마트폰과 웨어러블 디바이스, 센서 등 다양한 장치 간의 통신을 지원합니다. 이 글에서 React Native에서 Bluetooth 기능을 사용하여 외부 기기와 통신하는 방법을 알아보겠습니다.

Bluetooth 기술의 개요

Bluetooth는 크게 두 가지 방식으로 나눌 수 있습니다. 클래식 Bluetooth와 Bluetooth Low Energy (BLE) 입니다. 클래식 Bluetooth는 주로 오디오 기기나 대용량 데이터를 전송하는 데 사용되는 반면, BLE는 저전력으로 데이터를 교환하기 때문에 스마트워치나 건강 관리 기기 같은 소형 디바이스에 주로 사용됩니다.

React Native에서 Bluetooth 통신의 활용 사례

React Native에서 Bluetooth 통신은 스마트 디바이스와의 연동에 유용합니다. 예를 들어, 피트니스 밴드에서 실시간 데이터를 받아오거나, 스마트 온도계를 제어하는 등 다양한 방식으로 활용됩니다. 이를 위해 주로 사용하는 라이브러리가 react-native-ble-manager와 react-native-bluetooth-classic 등 입니다.

 

React Native 프로젝트에 Bluetooth 설정하기

필요한 라이브러리 설치하기

React Native에서 Bluetooth를 사용하려면 적절한 라이브러리를 설치해야 합니다. BLE 기능을 사용하기 위해선 react-native-ble-manager 라이브러리를 사용할 수 있습니다. 다음 명령어로 설치를 진행합니다.

npm install react-native-ble-manager

 

설치 후 네이티브 모듈을 링크하고, 필요한 경우 추가적인 설정을 해야 합니다.

Android와 iOS에서의 권한 설정

Bluetooth 기능을 사용하려면 Android와 iOS에서 각각 권한 설정이 필요합니다. Android에서는 AndroidManifest.xml 파일에 다음과 같은 권한을 추가해야 합니다.

<uses-permission android:name="android.permission.BLUETOOTH" />
<uses-permission android:name="android.permission.BLUETOOTH_ADMIN" />
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />

 

iOS에서는 Info.plist 파일에 아래 내용을 추가하여 Bluetooth 사용에 대한 권한을 요청해야 합니다.

<key>NSBluetoothAlwaysUsageDescription</key>
<string>Bluetooth 기능을 사용하여 주변 기기와 통신합니다.</string>
<key>NSLocationWhenInUseUsageDescription</key>
<string>Bluetooth 기기 검색을 위해 위치 정보를 사용합니다.</string>

 

Bluetooth 디바이스 검색 및 연결

주변 디바이스 검색하기

설정이 완료되면 이제 주변 Bluetooth 기기를 검색할 수 있습니다. react-native-ble-manager 라이브러리에서 제공하는 메서드를 사용해 검색을 시작할 수 있습니다. 다음은 기기 검색을 위한 간단한 예제입니다.

import BleManager from 'react-native-ble-manager';

BleManager.start({ showAlert: false }).then(() => {
	console.log('Bluetooth 모듈이 초기화되었습니다.');
	BleManager.scan([], 5, true).then(() => {
		console.log('기기 검색 시작');
	});
});

 

위 코드에서 BleManager.scan() 메서드를 사용하여 5초 동안 주변 기기를 검색합니다.

디바이스와의 연결 및 데이터 전송

디바이스 검색 후, 원하는 기기와 연결합니다. 연결은 기기의 UUID를 사용하여 이루어집니다.

BleManager.connect('device_uuid').then(() => {
	console.log('기기 연결 성공');
}).catch((error) => {
	console.log('기기 연결 실패', error);
});

 

기기와 연결이 완료되면 데이터를 주고받을 수 있는 상태가 됩니다.

 

데이터 송수신 구현하기

데이터 송신 코드 예시

데이터를 송신하려면 연결된 기기의 특정 서비스와 특성(characteristic)을 사용해야 합니다. 예를 들어, 다음과 같은 방식으로 데이터를 송신할 수 있습니다.

const data = 'Hello Device';
BleManager.write('device_uuid', 'service_uuid', 'characteristic_uuid', data).then(() => {
	console.log('데이터 전송 완료');
}).catch((error) => {
	console.log('데이터 전송 실패', error);
});

 

• device_uuid: Bluetooth 기기 검색 과정에서 발견된 기기의 UUID입니다. 이 UUID는 기기 검색 시 반환되며, 기기를 특정하기 위해 사용됩니다.
• service_uuid: 기기가 제공하는 서비스의 고유 식별자입니다. BLE 기기에는 여러 서비스가 포함될 수 있으며, 각 서비스는 특정 기능(예: 온도 측정, 심박수 모니터링 등)을 제공합니다. BleManager의 discoverServices() 같은 메서드를 사용해 연결된 기기의 모든 서비스 UUID를 가져올 수 있습니다.
• characteristic_uuid: 각 서비스에는 여러 특성(characteristic)이 포함되며, 이는 데이터를 주고받는 단위입니다. BleManager의 read()나 write() 메서드를 통해 사용되는 특성 UUID는, discoverCharacteristics() 메서드를 통해 서비스에 대한 모든 특성을 조회하여 얻을 수 있습니다.

수신 데이터 처리 방법

기기에서 데이터를 수신하려면 BleManager의 이벤트 리스너를 등록합니다. 이를 통해 기기에서 전송된 데이터를 처리할 수 있습니다.

BleManager.startNotification('device_uuid', 'service_uuid', 'characteristic_uuid').then(() => {
	console.log('데이터 수신 시작');
});

BleManager.addListener('BleManagerDidUpdateValueForCharacteristic', ({ value }) => {
	console.log('수신된 데이터:', value);
});

 

Bluetooth 통신 구현 시 발생할 수 있는 문제와 해결 방안

연결 실패 문제 해결

Bluetooth 연결 실패의 주요 원인은 기기 간의 신호 강도, 권한 미설정, 또는 기기의 호환성 문제일 수 있습니다. 이러한 문제를 해결하기 위해서는 권한을 다시 확인하거나, 기기의 거리를 좁혀서 신호 강도를 높이는 방법이 있습니다.

데이터 전송 지연 이슈 해결

BLE에서는 저전력 특성상 데이터 전송이 지연될 수 있습니다. 이 경우 데이터 패킷의 크기를 줄이거나, 필요하지 않은 상태 업데이트를 최소화하여 성능을 최적화할 수 있습니다.

 

마무리하며

React Native에서 Bluetooth 기능을 활용하여 외부 디바이스와 통신하는 방법은 IoT 디바이스와의 연동을 가능하게 하여, 사용자 경험을 크게 향상시킬 수 있는 중요한 기술입니다. 이번 글에서는 Bluetooth 통신을 구현하기 위한 라이브러리 설치, 권한 설정, 기기 검색 및 연결, 데이터 송수신 과정까지 다루었습니다. React Native와 Bluetooth 통신을 통해 더욱 풍부한 기능을 가진 앱을 개발하는데 도움이 되길 바랍니다.