안드로이드에서 일반적인 사용자 에이전트(User Agent) 유형을 감지하는 방법

이 튜토리얼에서는 안드로이드 환경에서 일반적인 사용자 에이전트(User Agent) 유형을 감지하는 방법을 단계별 예제와 함께 소개합니다.

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"
    android:padding="16dp"
    tools:context=".MainActivity">

    <TextView
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:text="Detect Android user agent type in general"
        android:textSize="24sp"
        android:textStyle="bold"/>

</RelativeLayout>

3단계: MainActivity 코드 작성

src/MainActivity.java 파일에 다음 코드를 추가합니다. 이 예제에서는 AudioManager를 활용해 현재 벨소리 모드(무음·진동·일반)를 판별하고, 그 결과를 토스트(Toast) 메시지로 화면에 표시합니다.

import androidx.appcompat.app.AppCompatActivity;
import android.content.Context;
import android.media.AudioManager;
import android.os.Bundle;
import android.widget.Toast;
import java.util.Objects;

public class MainActivity extends AppCompatActivity {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        AudioManager am = (AudioManager) getSystemService(Context.AUDIO_SERVICE);
        switch (Objects.requireNonNull(am).getRingerMode()) {
            case AudioManager.RINGER_MODE_SILENT:
                Toast.makeText(MainActivity.this, "Silent Mode", Toast.LENGTH_SHORT).show();
                break;
            case AudioManager.RINGER_MODE_VIBRATE:
                Toast.makeText(MainActivity.this, "Vibrate Mode", Toast.LENGTH_SHORT).show();
                break;
            case AudioManager.RINGER_MODE_NORMAL:
                Toast.makeText(MainActivity.this, "Normal Mode", Toast.LENGTH_SHORT).show();
                break;
        }
    }
}

4단계: AndroidManifest.xml 설정

androidManifest.xml 파일에 아래 코드를 추가합니다.

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="https://schemas.android.com/apk/res/android" package="app.com.sample">
    <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 Studio에서 프로젝트의 액티비티 파일 중 하나를 연 뒤, 툴바의 Run 아이콘을 클릭하세요. 실행 옵션 목록에서 연결된 모바일 기기를 선택하면, 기기 화면에 아래와 같은 기본 화면이 표시됩니다.

참고: 사용자 에이전트 문자열을 직접 확인하는 방법

기기의 사용자 에이전트 문자열을 직접 확인하고 싶다면 다음과 같은 간단한 방법을 사용할 수 있습니다.

// 1) 시스템 속성을 통해 확인
String userAgent = System.getProperty("http.agent");

// 2) WebSettings 유틸리티를 통해 확인 (API 레벨 17 이상)
String userAgent = WebSettings.getDefaultUserAgent(getApplicationContext());

반환되는 문자열에는 기기 모델명, 안드로이드 버전, 빌드 정보 등이 포함되어 있습니다. 이 값을 분석하면 해당 기기가 스마트폰인지 태블릿인지, 어떤 안드로이드 버전을 사용하는지 등을 파악할 수 있어 웹 콘텐츠 최적화나 기기별 분기 처리에 유용하게 활용됩니다.