Hey there! I’ve run into this exact black screen problem with OpenCV video recording a bunch of times—even when the camera itself works perfectly. Let’s walk through the most likely fixes step by step:

1. Double-Check Your Video Codec (FourCC) #

This is the #1 culprit for black screen recordings. Different operating systems have different preferred codecs, and using the wrong one can result in unreadable output files (even if the code runs without errors).

• For Windows: Try DIVX or XVID
• For Linux: XVID or MJPG (MJPG produces larger files but has great compatibility)
• For macOS: avc1 or MJPG

Example code to set the codec correctly:

import cv2

# Initialize camera
cap = cv2.VideoCapture(0)

# Set codec (adjust based on your OS)
fourcc = cv2.VideoWriter_fourcc(*'XVID')  # Works for most Windows/Linux setups
# fourcc = cv2.VideoWriter_fourcc(*'avc1')  # For macOS

2. Ensure You’re Actually Reading Frames from the Camera #

Sometimes the camera opens successfully, but frame grabbing fails silently. Always check the return value of cap.read()—if ret is False, your code isn’t getting any frames to record.

Add this check in your loop:

while cap.isOpened():
    ret, frame = cap.read()
    if not ret:
        print("Failed to grab frame from camera!")
        break  # Exit loop if no frames are being read
    
    # Display the frame (optional, but helps confirm camera is working)
    cv2.imshow('Recording', frame)
    
    # Write frame to video file
    out.write(frame)
    
    # Press 'q' to stop recording
    if cv2.waitKey(1) & 0xFF == ord('q'):
        break

3. Match VideoWriter Dimensions to Camera Frame Size #

If the resolution you set for VideoWriter doesn’t exactly match the camera’s output resolution, the recording will be black. Always pull the actual frame dimensions from the camera instead of hardcoding:

# Get camera's actual frame width and height
frame_width = int(cap.get(cv2.CAP_PROP_FRAME_WIDTH))
frame_height = int(cap.get(cv2.CAP_PROP_FRAME_HEIGHT))

# Initialize VideoWriter with matching dimensions
out = cv2.VideoWriter('output.avi', fourcc, 20.0, (frame_width, frame_height))

4. Check for Grayscale vs Color Frame Mismatch #

If your camera is outputting grayscale frames (single channel) but you initialized VideoWriter for color (3 channels), you’ll get a black screen. Verify your frame’s channel count with print(frame.shape):

• If output is (480, 640): Grayscale frame—add isColor=False to VideoWriter
• If output is (480, 640, 3): Color frame—keep isColor=True (default)

Example for grayscale:

out = cv2.VideoWriter('output_gray.avi', fourcc, 20.0, (frame_width, frame_height), isColor=False)

5. Release Resources in the Correct Order #

Always release the VideoWriter before releasing the camera. If you reverse this order, the video file might not be finalized properly, leading to unreadable (black) output:

# Correct order
out.release()
cap.release()
cv2.destroyAllWindows()

Full Working Example #

Here’s a complete, tested script that should avoid the black screen issue:

import cv2

# Initialize camera
cap = cv2.VideoCapture(0)
if not cap.isOpened():
    print("Could not open camera!")
    exit()

# Get camera specs
frame_width = int(cap.get(cv2.CAP_PROP_FRAME_WIDTH))
frame_height = int(cap.get(cv2.CAP_PROP_FRAME_HEIGHT))
fps = 20.0

# Set codec and initialize VideoWriter
fourcc = cv2.VideoWriter_fourcc(*'XVID')
out = cv2.VideoWriter('output.avi', fourcc, fps, (frame_width, frame_height))

print("Recording... Press 'q' to stop")

while cap.isOpened():
    ret, frame = cap.read()
    if not ret:
        print("Stopping—no more frames")
        break
    
    # Display preview
    cv2.imshow('Camera Feed', frame)
    
    # Write frame to video
    out.write(frame)
    
    # Exit on 'q' press
    if cv2.waitKey(1) & 0xFF == ord('q'):
        break

# Cleanup
out.release()
cap.release()
cv2.destroyAllWindows()
print("Recording saved as output.avi")

If none of these fixes work, try testing with a different video file format (e.g., .avi instead of .mp4) or updating your OpenCV version—older versions sometimes have camera compatibility bugs.

内容的提问来源于stack exchange，提问作者Muhammad Ammar Malik