안드로이드 앱에서 전화 걸기 기능 구현하기
이 튜토리얼에서는 안드로이드에서 전화를 거는 방법을 단계별로 살펴봅니다. 기기에 저장된 연락처를 불러와 리스트로 표시하고, 항목을 탭하면 해당 번호로 바로 전화가 걸리는 간단한 데모 앱을 만들어 보겠습니다.
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"
android:layout_width = "match_parent"
android:gravity = "center"
android:layout_height = "match_parent">
<ListView
android:id = "@+id/list"
android:layout_width = "wrap_content"
android:textSize = "30sp"
android:layout_height = "wrap_content"/>
</LinearLayout>
위 코드에서는 화면 중앙에 ListView 하나를 배치했습니다. 이 리스트에 연락처 이름이 표시됩니다.
3단계 — MainActivity 작성
src/MainActivity.java에 다음 코드를 추가합니다.
package com.example.myapplication;
import android.annotation.TargetApi;
import android.app.Activity;
import android.content.ContentResolver;
import android.content.Context;
import android.content.Intent;
import android.content.pm.PackageManager;
import android.database.Cursor;
import android.net.Uri;
import android.os.Build;
import android.os.Bundle;
import android.provider.ContactsContract;
import android.support.annotation.NonNull;
import android.support.v4.app.ActivityCompat;
import android.support.v7.app.AppCompatActivity;
import android.view.View;
import android.widget.AdapterView;
import android.widget.ArrayAdapter;
import android.widget.ListView;
import android.widget.Toast;
import java.util.ArrayList;
public class MainActivity extends AppCompatActivity {
public static final int REQUEST_READ_CONTACTS = 79;
private static final int REQUEST = 112;
ListView list;
ArrayList mobileArray;
ArrayList numberArray;
String number;
@TargetApi(Build.VERSION_CODES.LOLLIPOP)
@Override
public void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
numberArray = new ArrayList();
if (ActivityCompat.checkSelfPermission(this, android.Manifest.permission.READ_CONTACTS)
== PackageManager.PERMISSION_GRANTED) {
mobileArray = getAllContacts();
} else {
requestPermission();
}
list = findViewById(R.id.list);
ArrayAdapter adapter = new ArrayAdapter<String>(this,
android.R.layout.simple_list_item_1, android.R.id.text1, mobileArray);
list.setAdapter(adapter);
list.setOnItemClickListener(new AdapterView.OnItemClickListener() {
@Override
public void onItemClick(AdapterView<?> parent, View view, int position, long id) {
number = (String) numberArray.get(position);
if (Build.VERSION.SDK_INT >= 23) {
String[] PERMISSIONS = {android.Manifest.permission.CALL_PHONE};
if (!hasPermissions(MainActivity.this, PERMISSIONS)) {
ActivityCompat.requestPermissions((Activity) MainActivity.this, PERMISSIONS, REQUEST);
} else {
makeCall(number);
}
} else {
makeCall(number);
}
}
});
}
private static boolean hasPermissions(Context context, String... permissions) {
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M && context != null && permissions != null) {
for (String permission : permissions) {
if (ActivityCompat.checkSelfPermission(context, permission) != PackageManager.PERMISSION_GRANTED) {
return false;
}
}
}
return true;
}
private void makeCall(String number) {
Intent phoneCallIntent = new Intent(Intent.ACTION_CALL);
phoneCallIntent.setData(Uri.parse("tel:" + number));
startActivity(phoneCallIntent);
}
private void requestPermission() {
if (ActivityCompat.shouldShowRequestPermissionRationale(this,
android.Manifest.permission.READ_CONTACTS)) {
// 필요하다면 여기에 권한이 왜 필요한지 설명하는 UI를 보여줄 수 있습니다.
} else {
ActivityCompat.requestPermissions(this, new String[]{android.Manifest.permission.READ_CONTACTS},
REQUEST_READ_CONTACTS);
}
}
@Override
public void onRequestPermissionsResult(int requestCode,
String permissions[], int[] grantResults) {
switch (requestCode) {
case REQUEST_READ_CONTACTS: {
if (grantResults.length > 0 && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
mobileArray = getAllContacts();
} else {
// 권한이 거부된 경우, 이 권한에 의존하는 기능을 비활성화합니다.
}
return;
}
case REQUEST: {
if (grantResults.length > 0 && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
makeCall(number);
} else {
Toast.makeText(MainActivity.this, "통화 권한이 허용되지 않았습니다.", Toast.LENGTH_LONG).show();
}
}
}
}
private ArrayList getAllContacts() {
ArrayList<String> nameList = new ArrayList<>();
ContentResolver cr = getContentResolver();
Cursor cur = cr.query(ContactsContract.Contacts.CONTENT_URI,
null, null, null, null);
if ((cur != null ? cur.getCount() : 0) > 0) {
while (cur != null && cur.moveToNext()) {
String id = cur.getString(
cur.getColumnIndex(ContactsContract.Contacts._ID));
String name = cur.getString(cur.getColumnIndex(
ContactsContract.Contacts.DISPLAY_NAME));
nameList.add(name);
if (cur.getInt(cur.getColumnIndex(ContactsContract.Contacts.HAS_PHONE_NUMBER)) > 0) {
Cursor pCur = cr.query(
ContactsContract.CommonDataKinds.Phone.CONTENT_URI,
null,
ContactsContract.CommonDataKinds.Phone.CONTACT_ID + " = ?",
new String[]{id}, null);
while (pCur.moveToNext()) {
String phoneNo = pCur.getString(pCur.getColumnIndex(
ContactsContract.CommonDataKinds.Phone.NUMBER));
numberArray.add(phoneNo);
}
pCur.close();
}
}
}
if (cur != null) {
cur.close();
}
return nameList;
}
}
위 코드의 핵심 동작을 정리하면 다음과 같습니다.
- 연락처 읽기 권한 확인 — READ_CONTACTS 권한이 이미 승인되어 있으면 getAllContacts() 메서드로 기기의 연락처를 가져오고, 그렇지 않으면 권한을 요청합니다.
- 리스트뷰 구성 — ArrayAdapter를 사용해 연락처 이름을 ListView에 표시합니다.
- 전화 걸기 — 리스트 항목을 탭하면 해당 위치의 전화번호를 가져온 뒤, CALL_PHONE 권한을 확인하고 makeCall() 메서드에서 ACTION_CALL 인텐트와 tel: URI를 조합해 즉시 전화를 겁니다.
- 권한 요청 결과 처리 — 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_CONTACTS" />
<uses-permission android:name = "android.permission.CALL_PHONE" />
<application
android:allowBackup = "true"
android:theme = "@style/AppTheme.NoActionBar"
android:icon = "@mipmap/ic_launcher"
android:label = "@string/app_name"
android:roundIcon = "@mipmap/ic_launcher_round"
android:supportsRtl = "true">
<activity
android:name = ".MainActivity"
android:configChanges = "keyboardHidden|orientation|screenSize">
<intent-filter>
<action android:name = "android.intent.action.MAIN" />
<action android:name = "android.intent.action.CREATE_SHORTCUT" />
<category android:name = "android.intent.category.LAUNCHER" />
</intent-filter>
</activity>
</application>
</manifest>
여기서 가장 중요한 부분은 두 개의 <uses-permission> 태그입니다. READ_CONTACTS 권한은 연락처를 읽어오기 위해, CALL_PHONE 권한은 앱에서 사용자 조작 없이 곧바로 전화를 걸기 위해 반드시 선언해야 합니다.
참고: 권한 없이 다이얼 화면만 띄우고 싶다면 Intent.ACTION_DIAL을 사용할 수 있습니다. ACTION_DIAL은 사용자가 직접 발신 버튼을 눌러야 하므로 별도 권한이 필요하지 않지만, ACTION_CALL은 권한 승인 시 즉시 통화를 연결하기 때문에 CALL_PHONE 권한 선언이 필수입니다.
앱 실행 및 테스트
이제 애플리케이션을 실행해 보겠습니다. 실제 안드로이드 기기가 컴퓨터에 연결되어 있다고 가정합니다. Android Studio에서 프로젝트의 액티비티 파일 중 하나를 연 뒤 툴바의 Run 아이콘을 클릭하세요. 실행 대상으로 자신의 모바일 기기를 선택하면, 기기 화면에 아래와 같은 기본 화면이 나타납니다.

목록에서 원하는 연락처를 탭하면 아래와 같이 해당 번호로 전화가 걸립니다.
