Androidでデフォルトの電話MMSユーザーエージェント（MmsUserAgent）を取得する方法

はじめに

この記事では、Androidアプリでデフォルトの電話MMSユーザーエージェント（MmsUserAgent）を取得する方法を、サンプルコードとともに段階的に解説します。なお、getMmsUserAgent()メソッドはAPIレベル28（Android 9 Pie）以降でのみ利用可能なため、@RequiresApiアノテーションを使用しています。

ステップ1：新規プロジェクトの作成

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

ステップ2：レイアウトファイルの編集

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

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="https://schemas.android.com/apk/res/android"
    xmlns:app="https://schemas.android.com/apk/res-auto"
    xmlns:tools="https://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:gravity="center"
    android:layout_height="match_parent"
    tools:context=".MainActivity"
    android:orientation="vertical">
    <TextView
        android:id="@+id/text"
        android:textSize="30sp"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content" />
</LinearLayout>

上記のコードでは、取得した電話のMmsUserAgentを画面中央に表示するためのTextViewを配置しています。

ステップ3：MainActivity.javaの編集

java/MainActivity.javaに以下のコードを追加します。

package com.example.myapplication;

import android.Manifest;
import android.content.Context;
import android.content.pm.PackageManager;
import android.os.Build;
import android.os.Bundle;
import android.support.annotation.NonNull;
import android.support.annotation.RequiresApi;
import android.support.v4.app.ActivityCompat;
import android.support.v7.app.AppCompatActivity;
import android.telephony.TelephonyManager;
import android.widget.TextView;

import static android.Manifest.permission.READ_PHONE_NUMBERS;
import static android.Manifest.permission.READ_PHONE_STATE;
import static android.Manifest.permission.READ_SMS;

public class MainActivity extends AppCompatActivity {
    private static final int PERMISSION_REQUEST_CODE = 100;
    TextView textView;
    TelephonyManager telephonyManager;

    @RequiresApi(api = Build.VERSION_CODES.P)
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        textView = findViewById(R.id.text);
        telephonyManager = (TelephonyManager) this.getSystemService(Context.TELEPHONY_SERVICE);
        if (ActivityCompat.checkSelfPermission(this, READ_SMS) != PackageManager.PERMISSION_GRANTED &&
            ActivityCompat.checkSelfPermission(this, READ_PHONE_NUMBERS) != PackageManager.PERMISSION_GRANTED &&
            ActivityCompat.checkSelfPermission(this, READ_PHONE_STATE) != PackageManager.PERMISSION_GRANTED) {
            ActivityCompat.requestPermissions(this, new String[]{READ_SMS, READ_PHONE_NUMBERS, READ_PHONE_STATE}, PERMISSION_REQUEST_CODE);
        } else {
            textView.setText(""+telephonyManager.getMmsUserAgent());
        }
    }

    @RequiresApi(api = Build.VERSION_CODES.P)
    @Override
    public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
        super.onRequestPermissionsResult(requestCode, permissions, grantResults);
        switch (requestCode) {
            case PERMISSION_REQUEST_CODE:
                if (ActivityCompat.checkSelfPermission(this, Manifest.permission.READ_SMS) !=
                    PackageManager.PERMISSION_GRANTED && ActivityCompat.checkSelfPermission(this,
                    Manifest.permission.READ_PHONE_NUMBERS) != PackageManager.PERMISSION_GRANTED &&
                    ActivityCompat.checkSelfPermission(this, Manifest.permission.READ_PHONE_STATE) !=
                    PackageManager.PERMISSION_GRANTED) {
                    return;
                } else {
                    textView.setText(""+telephonyManager.getMmsUserAgent());
                }
        }
    }
}

このコードでは、READ_SMS・READ_PHONE_NUMBERS・READ_PHONE_STATEの3つの危険なパーミッションが許可されているかをチェックしています。未許可の場合はユーザーに許可を求めるダイアログを表示し、許可された後にTelephonyManagerのgetMmsUserAgent()メソッドを呼び出して、その結果をTextViewに表示します。onRequestPermissionsResult()コールバックでも同様の処理を行うことで、権限リクエスト後の再描画にも対応しています。

ステップ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.myapplication">

    <uses-permission android:name="android.permission.READ_PHONE_NUMBERS" />
    <uses-permission android:name="android.permission.READ_PHONE_STATE" />
    <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>

マニフェストファイルには、READ_PHONE_NUMBERSとREAD_PHONE_STATEのパーミッション宣言を必ず記述してください。これを忘れると、実行時に権限チェックが正しく機能せず、アプリがクラッシュする可能性があります。

アプリの実行と確認

それでは、アプリケーションを実行してみましょう。ここでは、実際のAndroid端末がパソコンに接続されているものとします。Android Studioからアプリを実行するには、プロジェクト内のいずれかのアクティビティファイルを開き、ツールバーの実行アイコンをクリックします。表示される選択肢からお使いのモバイルデバイスを選択すると、端末の画面にデフォルトのMmsUserAgentの値が表示されます。

まとめ

本記事の手順では、TelephonyManagerを利用して端末のMMSユーザーエージェント情報を安全に取得できました。危険なパーミッションを扱う場合は、実行時権限リクエストの適切なハンドリングが重要です。また、対象デバイスがAPI 28未満の場合は、Build.VERSION.SDK_INTによるバージョンチェックを追加することをおすすめします。