Hello Android - Bluetooth 3

작성자: 박영기
작성일: 2012-11-21

이 문서는 Android 개발자 가이드: Bluetooth를 참조하여 작성하였습니다.

discoverability 활성화 시키기 (Enabling discoverability)

용어가 다소 혼동스러울 수 있어서 쉽게 풀어서 설명하겠다. 예를들어, 안드로이드폰과 블루투스 키보드가 있다고 치자. 안드로이드폰은 블루투스 키보드를 발견(discover)할 수 있다.그리고 블루투스 키보드는 안드로이드폰에게 자신을 노출시킬 수 있는 능력(discoverability)를 갖고있다. 이 능력(discoverability)은 On/Off 가능하다. On 상태일 때를 다른말로  discoverable 모드가 활성화 되어있는 상태라고도 한다. 우리말로 설명하면 약간 애매하므로 지금부터 discover와 discoverability, discoverable을 영어 그대로 사용하겠다.

discoverability를 활성화 시키기 위해서는 startActivityForResult(Intent, int) 함수에 ACTION_REQUEST_DISCOVERABLE 액션 인텐트를 사용한다. 이 메소드는 discoverable 모드를 활성화 하도록 시스템에 요청을 보낸다. 기본적으로 디바이스는 120초 동안 discoverable 될 수 있다. 이 시간은 EXTRA_DISCOVERABLE_DURATION 인텐트 엑스트라를 추가하는 것으로 변경할 수 있다. 이 값의 단위는 초이다. 범위는 1부터 3600까지고, 0이 의미하는 것은 항상 discoverable 상태에 있도록 한다는 의미이다. 0보다 작고 3600보다 큰 값은 자동으로 120초로 설정된다. 300초로 설정하는 예제는 다음과 같다:

Intent discoverableIntent = new
Intent(BluetoothAdapter.ACTION_REQUEST_DISCOVERABLE);
discoverableIntent.putExtra(BluetoothAdapter.EXTRA_DISCOVERABLE_DURATION, 300);
startActivity(discoverableIntent);

//
// ODROID-X에서 discoverable 모드가 동작하지 않는다. OTL
// 따라서 이 글은 문제가 해결되면 계속 작성할 것이다.

Hello Android - Bluetooth 2

작성자: 박영기
작성일: 2012-11-20
이 문서는 Android 개발자 가이드: Bluetooth를 참조하여 작성하였습니다.

연결된 디바이스 목록 보기

새 Bluetooth 디바이스를 검색하기 전에
이미 연결되어있는지 확인하는 것이 좋다.

위 코드의 동작을 확인하려면
Android Setting 메뉴에서
새 블루투스 디바이스를 연결해야한다.

필자는 블루투스 키보드를 사용하였는데 결과값으로 "i-rocks Bluetooth Keyboard"와 "DC:2C:26:00:4A:29"가 출력되었다. 각각 디바이스 이름과 MAC Address이다.

새 Bluetooth 디바이스 발견하기

// Create a BroadcastReceiver for ACTION_FOUND
private final BroadcastReceiver mReceiver = new BroadcastReceiver() {
    public void onReceive(Context context, Intent intent) {
        String action = intent.getAction();
        // When discovery finds a device
        if (BluetoothDevice.ACTION_FOUND.equals(action)) {
            // Get the BluetoothDevice object from the Intent
            BluetoothDevice device = intent.getParcelableExtra(BluetoothDevice.EXTRA_DEVICE);
            // Add the name and address to an array adapter to show in a ListView
            mArrayAdapter.add(device.getName() + "\n" + device.getAddress());
        }
    }
};
// Register the BroadcastReceiver
IntentFilter filter = new IntentFilter(BluetoothDevice.ACTION_FOUND);
registerReceiver(mReceiver, filter); // Don't forget to unregister during onDestroy

이 코드의 실행 결과는 흡사 UDP Multicast Group에 참여해서 자신의 존재를 알리기 위해 메시지를 일정시간동안 보내는 것과 유사하다.

BroadcastReceiver class의 객체의 추상메소드인 onReceive()를 구현한 후
android.content.Context class의 registerReceiver() 메소드에 인자로 전달하면
콜백을 받을 준비가 끝난다.

이후 BluetoothAdapter.startDiscover() 함수를 호출하면
약 12초 동안 onRecive() 콜백이 여러번 호출된다.

이건 흡사 Android 기기 > Setting 메뉴 > Bluetooth 에 나오는
Bluetooth 디바이스 목록 페이지와 유사하다.
단, Setting 메뉴에서는 시간 제한이 없다는 차이점이 있다.

주의: 새 Bluetooth 디바이스를 발견하는 일은 꽤 무거운 작업이고, 리소스를 많이 소비한다. 따라서 연결할 디바이스를 찾았다면 확실히 하기 위해서 cancelDiscovery() 를 호출해서 discovery 작업을 중지시켜야한다. 또한 이미 디바이스가 연결된 상태에서 discovery 작업을 할 경우 사용 가능한 대역폭이 아주 많이 감소하게 되므로 주의해야한다.

Hello Android - Bluetooth 1

작성자: 박영기
작성일: 2012-11-20

이 문서는 Android 개발자 가이드: Bluetooth를 참조하여 작성하였습니다.

Bluetooth 권한

블루투스를 사용하는 앱은 다음 두 권한이 필요하다.

manifast 파일을 열어 다음과 같이 권한을 추가한다.

이들 권한에 대한 자세한 사항은 이 링크를 참고한다.

BluetoothAdapter 객체 얻기

BluetoothAdapter는 전 안드로이드 기기를 통틀어 하나밖에 없다.
다시 말하면, 싱글톤 객체다.
따라서 new를 사용하지 않고 static 메소드로 객체를 얻는다.

BluetoothAdapter mBluetoothAdapter = BluetoothAdapter.getDefaultAdapter();
if (mBluetoothAdapter == null) {
    // Device does not support Bluetooth
}

Bluetooth 활성화 시키기

Bluetooth가 존재하지만 비활성화 상태일 때에는 이렇게 활성화시킨다.

단, REQUEST_ENABLE_BT는 지역변수이고 0보다 큰 값을 가진다.

if (!mBluetoothAdapter.isEnabled()) {
    Intent enableBtIntent = new Intent(BluetoothAdapter.ACTION_REQUEST_ENABLE);
    startActivityForResult(enableBtIntent, REQUEST_ENABLE_BT);
}

이 코드를 실행시키면 다음 그림을 볼 수 있다.





앞에서 호출한 startActivityForResult()는 비동기 함수이며 즉시 리턴한다.
수행결과는 잠시후 onActivityResult() 콜백으로 전달된다.

void android.app.Activity.startActivityForResult(Intent intent, int requestCode)
void android.app.Activity.onActivityResult(int requestCode, int resultCode, Intent data)

startActivityForResult()에서 두 번째 인자와 onActivityResult()의 첫 번째 인자가 같다는 것을 눈여겨 보길 바란다.