Kotlinのパーミッション管理の基本!ユーザーの許可を取得する方法
生徒
「Androidアプリを作ってみたいんですが、カメラや位置情報を使うときに『許可』が必要って聞きました。どうやって設定するんですか?」
先生
「いい質問ですね。Androidでは、カメラやマイク、位置情報などを使う前に、ユーザーから『パーミッション(許可)』をもらう必要があります。」
生徒
「パーミッションってどうやってアプリの中で設定するんですか?何か特別なコードが必要ですか?」
先生
「はい、Kotlinでの書き方を含めて、パーミッションの基本から順番に説明していきますね。」
1. パーミッションとは?Androidアプリ開発での役割
Androidアプリ開発において、パーミッション(permission)とは、「このアプリがカメラを使っても良いですか?」「位置情報にアクセスしてもいいですか?」というユーザーの許可を意味します。スマホの中には個人情報がたくさんあるため、ユーザーにちゃんと確認することがルールになっています。
2. パーミッションはいつ必要?
パーミッションが必要になるのは、次のようなデバイスの機能や情報にアクセスするときです:
- カメラを使いたいとき
- マイクで録音したいとき
- 現在地(GPS)を取得したいとき
- 連絡先やファイルにアクセスしたいとき
これらの操作は、アプリを作った人が勝手に使えないように、ユーザーの同意が必要です。
3. AndroidManifest.xml にパーミッションを宣言
まず最初に行うのは、AndroidManifest.xmlという設定ファイルに、使いたいパーミッションを宣言
<uses-permission android:name="android.permission.CAMERA" />
この設定だけでは使えるようにはなりません。Android 6.0以降は、アプリの実行中にユーザーに確認して、許可を得る必要があります。
4. Kotlinでパーミッションをリクエストする基本コード
Kotlinでユーザーにパーミッションを求めるには、以下のようなコードを使います。
if (ContextCompat.checkSelfPermission(this, Manifest.permission.CAMERA)
!= PackageManager.PERMISSION_GRANTED) {
ActivityCompat.requestPermissions(
this,
arrayOf(Manifest.permission.CAMERA),
100
)
}
ここでは、まずパーミッションが許可されているかをチェックし、まだならリクエスト(要求)します。
5. requestPermissionsの仕組みと使い方
requestPermissionsは、ユーザーに「このアプリがカメラを使ってもいいですか?」と表示して、許可を求めるための関数です。第3引数の100はリクエストコードと呼ばれ、あとで結果を確認するときに使います。
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. パーミッションに関する注意点とベストプラクティス
パーミッションを扱うときには、次のポイントに注意しましょう:
- 必要なときにだけリクエストする(アプリ起動時にまとめて聞かない)
- 「なぜ必要か」を説明するUI(ダイアログなど)を入れる
- 拒否された場合の代替手段を用意する
特にユーザーが「今後表示しない」と選んだ場合は、設定画面から手動で許可してもらう必要があります。こうしたケースも考慮しておくことが重要です。
8. 実行結果の例
上記のコードを使って、パーミッションの確認と要求を行った場合の実行結果の一例です。
カメラの使用を許可しますか?
[許可] [拒否]
許可を選ぶと、アプリ内でカメラ機能が使えるようになります。
Kotlinを基礎からしっかり学びたい人や、 Java経験を活かしてモダンな言語にステップアップしたい人には、 定番の入門書がこちらです。
基礎からわかるKotlinをAmazonで見る※ Amazon広告リンク
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つの体験
プロと同じ道具を揃えることで、明日から一人でもプログラミングを続けられる環境が整います。
「変数」や「型」といった難しい言葉も、身近な例え話で解説。モヤモヤをゼロにします。
Kotlinは英語に近くて読みやすいのが特徴。自分でコードを読んで、間違いを見つけるコツも伝授します。
※本講座は、パソコン操作が不安な方でも安心して受講いただける完全マンツーマンです。あなたのペースに合わせて、一つずつ丁寧に進めていきます。
Kotlinで始めるプログラミング入門|ゼロから「動く喜び」を体験