At the time of writing, the QCamera method "isAvailable()" has the documentation saying "Returns true if the camera can be used.". In the current implementation, this only checks if the device assigned is not a null-device.

The documentation seems to imply this should act as a hint that calling .start() is likely to succeed in making the camera become active. However, there are several factors that are not accounted for here:

• The device might be set to something non-null, but that device has since been disconnected.
• The application has not received permission to perform captures.
• The camera is currently in exclusive use by another application on the system, so our application not begin a capture.

We should update the documentation and implementation so that the behavior more closely describes what the documentation says.