aboutsummaryrefslogtreecommitdiff
path: root/core/src/main/kotlin/ca/allanwang/kau/permissions/Permissions.kt
blob: 248e484a1498a922de6357b5875d8f1bd49bf210 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
package ca.allanwang.kau.permissions

import android.Manifest
import android.app.Activity
import android.content.Context
import android.os.Build
import android.support.annotation.RequiresApi


/**
 * Created by Allan Wang on 2017-07-02.
 *
 * Bindings for the permission manager
 * This is the only class you need to worry about when using KAU's manager
 *
 * MAKE SURE [kauOnRequestPermissionsResult] is added to your activities,
 * and don't forget to request the permissions in your manifest.
 * A collection of constants redirecting to the [Manifest.permission] counterparts
 * are added for your convenience
 */

/**
 * Hook that should be added inside all [Activity.onRequestPermissionsResult] so that the Permission manager can handle the responses
 */
fun Activity.kauOnRequestPermissionsResult(permissions: Array<out String>, grantResults: IntArray) = PermissionManager.onRequestPermissionsResult(this, permissions, grantResults)

/**
 * Request a permission with a callback
 * In reality, an activity is needed to fulfill the request, but a context is enough if those permissions are already granted
 * To be safe, you may want to check that the context can be casted successfully first
 * The [callback] returns [granted], which is true if all permissions are granted
 * [deniedPerm] is the first denied permission, if granted is false
 */
fun Context.kauRequestPermissions(vararg permissions: String, callback: (granted: Boolean, deniedPerm: String?) -> Unit) = PermissionManager(this, permissions, callback)

/**
 * See http://developer.android.com/guide/topics/security/permissions.html#normal-dangerous for a
 * list of 'dangerous' permissions that require a permission request on API 23.
 */
const val PERMISSION_READ_CALENDAR = Manifest.permission.READ_CALENDAR

const val PERMISSION_WRITE_CALENDAR = Manifest.permission.WRITE_CALENDAR

const val PERMISSION_CAMERA = Manifest.permission.CAMERA

const val PERMISSION_READ_CONTACTS = Manifest.permission.READ_CONTACTS
const val PERMISSION_WRITE_CONTACTS = Manifest.permission.WRITE_CONTACTS
const val PERMISSION_GET_ACCOUNTS = Manifest.permission.GET_ACCOUNTS

const val PERMISSION_ACCESS_FINE_LOCATION = Manifest.permission.ACCESS_FINE_LOCATION
const val PERMISSION_ACCESS_COARSE_LOCATION = Manifest.permission.ACCESS_COARSE_LOCATION

const val PERMISSION_RECORD_AUDIO = Manifest.permission.RECORD_AUDIO

const val PERMISSION_READ_PHONE_STATE = Manifest.permission.READ_PHONE_STATE
const val PERMISSION_CALL_PHONE = Manifest.permission.CALL_PHONE
const val PERMISSION_READ_CALL_LOG = Manifest.permission.READ_CALL_LOG
const val PERMISSION_WRITE_CALL_LOG = Manifest.permission.WRITE_CALL_LOG
const val PERMISSION_ADD_VOICEMAIL = Manifest.permission.ADD_VOICEMAIL
const val PERMISSION_USE_SIP = Manifest.permission.USE_SIP
const val PERMISSION_PROCESS_OUTGOING_CALLS = Manifest.permission.PROCESS_OUTGOING_CALLS

@RequiresApi(Build.VERSION_CODES.KITKAT_WATCH)
const val PERMISSION_BODY_SENSORS = Manifest.permission.BODY_SENSORS

const val PERMISSION_SEND_SMS = Manifest.permission.SEND_SMS
const val PERMISSION_RECEIVE_SMS = Manifest.permission.RECEIVE_SMS
const val PERMISSION_READ_SMS = Manifest.permission.READ_SMS
const val PERMISSION_RECEIVE_WAP_PUSH = Manifest.permission.RECEIVE_WAP_PUSH
const val PERMISSION_RECEIVE_MMS = Manifest.permission.RECEIVE_MMS

const val PERMISSION_READ_EXTERNAL_STORAGE = Manifest.permission.READ_EXTERNAL_STORAGE
const val PERMISSION_WRITE_EXTERNAL_STORAGE = Manifest.permission.WRITE_EXTERNAL_STORAGE

const val PERMISSION_SYSTEM_ALERT_WINDOW = Manifest.permission.SYSTEM_ALERT_WINDOW