You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
51 lines
1.7 KiB
51 lines
1.7 KiB
---
|
|
layout: page
|
|
title: "Runtime Permissions"
|
|
description: "Permissions and Manifest setup"
|
|
category: docs
|
|
order: 13
|
|
date: 2018-12-20 20:03:03
|
|
disqus: 1
|
|
---
|
|
|
|
CameraView needs two permissions:
|
|
|
|
- `android.permission.CAMERA` : required for capturing pictures and videos
|
|
- `android.permission.RECORD_AUDIO` : required for capturing videos with `Audio.ON` (the default)
|
|
|
|
### Declaration
|
|
|
|
The library manifest file declares the `android.permission.CAMERA` permission, but not the audio one.
|
|
This means that:
|
|
|
|
- If you wish to record videos with `Audio.ON` (the default), you should also add
|
|
`android.permission.RECORD_AUDIO` to required permissions
|
|
|
|
```xml
|
|
<uses-permission android:name="android.permission.RECORD_AUDIO"/>
|
|
```
|
|
|
|
- If you want your app to be installed only on devices that have a camera, you should add:
|
|
|
|
```xml
|
|
<uses-feature
|
|
android:name="android.hardware.camera"
|
|
android:required="true"/>
|
|
```
|
|
|
|
If you don't request this feature, you can use `CameraUtils.hasCameras()` to detect if current
|
|
device has cameras, and then start the camera view.
|
|
|
|
### Handling
|
|
|
|
On Marshmallow+, the user must explicitly approve our permissions. You can either:
|
|
|
|
- handle permissions yourself and then call `open()` or `setLifecycleOwner()` once they are acquired
|
|
- let `CameraView` request permissions: we will present a permission request to the user based on
|
|
whether they are needed or not with the current configuration.
|
|
|
|
The automatic request is currently done at the activity level, so the permission request callback
|
|
`onRequestPermissionResults()` will be invoked on the parent activity, not the fragment.
|
|
|
|
The automatic request can be disabled by setting `app:cameraRequestPermissions="false"` in your
|
|
XML declaration. |