qrcode-inventory/ANDROID_CAMERA_TROUBLESHOOTING.md

Android Camera Troubleshooting Guide

This guide provides comprehensive troubleshooting steps for Android camera issues in the QR Inventory Management System.

Common Android Camera Issues

1. Camera Permission Denied

Symptoms:

• Camera permission denied error
• Scanner shows "Permission Denied" status
• No camera preview

Solutions:

Method 1: App Permissions

1. Go to Settings → Apps → Your Browser (Chrome, Firefox, etc.)
2. Tap on Permissions
3. Enable Camera permission
4. Force stop the browser and restart it

Method 2: Browser Settings

1. Open your browser
2. Go to browser settings (usually via 3-dot menu)
3. Look for Site Settings or Permissions
4. Find Camera permission
5. Allow camera access for the site

Method 3: Site-Specific Permissions

1. Visit your application URL
2. Click the padlock icon in the address bar
3. Find Camera in the permissions list
4. Change from "Blocked" to "Allowed"

2. Camera Not Found

Symptoms:

• "No cameras found" error
• Camera Available status shows "No Camera"
• Scanner won't start

Solutions:

Method 1: Check Physical Camera

1. Ensure camera lens is not blocked
2. Test camera with other apps (Camera app, Instagram, etc.)
3. Restart the device

Method 2: Check Browser Support

1. Update your browser to the latest version
2. Try a different browser (Chrome, Firefox, Samsung Internet)
3. Clear browser cache and data

Method 3: Check Android Version

• Minimum supported: Android 7.0 (Nougat)
• Recommended: Android 10.0 or later

3. Camera Already in Use

Symptoms:

• "Camera is already in use" error
• Scanner starts but shows black screen
• Other camera apps work fine

Solutions:

Method 1: Close Other Apps

1. Close all apps that might be using the camera
2. Check running apps and force stop camera-related apps
3. Restart the browser

Method 2: Restart Device

1. Power off the device completely
2. Wait 10 seconds
3. Power back on and try again

4. Video Playback Failed

Symptoms:

• Camera starts but shows black screen
• "Video playback failed" error
• Scanner shows active but no video

Solutions:

Method 1: Check Browser Compatibility

1. Use Chrome or Firefox for best compatibility
2. Update browser to latest version
3. Disable hardware acceleration in browser settings

Method 2: Adjust Camera Constraints

The application automatically tries different camera constraints. If issues persist:

1. Restart the application
2. Try switching between front and back cameras
3. Use the "Simulate Scan" feature for testing

5. QR Code Not Detected

Symptoms:

• Camera works but QR codes are not detected
• Scanner shows active but no recognition
• QR codes work in other apps

Solutions:

Method 1: Improve Scanning Conditions

1. Ensure good lighting on the QR code
2. Hold device steady when scanning
3. Position QR code within the scanning frame
4. Ensure QR code is not damaged or blurry

Method 2: Adjust Distance and Angle

1. Hold device 6-12 inches from QR code
2. Keep QR code parallel to camera
3. Avoid glare or reflections on the QR code

Method 3: Test Different QR Codes

1. Try scanning different QR codes
2. Use the "Simulate Scan" feature to test the application
3. Generate a new QR code and test

Device-Specific Solutions

Samsung Devices

1. Go to Settings → Apps → (Your Browser) → Permissions
2. Enable all permissions
3. Go to Settings → Advanced Features → Smart Stay
4. Disable Smart Stay temporarily

Google Pixel Devices

1. Go to Settings → Apps & Notifications → (Your Browser)
2. Enable camera permission
3. Clear browser cache and data
4. Restart the device

OnePlus Devices

1. Go to Settings → Apps → (Your Browser) → Permissions
2. Enable camera permission
3. Go to Settings → Battery → Battery Optimization
4. Disable battery optimization for the browser

Browser-Specific Solutions

Google Chrome

1. Update Chrome to latest version
2. Go to Settings → Privacy and Security → Site Settings
3. Ensure Camera is set to "Allowed"
4. Clear browsing data

Mozilla Firefox

1. Update Firefox to latest version
2. Go to Settings → Privacy & Security
3. Scroll down to Permissions
4. Ensure Camera access is allowed

Samsung Internet

1. Update Samsung Internet
2. Go to Settings → Sites and Downloads → Sites
3. Find your site and allow camera access
4. Clear cache and data

Advanced Troubleshooting

Enable Debug Mode

The application includes debug logging. To enable:

1. Open browser developer tools (F12)
2. Go to Console tab
3. Look for camera-related log messages
4. Share logs with support if needed

Test Camera Access Manually

Open browser console and run:

// Check if camera is supported
if (!navigator.mediaDevices || !navigator.mediaDevices.getUserMedia) {
  console.error('Camera not supported');
} else {
  console.log('Camera is supported');
}

// Test camera access
navigator.mediaDevices.getUserMedia({ video: true })
  .then(stream => {
    console.log('Camera access successful');
    stream.getTracks().forEach(track => track.stop());
  })
  .catch(error => {
    console.error('Camera access failed:', error);
  });

Check Device Capabilities

// Check available cameras
navigator.mediaDevices.enumerateDevices()
  .then(devices => {
    const cameras = devices.filter(device => device.kind === 'videoinput');
    console.log('Available cameras:', cameras);
  })
  .catch(error => {
    console.error('Error enumerating devices:', error);
  });

Alternative Solutions

Use Manual Entry

If camera continues to fail:

1. Use the "Manual Entry" button in the scanner
2. Enter QR code data manually
3. This bypasses camera requirements entirely

Use Desktop Scanner

For critical operations:

1. Use a desktop computer with webcam
2. Or use a dedicated QR scanner app
3. Import data via Excel/CSV import feature

Contact Support

If issues persist after trying all solutions:

1. Provide device model and Android version
2. Specify browser and version
3. Share console error logs
4. Describe exact steps to reproduce the issue

Quick Reference Commands

Restart Browser

location.reload();

Clear Site Data

1. Browser settings → Privacy → Clear browsing data
2. Select "Cached images and files" and "Site data"

Reset Permissions

1. Browser settings → Site Settings → Camera
2. Find your site and reset permissions

---

This troubleshooting guide should help resolve most Android camera issues. The application is optimized for Android devices with automatic fallbacks and alternative input methods.