KotlinでAndroidデバイスにヘッドセットが接続されているか確認する方法

はじめに

この記事では、Kotlinを使用して、Androidデバイスにヘッドセット（イヤホン・マイク）が接続されているかどうかを検出する方法を解説します。ヘッドセットの接続・切断はシステムからブロードキャストされる ACTION_HEADSET_PLUG インテントを受け取ることで判定できます。

手順1：新規プロジェクトの作成

Android Studioを起動し、メニューから「File」→「New Project」を選択します。必要な項目を入力して、新しいプロジェクトを作成してください。

手順2：レイアウトファイルの作成

res/layout/activity_main.xml に以下のコードを追加します。

<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout xmlns:android="https://schemas.android.com/apk/res/android"
    xmlns:tools="https://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    tools:context=".MainActivity">
    <TextView
        android:id="@+id/text"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_centerHorizontal="true"
        android:layout_marginTop="70dp"
        android:background="#008080"
        android:padding="5dp"
        android:text="TutorialsPoint"
        android:textColor="#fff"
        android:textSize="24sp"
        android:textStyle="bold" />
    <TextView
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_centerInParent="true"
        android:text="Headphones connection status"
        android:textColor="@android:color/holo_purple"
        android:textSize="16sp"
        android:textStyle="bold" />
</RelativeLayout>

手順3：MainActivity.kt の実装

src/MainActivity.kt に以下のコードを追加します。BroadcastReceiver を登録し、ヘッドセットの状態変化を受け取ります。「state」エクストラの値が 0 の場合は未接続、1 の場合は接続済みを意味します。

import android.content.BroadcastReceiver
import android.content.Context
import android.content.Intent
import android.content.IntentFilter
import android.os.Bundle
import android.widget.Toast
import androidx.appcompat.app.AppCompatActivity
class MainActivity : AppCompatActivity() {
    var broadcastReceiver: BroadcastReceiver? = null
    var microphonePluggedIn = false
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)
        title = "KotlinApp"
        broadcastReceiver = object : BroadcastReceiver() {
            override fun onReceive(context: Context?, intent: Intent) {
                val action = intent.action
                val int: Int
                if (Intent.ACTION_HEADSET_PLUG == action) {
                    int = intent.getIntExtra("state", -1)
                    if (int == 0) {
                        microphonePluggedIn = false
                        Toast.makeText(applicationContext, "Headphones not plugged in", Toast.LENGTH_LONG).show()
                    }
                    if (int == 1) {
                        microphonePluggedIn = true
                        Toast.makeText(applicationContext, "Headphones plugged in", Toast.LENGTH_LONG).show()
                    }
                }
            }
        }
        val receiverFilter = IntentFilter(Intent.ACTION_HEADSET_PLUG)
        registerReceiver(broadcastReceiver, receiverFilter)
    }
}

手順4：AndroidManifest.xml の設定

androidManifest.xml に以下のコードを記述します。

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="https://schemas.android.com/apk/res/android"
    package="com.example.q11">
    <application
        android:allowBackup="true"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:roundIcon="@mipmap/ic_launcher_round"
        android:supportsRtl="true"
        android:theme="@style/AppTheme">
        <activity android:name=".MainActivity">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />
                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>
    </application>
</manifest>

アプリの実行

それでは、アプリケーションを実行してみましょう。実際のAndroid端末をパソコンに接続していることを前提としています。Android Studioでプロジェクト内のアクティビティファイルを開き、ツールバーの「Run」アイコンをクリックしてください。表示された候補から自分のモバイルデバイスを選択すると、端末上にアプリの画面が表示されます。

ヘッドセットを端末に差し込むと「Headphones plugged in」、抜くと「Headphones not plugged in」というトーストメッセージが表示され、接続状態をリアルタイムに確認できます。

注意点

なお、Android 13（APIレベル33）以降では、registerReceiver を呼び出す際に Context.RECEIVER_NOT_EXPORTED などのフラグを指定する必要があります。また、ACTION_HEADSET_PLUG は有線ヘッドセット向けのブロードキャストであり、Bluetoothイヤホンの接続状態を取得する場合は BluetoothProfile や AudioManager を利用する必要がある点にも留意してください。