Version: 2023.1

PhotoCapture

class in UnityEngine.Windows.WebCam

切换到手册

描述

捕捉来自网络摄像机的照片并存储在内存中或磁盘上。

演示如何使用 PhotoCapture 功能拍摄照片并将照片显示在 Unity 游戏对象上。

using UnityEngine;
using System.Collections;
using System.Linq;
using UnityEngine.Windows.WebCam;

public class PhotoCaptureExample : MonoBehaviour { PhotoCapture photoCaptureObject = null; Texture2D targetTexture = null;

// Use this for initialization void Start() { Resolution cameraResolution = PhotoCapture.SupportedResolutions.OrderByDescending((res) => res.width * res.height).First(); targetTexture = new Texture2D(cameraResolution.width, cameraResolution.height);

// Create a PhotoCapture object PhotoCapture.CreateAsync(false, delegate(PhotoCapture captureObject) { photoCaptureObject = captureObject; CameraParameters cameraParameters = new CameraParameters(); cameraParameters.hologramOpacity = 0.0f; cameraParameters.cameraResolutionWidth = cameraResolution.width; cameraParameters.cameraResolutionHeight = cameraResolution.height; cameraParameters.pixelFormat = CapturePixelFormat.BGRA32;

// Activate the camera photoCaptureObject.StartPhotoModeAsync(cameraParameters, delegate(PhotoCapture.PhotoCaptureResult result) { // Take a picture photoCaptureObject.TakePhotoAsync(OnCapturedPhotoToMemory); }); }); }

void OnCapturedPhotoToMemory(PhotoCapture.PhotoCaptureResult result, PhotoCaptureFrame photoCaptureFrame) { // Copy the raw image data into our target texture photoCaptureFrame.UploadImageDataToTexture(targetTexture);

// Create a gameobject that we can apply our texture to GameObject quad = GameObject.CreatePrimitive(PrimitiveType.Quad); Renderer quadRenderer = quad.GetComponent<Renderer>() as Renderer; quadRenderer.material = new Material(Shader.Find("Unlit/Texture"));

quad.transform.parent = this.transform; quad.transform.localPosition = new Vector3(0.0f, 0.0f, 3.0f);

quadRenderer.material.SetTexture("_MainTex", targetTexture);

// Deactivate our camera photoCaptureObject.StopPhotoModeAsync(OnStoppedPhotoMode); }

void OnStoppedPhotoMode(PhotoCapture.PhotoCaptureResult result) { // Shutdown our photo capture resource photoCaptureObject.Dispose(); photoCaptureObject = null; } }

静态变量

SupportedResolutions用于拍摄照片的所有受支持的设备分辨率列表。

公共函数

Dispose必须调用 Dispose 来关闭 PhotoCapture 实例。
GetUnsafePointerToVideoDeviceController为原生 IVideoDeviceController 提供 COM 指针。
StartPhotoModeAsync异步启动照片模式。
StopPhotoModeAsync异步停止照片模式。
TakePhotoAsync使用网络摄像机异步捕捉照片并将照片存储在磁盘上。

静态函数

CreateAsync异步创建可用于捕捉照片的 PhotoCapture 对象的实例。

委托

OnCapturedToDiskCallback在照片被保存到文件系统时调用。
OnCapturedToMemoryCallback在照片被捕捉到内存中时调用。
OnCaptureResourceCreatedCallback在创建 PhotoCapture 资源时调用。
OnPhotoModeStartedCallback在照片模式启动时调用。
OnPhotoModeStoppedCallback在照片模式停止时调用。