コンパニオン デバイスのペア設定

Android 8.0（API レベル 26）以降を搭載しているデバイスでは、Bluetooth、BLE、Wi-Fi 経由でコンパニオン デバイスとペア設定するときの、ペア設定リクエスト ダイアログをカスタマイズできます。

アプリでは、ユーザーにコンパニオン デバイスの候補リストを表示するか、コンパニオン デバイスの候補を 1 つだけ表示するかを指定できます。また、タイプ（Bluetooth、BLE、Wi-Fi）やデバイス名などで、ペア設定リクエスト ダイアログに表示される項目をフィルタすることもできます。

次のコード スニペットは、ハンドヘルド デバイスを「My device」という単一の Bluetooth 接続コンパニオン デバイスとペア設定するかどうかを確認するダイアログを表示する方法を示しています。

    class MyDeviceSelectionActivity : Activity() {

        private val deviceManager: CompanionDeviceManager by lazy(LazyThreadSafetyMode.NONE) {
            getSystemService(CompanionDeviceManager::class.java)
        }

        override fun onCreate(savedInstanceState: Bundle?) {
            super.onCreate(savedInstanceState)
            // ...

            // To skip filtering based on name and supported feature flags (UUIDs),
            // don't include calls to setNamePattern() and addServiceUuid(),
            // respectively. This example uses Bluetooth.
            val deviceFilter: BluetoothDeviceFilter = BluetoothDeviceFilter.Builder()
                    .setNamePattern(Pattern.compile("My device"))
                    .addServiceUuid(ParcelUuid(UUID(0x123abcL, -1L)), null)
                    .build()

            // The argument provided in setSingleDevice() determines whether a single
            // device name or a list of device names is presented to the user as
            // pairing options.
            val pairingRequest: AssociationRequest = AssociationRequest.Builder()
                    .addDeviceFilter(deviceFilter)
                    .setSingleDevice(true)
                    .build()

            // When the app tries to pair with the Bluetooth device, show the
            // appropriate pairing request dialog to the user.
            deviceManager.associate(pairingRequest,
                    object : CompanionDeviceManager.Callback() {

                        override fun onDeviceFound(chooserLauncher: IntentSender) {
                            startIntentSenderForResult(chooserLauncher,
                                    SELECT_DEVICE_REQUEST_CODE, null, 0, 0, 0)
                        }

                        override fun onFailure(error: CharSequence?) {
                            // Handle failure
                        }
                    }, null)
        }

        override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent) {
            when (requestCode) {
                SELECT_DEVICE_REQUEST_CODE -> when(resultCode) {
                    Activity.RESULT_OK -> {
                        // User has chosen to pair with the Bluetooth device.
                        val deviceToPair: BluetoothDevice =
                                data.getParcelableExtra(CompanionDeviceManager.EXTRA_DEVICE)
                        deviceToPair.createBond()
                        // ... Continue interacting with the paired device.
                    }
                }
            }
        }
    }
    

    public class MyDeviceSelectionActivity extends Activity {
        private CompanionDeviceManager deviceManager;
        private AssociationRequest pairingRequest;
        private BluetoothDeviceFilter deviceFilter;

        private static final int SELECT_DEVICE_REQUEST_CODE = 42;

        @override
        public void onCreate() {
            // ...
            deviceManager = getSystemService(CompanionDeviceManager.class);

            // To skip filtering based on name and supported feature flags (UUIDs),
            // don't include calls to setNamePattern() and addServiceUuid(),
            // respectively. This example uses Bluetooth.
            deviceFilter = new BluetoothDeviceFilter.Builder()
                    .setNamePattern(Pattern.compile("My device"), null)
                    .addServiceUuid(new ParcelUuid(new UUID(0x123abcL, -1L)))
                    .build();

            // The argument provided in setSingleDevice() determines whether a single
            // device name or a list of device names is presented to the user as
            // pairing options.
            pairingRequest = new AssociationRequest.Builder()
                    .addDeviceFilter(deviceFilter)
                    .setSingleDevice(true)
                    .build();

            // When the app tries to pair with the Bluetooth device, show the
            // appropriate pairing request dialog to the user.
            deviceManager.associate(pairingRequest,
                    new CompanionDeviceManager.Callback() {
                        @Override
                        public void onDeviceFound(IntentSender chooserLauncher) {
                            startIntentSenderForResult(chooserLauncher,
                                    SELECT_DEVICE_REQUEST_CODE, null, 0, 0, 0);
                        }
                    },
                    null);
        }

        @Override
        public void onActivityResult(int requestCode, int resultCode, Intent data) {
            if (requestCode == SELECT_DEVICE_REQUEST_CODE &&
                    resultCode == Activity.RESULT_OK) {
                // User has chosen to pair with the Bluetooth device.
                BluetoothDevice deviceToPair =
                        data.getParcelableExtra(CompanionDeviceManager.EXTRA_DEVICE);
                deviceToPair.createBond();

                // ... Continue interacting with the paired device.
            }
        }
    }