이 튜토리얼에서는 안드로이드에서 기본 전화의 MmsUserAgent(MMS 사용자 에이전트)를 가져오는 방법을 소개합니다. MmsUserAgent는 기기가 MMS(멀티미디어 메시지) 서버와 통신할 때 자신을 식별하기 위해 전송하는 문자열로, 통신사와 기기 모델에 따라 값이 달라집니다. 이 값은 안드로이드 9.0(API 28)부터 TelephonyManager 클래스의 getMmsUserAgent() 메서드를 통해 조회할 수 있습니다.
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/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());
}
}
}
}
위 코드의 동작 흐름은 다음과 같습니다. 먼저 시스템 서비스에서 TelephonyManager 인스턴스를 얻습니다. 이후 READ_SMS, READ_PHONE_NUMBERS, READ_PHONE_STATE 권한이 부여되었는지 확인하고, 하나라도 없으면 사용자에게 권한을 요청합니다. 권한이 이미 허용되어 있다면 getMmsUserAgent()를 호출해 결과를 TextView에 출력합니다. 권한 요청 결과는 onRequestPermissionsResult() 콜백에서 처리됩니다.
4단계: 매니페스트에 권한 선언
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>
MmsUserAgent 값은 민감한 전화 정보에 해당하므로, 반드시 READ_PHONE_STATE 권한을 매니페스트에 선언해야 합니다. 참고로 위 예제 코드에서 READ_SMS 권한도 함께 확인하므로, 필요하다면 <uses-permission android:name="android.permission.READ_SMS" /> 항목도 추가하는 것이 좋습니다.
앱 실행 및 결과 확인
이제 애플리케이션을 실행해 보겠습니다. 실제 안드로이드 기기가 컴퓨터에 연결되어 있다고 가정합니다. Android Studio에서 프로젝트의 액티비티 파일 중 하나를 연 뒤 툴바의 Run 아이콘을 클릭하고, 실행 대상으로 자신의 모바일 기기를 선택하세요. 그러면 기기 화면에 아래와 같이 기본 MmsUserAgent 값이 표시됩니다.
