カテゴリ: Kotlin 更新日: 2025/11/20

Kotlinのパーミッション管理の基本!ユーザーの許可を取得する方法

Kotlinのパーミッション管理の基本!ユーザーの許可を取得する方法
Kotlinのパーミッション管理の基本!ユーザーの許可を取得する方法

先生と生徒の会話形式で理解しよう

生徒

「Androidアプリを作ってみたいんですが、カメラや位置情報を使うときに『許可』が必要って聞きました。どうやって設定するんですか?」

先生

「いい質問ですね。Androidでは、カメラやマイク、位置情報などを使う前に、ユーザーから『パーミッション(許可)』をもらう必要があります。」

生徒

「パーミッションってどうやってアプリの中で設定するんですか?何か特別なコードが必要ですか?」

先生

「はい、Kotlinでの書き方を含めて、パーミッションの基本から順番に説明していきますね。」

1. パーミッションとは?Androidアプリ開発での役割

1. パーミッションとは?Androidアプリ開発での役割
1. パーミッションとは?Androidアプリ開発での役割

Androidアプリ開発において、パーミッション(permission)とは、「このアプリがカメラを使っても良いですか?」「位置情報にアクセスしてもいいですか?」というユーザーの許可を意味します。スマホの中には個人情報がたくさんあるため、ユーザーにちゃんと確認することがルールになっています。

2. パーミッションはいつ必要?

2. パーミッションはいつ必要?
2. パーミッションはいつ必要?

パーミッションが必要になるのは、次のようなデバイスの機能や情報にアクセスするときです:

  • カメラを使いたいとき
  • マイクで録音したいとき
  • 現在地(GPS)を取得したいとき
  • 連絡先やファイルにアクセスしたいとき

これらの操作は、アプリを作った人が勝手に使えないように、ユーザーの同意が必要です。

3. AndroidManifest.xml にパーミッションを宣言

3. AndroidManifest.xml にパーミッションを宣言
3. AndroidManifest.xml にパーミッションを宣言

まず最初に行うのは、AndroidManifest.xmlという設定ファイルに、使いたいパーミッションを宣言


<uses-permission android:name="android.permission.CAMERA" />

この設定だけでは使えるようにはなりません。Android 6.0以降は、アプリの実行中にユーザーに確認して、許可を得る必要があります。

4. Kotlinでパーミッションをリクエストする基本コード

4. Kotlinでパーミッションをリクエストする基本コード
4. Kotlinでパーミッションをリクエストする基本コード

Kotlinでユーザーにパーミッションを求めるには、以下のようなコードを使います。


if (ContextCompat.checkSelfPermission(this, Manifest.permission.CAMERA)
    != PackageManager.PERMISSION_GRANTED) {

    ActivityCompat.requestPermissions(
        this,
        arrayOf(Manifest.permission.CAMERA),
        100
    )
}

ここでは、まずパーミッションが許可されているかをチェックし、まだならリクエスト(要求)します。

5. requestPermissionsの仕組みと使い方

5. requestPermissionsの仕組みと使い方
5. requestPermissionsの仕組みと使い方

requestPermissionsは、ユーザーに「このアプリがカメラを使ってもいいですか?」と表示して、許可を求めるための関数です。第3引数の100はリクエストコードと呼ばれ、あとで結果を確認するときに使います。

6. 結果を受け取る処理:onRequestPermissionsResult

6. 結果を受け取る処理:onRequestPermissionsResult
6. 結果を受け取る処理:onRequestPermissionsResult

ユーザーが「許可」または「拒否」を選んだあと、その結果はonRequestPermissionsResultという関数で受け取ります。


override fun onRequestPermissionsResult(
    requestCode: Int,
    permissions: Array<out String>,
    grantResults: IntArray
) {
    if (requestCode == 100) {
        if (grantResults.isNotEmpty() && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
            // 許可された処理
        } else {
            // 拒否された処理
        }
    }
}

この中で、許可された場合と拒否された場合の処理をそれぞれ書き分けます。

7. パーミッションに関する注意点とベストプラクティス

7. パーミッションに関する注意点とベストプラクティス
7. パーミッションに関する注意点とベストプラクティス

パーミッションを扱うときには、次のポイントに注意しましょう:

  • 必要なときにだけリクエストする(アプリ起動時にまとめて聞かない)
  • 「なぜ必要か」を説明するUI(ダイアログなど)を入れる
  • 拒否された場合の代替手段を用意する

特にユーザーが「今後表示しない」と選んだ場合は、設定画面から手動で許可してもらう必要があります。こうしたケースも考慮しておくことが重要です。

8. 実行結果の例

8. 実行結果の例
8. 実行結果の例

上記のコードを使って、パーミッションの確認と要求を行った場合の実行結果の一例です。


カメラの使用を許可しますか?
[許可] [拒否]

許可を選ぶと、アプリ内でカメラ機能が使えるようになります。

9. よく使われるパーミッション一覧

9. よく使われるパーミッション一覧
9. よく使われるパーミッション一覧

Android開発でよく使うパーミッションには以下のようなものがあります:

  • android.permission.CAMERA:カメラ機能
  • android.permission.RECORD_AUDIO:マイク録音
  • android.permission.ACCESS_FINE_LOCATION:GPSの位置情報
  • android.permission.READ_EXTERNAL_STORAGE:外部ストレージの読み取り

これらは、セキュリティに関わる重要な操作なので、ユーザーの信頼を得る説明があると安心です。

カテゴリの一覧へ
新着記事
Go言語の構造体でインターフェースを実装する方法を初心者向けにやさしく解説!
Kotlinの演算子一覧と使い方!算術・比較・論理演算子の基本を解説
Go言語の文字列フォーマット!fmt.Sprintfで簡単に出力を整形する方法
Go言語のエラーと例外の違いを初心者向けに整理!わかりやすく解説
人気記事
No.1
Kotlin・Go・Swift記事の人気No1
Swiftのwhile文とrepeat while文を完全マスター!初心者にもわかる繰り返し処理の使い方と違い
No.2
Kotlin・Go・Swift記事の人気No2
Swift入門ガイド|基本構文と書き方をマスターしよう
No.3
Kotlin・Go・Swift記事の人気No3
Android Studioのインストール手順と初期設定を初心者向けに完全解説!
No.4
Kotlin・Go・Swift記事の人気No4
Kotlinの正規表現(Regex)の使い方をやさしく解説!文字列操作の基本を初心者向けに学ぼう
No.5
Kotlin・Go・Swift記事の人気No5
Kotlinで画面を作る!レイアウトXMLとビューの基本操作をやさしく解説
No.6
Kotlin・Go・Swift記事の人気No6
Kotlinのコンパニオンオブジェクトとは?初心者向けに使い方と役割をわかりやすく解説!
No.7
Kotlin・Go・Swift記事の人気No7
Kotlinのwhen式を完全ガイド!初心者でもわかるパターンマッチング的な使い方
No.8
Kotlin・Go・Swift記事の人気No8
Swiftのオプショナル型とは?初心者でもわかる使い方とアンラップの基礎