class: Capture

[9:21] static (extern: com.aussom.aussomscript.ACapture) extends: object

The static 'Capture' class provides access to browser media capture APIs. It wraps getUserMedia for camera and microphone access, MediaRecorder for recording audio and video, and a canvas-based photo capture helper. All capture operations require a secure context (HTTPS or localhost). Calling any method on a plain file:// URL will result in an error.

Methods

• getUserMedia (bool Audio, bool Video, callback OnStream, callback OnError = null)

  Requests camera and/or microphone access from the user. On success the OnStream callback receives a stream object. On failure OnError receives a string with the error message. The returned stream object is opaque; pass it to attachStream(), startRecording(), or stopStream().

  • @p Audio is a bool, true to include the microphone.
  • @p Video is a bool, true to include the camera.
  • @p OnStream is a callback(stream) called on success.
  • @p OnError is an optional callback(errorMsg) called on failure.
  • @r null

• attachStream (object Stream, object VideoEl)

  Attaches a MediaStream to a Video element for live preview. Call this with the stream received from getUserMedia and a Video object. The Video element will immediately show the camera feed.

  • @p Stream is the stream object from getUserMedia.
  • @p VideoEl is a Video object to display the stream.
  • @r null

• stopStream (object Stream)

  Stops all tracks in a MediaStream, releasing the camera or microphone.

  • @p Stream is the stream object from getUserMedia.
  • @r null

• startRecording (object Stream, callback OnData, callback OnError = null, string MimeType = null)

  Starts recording a MediaStream. Call stopRecording() when done. When recording stops, OnData is called with a buffer containing the encoded audio/video bytes. Errors are reported to OnError. Only one recording session can be active at a time.

  • @p Stream is the stream object from getUserMedia.
  • @p OnData is a callback(buffer) called with the recorded bytes.
  • @p OnError is an optional callback(errorMsg) called on failure.
  • @p MimeType is an optional MIME type hint, e.g. "audio/webm". Leave null to let the browser choose.
  • @r null

• stopRecording ()

  Stops the current recording session. The OnData callback registered with startRecording() is called asynchronously with the recorded data. Returns an exception if no recording is in progress.

  • @r null

• capturePhoto (object VideoEl, int Width = 0, int Height = 0)

  Captures a single photo from a live Video element. Draws the current video frame to a hidden canvas and returns the raw RGBA pixel data as a buffer. The buffer has Width * Height * 4 bytes (R, G, B, A per pixel). Returns an exception if the video has no frame yet (stream not active).

  • @p VideoEl is a Video object displaying a live camera stream.
  • @p Width is the output width in pixels. 0 uses the video natural size.
  • @p Height is the output height in pixels. 0 uses the video natural size.
  • @r A buffer with raw RGBA pixel data.

• encodeBuffer (object Buf, int Width, int Height, string MimeType)

  Encodes raw RGBA pixel data (from capturePhoto or Context2D.getImageData) as an image data URL. Use the returned string to set an Img.setSrc() or trigger a download.

  • @p Buf is a buffer with raw RGBA data (Width * Height * 4 bytes).
  • @p Width is the image width in pixels.
  • @p Height is the image height in pixels.
  • @p MimeType is "image/jpeg" or "image/png".
  • @r A string with the data URL.