Android
 Computer >> コンピューター >  >> プログラミング >> Android

【Android開発】連絡先から電話をかけるアプリの作り方を徹底解説

はじめに

この記事では、Androidアプリから直接電話をかける機能を実装する方法を、ステップごとにわかりやすく解説します。デバイス内の連絡先を読み込み、リスト形式で表示し、タップした相手に発信できるシンプルなサンプルアプリを作成していきましょう。

電話発信には ACTION_CALL インテントを使用し、連絡先の読み取りや発信に必要なパーミッション(権限)のリクエスト処理もあわせて実装します。

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

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

ステップ2:レイアウトファイル(activity_main.xml)の編集

次に、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"
        android:text = "Click"/>
</LinearLayout>

このレイアウトでは、画面中央にListView(リストビュー)を配置しています。ここに後ほど取得した連絡先の一覧が表示されます。

ステップ3:MainActivity.java の実装

続いて、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);
        }
        if (ActivityCompat.shouldShowRequestPermissionRationale(this,
            android.Manifest.permission.READ_CONTACTS)) {
        } 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;
    }
}

コードのポイント

  • getAllContacts():ContentResolverを使って端末内の連絡先を取得し、氏名と電話番号をそれぞれリストに格納します。
  • makeCall(String number):ACTION_CALLインテントに「tel:」形式のURIをセットし、直接発信を実行します。
  • パーミッション処理:READ_CONTACTS(連絡先の読み取り)とCALL_PHONE(直接発信)の2つの権限を、ランタイムパーミッションとして適切にリクエストしています。

ステップ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_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」の2つの権限を宣言している点が重要です。これを忘れると、アプリ実行時にクラッシュや権限エラーが発生します。

アプリの実行と動作確認

それでは、実際にアプリを起動してみましょう。実機のAndroidスマートフォンをPCに接続していることを前提に説明します。Android Studioでプロジェクト内のアクティビティファイルを開き、ツールバーの「Run」アイコンをクリックしてください。接続中のモバイルデバイスを選択すると、実機にアプリがインストールされ、以下のような初期画面が表示されます。

【Android開発】連絡先から電話をかけるアプリの作り方を徹底解説

次に、リスト上の連絡先(テキスト)をタップしてみてください。発信権限が許可されていれば、選択した相手にそのまま電話がかかります。

【Android開発】連絡先から電話をかけるアプリの作り方を徹底解説

まとめ

本記事では、Androidアプリで連絡先一覧を取得・表示し、タップ操作で直接電話をかける方法を紹介しました。ポイントは以下の3つです。

  • ACTION_CALLインテントによる直接発信の実装
  • READ_CONTACTS/CALL_PHONEのランタイムパーミッション対応
  • ContentResolverとCursorを使った連絡先データの取得

なお、ACTION_CALLはユーザー確認なしで即座に発信されるため、より安全に実装したい場合は、ダイヤラー画面が開くだけの ACTION_DIAL を使う方法もあります。用途に応じて使い分けてください。

  1. WhatsAppのデスクトップ版で音声・ビデオ通話をかける方法を徹底解説

    WhatsAppは、スマートフォンユーザーなら誰でもワンクリックで音声通話やビデオ通話を使って大切な人とつながれる便利なアプリです。これまでiOSやAndroid向けに提供されていたこの機能が、現在ではデスクトップ版にも搭載されました。WhatsAppのデスクトップ版では、縦画面・横画面どちらの向きでも快適に音声通話とビデオ通話を利用できます。現時点では1対1の通話に対応していますが、今後はエンドツーエンドで暗号化されたグループ通話もデスクトップ版で利用できるようになる予定です。この記事では、WhatsApp Webでのビデオ通話のやり方について、詳しく解説していきます。パート1:WhatsA

  2. Androidで通話の自動転送を設定する方法|標準機能・ダイヤルコード・おすすめアプリ

    通話転送は、忙しいビジネスパーソンにとって欠かせない電話機能の一つです。プロのコツとしては、転送先にいる相手が電話に出られる状態であり、転送設定をしていることを事前に把握しておくこと。これだけで、後々の気まずいやり取りを大幅に減らせます。近年、優れた通話転送アプリを見つけるのは以前より難しくなっていますが、今回は徹底的に調査した上で、厳選したアプリをご紹介します。さらに、サードパーティ製アプリを使わずに通話転送を設定する方法も解説します。Androidの標準機能で通話転送を設定する外部アプリをインストールする前に、まずお使いのAndroidスマートフォンに内蔵の転送機能がないか確認しましょう。