カテゴリ: 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. 実行結果の例

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


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

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

Kotlinを基礎からしっかり学びたい人や、 Java経験を活かしてモダンな言語にステップアップしたい人には、 定番の入門書がこちらです。

基礎からわかるKotlinをAmazonで見る

※ Amazon広告リンク

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

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

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

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

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

関連セミナーのご案内

【未経験OK】Kotlinで始めるプログラミング入門|ゼロから「動く喜び」を体験する60分

「プログラミングを始めたい」を形にする。最新言語Kotlinで楽しむ、ものづくりの第一歩。

本講座は、プログラミング経験が全くない方のためのエントリー講座です。「コードを書くってどういうこと?」という基本から、世界中で使われている最新言語Kotlin(コトリン)を使って、実際にプログラムを動かすまでを体験します。難しい理屈よりも、まずは「自分の手で動かす楽しさ」を最短距離で実感していただきます。

具体的な体験内容と環境

【つくるもの】
簡単な言葉を入力すると自動で返答してくれる「対話型ミニプログラム」や、計算を自動化する「便利ツール」をゼロから作成します。黒い画面に自分の書いた文字が表示される瞬間は、最高の感動体験です。

【開発環境】
プロのエンジニアが実際に使っている開発ツールIntelliJ IDEA(インテリジェイ)をインストールします。ボタン一つで日本語化し、初心者でも迷わず操作できる「魔法の設定」を一緒に行います。

この60分で得られる3つの体験

1. 自分のパソコンが「開発基地」に

プロと同じ道具を揃えることで、明日から一人でもプログラミングを続けられる環境が整います。

2. プログラミングの「仕組み」がスッキリ

「変数」や「型」といった難しい言葉も、身近な例え話で解説。モヤモヤをゼロにします。

3. 「読みやすい」から「直せる」へ

Kotlinは英語に近くて読みやすいのが特徴。自分でコードを読んで、間違いを見つけるコツも伝授します。

※本講座は、パソコン操作が不安な方でも安心して受講いただける完全マンツーマンです。あなたのペースに合わせて、一つずつ丁寧に進めていきます。

セミナー画像

Kotlinで始めるプログラミング入門|ゼロから「動く喜び」を体験

カテゴリの一覧へ
新着記事
New1
Go言語
Go言語のwhile的なforループの使い方!条件式ループの基本を解説
New2
Go言語
Go言語プログラムの実行方法まとめ!VSCode・ターミナルでの実行手順を解説
New3
Swift
Swift意味とは?プログラミング言語・金融・鳥の違いを徹底解説
New4
Swift
Swift 戻り値の扱い方と複数戻り値の返し方|初心者でも分かる関数の基本
人気記事
No.1
Java&Spring記事人気No1
Go言語
Go言語でリダイレクト処理を行う方法(http.Redirect)を初心者向けに解説
No.2
Java&Spring記事人気No2
Swift
Swift開発環境の構築方法を徹底解説!Xcode・Windows・Linux対応
No.3
Java&Spring記事人気No3
Kotlin
Android Studioのインストール手順と初期設定を初心者向けに完全解説!
No.4
Java&Spring記事人気No4
Kotlin
Gradleファイル(build.gradle.kts)の書き方と役割をやさしく解説!Kotlin初心者向け完全ガイド
No.5
Java&Spring記事人気No5
Go言語
Go言語のgo.modファイル完全ガイド!初心者でもわかる仕組みと書き方
No.6
Java&Spring記事人気No6
Swift
Swift Playgroundの使い方を完全解説!初心者に最適な学習環境の始め方
No.7
Java&Spring記事人気No7
Go言語
Go言語で条件式を1行で書くコツ!三項演算子の代替と短縮記法
No.8
Java&Spring記事人気No8
Kotlin
Kotlinのログ出力方法を完全ガイド!LogcatとTimberでトラブルシューティング