Google Colab中笔记本电脑摄像头实时视频访问故障排查

1. 替换为Colab兼容的摄像头访问代码 #

直接用OpenCV的cv2.VideoCapture(0)在Colab环境中无法正常工作——因为Colab运行在云端服务器，必须通过浏览器媒体API获取本地摄像头流。使用以下官方推荐的代码测试：

import cv2
from IPython.display import display, Javascript
from google.colab.output import eval_js
from base64 import b64decode
import numpy as np

def capture_video_frame(quality=0.8):
    js = Javascript('''
        async function captureFrame(quality) {
            const video = document.createElement('video');
            video.style.display = 'none';
            const stream = await navigator.mediaDevices.getUserMedia({video: true});
            document.body.appendChild(video);
            video.srcObject = stream;
            await video.play();

            const canvas = document.createElement('canvas');
            canvas.width = video.videoWidth;
            canvas.height = video.videoHeight;
            canvas.getContext('2d').drawImage(video, 0, 0);
            stream.getVideoTracks()[0].stop();
            video.remove();
            return canvas.toDataURL('image/jpeg', quality);
        }
    ''')
    display(js)
    data = eval_js('captureFrame({})'.format(quality))
    binary = b64decode(data.split(',')[1])
    # 转换为OpenCV可处理的格式
    img = cv2.imdecode(np.frombuffer(binary, np.uint8), cv2.IMREAD_COLOR)
    return img

# 测试捕获单帧并显示
try:
    frame = capture_video_frame()
    from IPython.display import Image
    display(Image(cv2.imencode('.jpg', cv2.cvtColor(frame, cv2.COLOR_BGR2RGB))[1].tobytes()))
except Exception as err:
    print(f"错误信息: {str(err)}")

2. 重新确认浏览器摄像头权限 #

• 点击浏览器地址栏左侧的摄像头图标，确认colab.research.google.com的摄像头权限为「允许」
• 若用Chrome，可进入chrome://settings/content/camera，检查Colab是否在允许列表，若在阻止列表则移除后重新授权

3. 排查浏览器环境问题 #

• 使用Chrome、Firefox等现代浏览器，避免旧版或小众浏览器
• 关闭隐私模式、VPN，禁用广告拦截/隐私类插件（如uBlock Origin），这类工具可能拦截媒体设备访问
• 确保本地摄像头未被其他应用占用（如系统相机、Zoom），关闭占用程序后重试

4. 重启Colab运行时 #

点击顶部菜单栏 Runtime -> Restart runtime，清除环境缓存后重新运行代码，解决可能的进程冲突问题

内容的提问来源于stack exchange，提问作者Master RA