카메라 프로필을 사용하여 카메라 기능 검색 및 선택

  • 아티클

이 문서에서는 카메라 프로필을 사용하여 여러 다양한 비디오 캡처 디바이스의 기능을 검색 및 관리하는 방법을 설명합니다. 특정 해상도 또는 프레임 속도를 지원하는 프로필, 여러 카메라에 대한 동시 액세스를 지원하는 프로필, HDR을 지원하는 프로필 선택 등의 작업이 포함됩니다.

참고 항목

이 문서는 기본 사진 및 비디오 캡처 구현 단계를 설명하는 MediaCapture를 사용한 기본적인 사진, 비디오 및 오디오 캡처에 설명된 개념 및 코드를 토대로 작성되었습니다. 좀 더 수준 높은 캡처 시나리오를 진행하기 전에 해당 문서의 기본 미디어 캡처 패턴을 좀 더 잘 이해하는 것이 좋습니다. 이 문서의 코드는 앱에 적절히 초기화된 MediaCapture의 인스턴스가 이미 있다고 가정합니다.

 

카메라 프로필 정보

여러 다른 디바이스의 카메라는 지원되는 캡처 해상도 집합, 비디오 캡처의 프레임 속도, HDR 또는 가변 프레임 속도 캡처 지원 여부를 비롯한 여러 다른 기능을 지원합니다. UWP(유니버설 Windows 플랫폼) 미디어 캡처 프레임워크는 MediaCaptureVideoProfileMediaDescription에 이러한 기능 집합을 저장합니다. MediaCaptureVideoProfile 개체로 나타내는 카메라 프로필은 사진 캡처용 1개, 비디오 캡처용 1개, 비디오 미리 보기용 1개로 이루어진 3개의 미디어 설명 컬렉션을 포함합니다.

MediaCapture 개체를 초기화하기 전에 현재 디바이스의 캡처 디바이스를 쿼리하여 지원되는 프로필을 확인할 수 있습니다. 지원되는 프로필을 선택하면 캡처 디바이스가 프로필 미디어 설명의 모든 기능을 지원하는지 알 수 있습니다. 이렇게 하면 특정 디바이스에서 지원되는 기능 조합을 파악하기 위해 시행착오를 거칠 필요가 없습니다.

var mediaInitSettings = new MediaCaptureInitializationSettings { VideoDeviceId = cameraDevice.Id };

이 문서의 코드 예제에서는 이러한 최소한의 초기화를 다양한 기능을 지원하는 카메라 프로필 검색으로 바꿉니다. 그런 후 이러한 검색 기능을 사용하여 미디어 캡처 디바이스를 초기화할 수 있습니다.

카메라 프로필을 지원하는 비디오 디바이스 찾기

지원되는 카메라 프로필을 검색하기 전에 카메라 프로필의 사용을 지원하는 캡처 디바이스를 찾아야 합니다. 아래 예제에 정의된 GetVideoProfileSupportedDeviceIdAsync 도우미 메서드는 DeviceInformaion.FindAllAsync 메서드를 사용하여 사용 가능한 모든 비디오 캡처 디바이스 목록을 검색합니다. 목록의 모든 디바이스를 루핑하고 각 디바이스에 대해 정적 메서드인 IsVideoProfileSupported를 호출하여 비디오 프로필을 지원하는지 여부를 확인합니다. 또한 각 디바이스에 대한 EnclosureLocation.Panel 속성을 통해 카메라를 디바이스 전방 또는 후방 중 어디에 둘지를 지정할 수 있습니다.

카메라 프로필을 지원하는 디바이스가 지정된 패널에 있는 경우 디바이스의 ID 문자열이 포함된 Id 값이 반환됩니다.

public async Task<string> GetVideoProfileSupportedDeviceIdAsync(Windows.Devices.Enumeration.Panel panel)
{
    string deviceId = string.Empty;

    // Finds all video capture devices
    DeviceInformationCollection devices = await DeviceInformation.FindAllAsync(DeviceClass.VideoCapture);
    
    foreach (var device in devices)
    {
        // Check if the device on the requested panel supports Video Profile
        if (MediaCapture.IsVideoProfileSupported(device.Id) && device.EnclosureLocation.Panel == panel)
        {
            // We've located a device that supports Video Profiles on expected panel
            deviceId = device.Id;
            break;
        }
    }

    return deviceId;
}

GetVideoProfileSupportedDeviceIdAsync 도우미 메서드에서 반환된 디바이스 ID가 null 또는 빈 문자열이면 지정된 패널에 카메라 프로필을 지원하는 디바이스가 없는 것입니다. 이 경우 프로필을 사용하지 않고 미디어 캡처 디바이스를 초기화해야 합니다.

string videoDeviceId = await GetVideoProfileSupportedDeviceIdAsync(Windows.Devices.Enumeration.Panel.Back);

if (string.IsNullOrEmpty(videoDeviceId))
{
    // No devices on the specified panel support video profiles. .
    return;
}

지원되는 해상도 및 프레임 속도에 따라 프로필 선택

특정 해상도 및 프레임 속도에 도달하는 기능을 비롯한 특정 기능을 갖는 프로필을 선택하려면 먼저 위에 정의된 도우미 메서드를 호출하여 카메라 프로필 사용을 지원하는 캡처 디바이스의 ID를 가져옵니다.

새 MediaCaptureInitializationSettings 개체를 만들고 선택한 디바이스 ID를 제공합니다. 다음으로, 정적 메서드 MediaCapture.FindAllVideoProfiles를 호출하여 디바이스에서 지원하는 모든 카메라 프로필 목록을 가져옵니다.

이 예제에서는 using System.Linq 네임스페이스에 포함된 Linq 쿼리 메서드를 사용하여 Width와 Height 및 FrameRate 속성이 요청된 값과 일치하는 SupportedRecordMediaDescription 개체가 포함된 프로필을 선택합니다. 일치하는 개체가 있으면 MediaCaptureInitializationSettings의 VideoProfile 및 RecordMediaDescription이 Linq 쿼리에서 반환된 무명 형식의 값으로 설정됩니다. 일치하는 개체가 없으면 기본 프로필이 사용됩니다.


var mediaInitSettings = new MediaCaptureInitializationSettings { VideoDeviceId = videoDeviceId };

IReadOnlyList<MediaCaptureVideoProfile> profiles = MediaCapture.FindAllVideoProfiles(videoDeviceId);

var match = (from profile in profiles
             from desc in profile.SupportedRecordMediaDescription
             where desc.Width == 640 && desc.Height == 480 && Math.Round(desc.FrameRate) == 30
             select new { profile, desc }).FirstOrDefault();

if (match != null)
{
    mediaInitSettings.VideoProfile = match.profile;
    mediaInitSettings.RecordMediaDescription = match.desc;
}
else
{
    // Could not locate a WVGA 30FPS profile, use default video recording profile
    mediaInitSettings.VideoProfile = profiles[0];
}

원하는 카메라 프로필로 MediaCaptureInitializationSettings를 채운 후에는 미디어 캡처 개체에 대해 InitializeAsync를 호출하여 원하는 프로필로 구성하면 됩니다.

await _mediaCapture.InitializeAsync(mediaInitSettings);

미디어 프레임 소스 그룹을 사용하여 프로필 가져오기

Windows 10, 버전 1803부터 MediaFrameSourceGroup 클래스를 사용하여 MediaCapture 개체를 초기화하기 전에 특정 기능으로 카메라 프로필을 가져올 수 있습니다. 디바이스 제조업체는 프레임 소스 그룹을 사용하여 센서 그룹을 나타내거나 기능을 단일 가상 디바이스로 캡처할 수 있습니다. 따라서 깊이와 컬러 카메라를 함께 사용하는 것과 같이 전산 사진 기법을 사용할 수 있지만 단순 캡처 시나리오를 위한 카메라 프로필을 선택하는 데에도 사용할 수 있습니다. MediaFrameSourceGroup 사용에 대한 자세한 내용은 MediaFrameReader를 사용하여 미디어 프레임 처리를 참조하세요.

아래의 예제 메서드는 MediaFrameSourceGroup 개체를 사용하여 HDR 또는 가변 사진 시퀀스를 지원하는 것과 같이 알려진 비디오 프로필을 지원하는 카메라 프로필을 찾는 방법을 보여 줍니다. 먼저, MediaFrameSourceGroup.FindAllAsync를 호출하여 현재 디바이스에서 사용할 수 있는 전체 미디어 프레임 소스 그룹 목록을 가져옵니다. 각 소스 그룹을 반복 실행하고 MediaCapture.FindKnownVideoProfiles를 호출하여 지정된 프로필을 지원하는 현재 소스 그룹에 대한 모든 비디오 프로필 목록을 가져옵니다(이 경우는 WCG 사진이 있는 HDR). 기준을 충족하는 프로필이 발견되면 새로운 MediaCaptureInitializationSettings 개체를 만들고 VideoProfile을 프로필 선택으로 설정하고 VideoDeviceId를 현재 미디어 프레임 소스 그룹의 Id 속성으로 설정합니다. 따라서 값 KnownVideoProfile.HdrWithWcgVideo를 이 메서드로 전달하여 HDR 비디오를 지원하는 미디어 캡처 설정을 가져올 수도 있습니다. KnownVideoProfile.VariablePhotoSequence를 전달하여 가변 사진 시퀀스를 지원하는 설정을 가져올 수 있습니다.

private async Task<MediaCaptureInitializationSettings> GetKnownVideoProfile(KnownVideoProfile knownVideoProfile)
{
    IReadOnlyList<MediaFrameSourceGroup> sourceGroups = await MediaFrameSourceGroup.FindAllAsync();
    MediaCaptureInitializationSettings settings = null;

    foreach (MediaFrameSourceGroup sg in sourceGroups)
    {
        // Find a device that support VariablePhotoSequence
        IReadOnlyList<MediaCaptureVideoProfile> profileList = MediaCapture.FindKnownVideoProfiles(
                                      sg.Id,
                                      knownVideoProfile); // e.g. KnownVideoProfile.HdrWithWcgVideo

        if (profileList.Count > 0)
        {
            settings = new MediaCaptureInitializationSettings();
            settings.VideoProfile = profileList[0];
            settings.VideoDeviceId = sg.Id;
            break;
        }
    }
    return settings;

    
}

알려진 프로필을 사용하여 HDR 동영상을 지원하는 프로필 찾기(레거시 기법)

참고 항목

이 섹션에 설명된 API는 Windows 10, 버전 1803부터 사용되지 않습니다. 이전 섹션 미디어 프레임 소스 그룹을 사용하여 프로필 가져오기를 참조하세요.

HDR을 지원하는 프로필을 선택하는 작업은 다른 시나리오의 경우처럼 시작됩니다. MediaCaptureInitializationSettings 및 캡처 디바이스 ID를 보유하는 문자열을 만듭니다. HDR 동영상 지원 여부를 추적하는 부울 변수를 추가합니다.

MediaCaptureInitializationSettings mediaInitSettings = new MediaCaptureInitializationSettings();
string videoDeviceId = string.Empty;
bool HdrVideoSupported = false;

위에 정의된 GetVideoProfileSupportedDeviceIdAsync 도우미 메서드를 사용하여 카메라 프로필을 지원하는 캡처 디바이스의 디바이스 ID를 가져옵니다.

// Select the first video capture device found on the back of the device
videoDeviceId = await GetVideoProfileSupportedDeviceIdAsync(Windows.Devices.Enumeration.Panel.Back);

if (string.IsNullOrEmpty(videoDeviceId))
{
    // No devices on the specified panel support video profiles. .
    return;
}

정적 메서드 MediaCapture.FindKnownVideoProfiles는 지정된 디바이스에서 지원되는 카메라 프로필을 지정된 KnownVideoProfile 값에 따라 분류해서 반환합니다. 이 시나리오에서 VideoRecording 값은 반환되는 카메라 프로필을 비디오 녹화를 지원하는 것으로 제한하기 위해 지정됩니다.

반환된 카메라 프로필 목록 전체를 루핑합니다. 각 카메라 프로필에 대해 IsHdrVideoSupported 속성이 true인지를 확인하기 위해 프로필의 각 VideoProfileMediaDescription 전체를 루핑합니다. 적합한 미디어 설명을 찾은 후 루프를 중단하고 프로필 및 설명 개체를 MediaCaptureInitializationSettings 개체에 할당합니다.

IReadOnlyList<MediaCaptureVideoProfile> profiles =
    MediaCapture.FindKnownVideoProfiles(videoDeviceId, KnownVideoProfile.VideoRecording);

// Walk through available profiles, look for first profile with HDR supported Video Profile
foreach (MediaCaptureVideoProfile profile in profiles)
{
    IReadOnlyList<MediaCaptureVideoProfileMediaDescription> recordMediaDescription =
        profile.SupportedRecordMediaDescription;
    foreach (MediaCaptureVideoProfileMediaDescription videoProfileMediaDescription in recordMediaDescription)
    {
        if (videoProfileMediaDescription.IsHdrVideoSupported)
        {
            // We've located the profile and description for HDR Video, set profile and flag
            mediaInitSettings.VideoProfile = profile;
            mediaInitSettings.RecordMediaDescription = videoProfileMediaDescription;
            HdrVideoSupported = true;
            break;
        }
    }

    if (HdrVideoSupported)
    {
        // Profile with HDR support found. Stop looking.
        break;
    }
}

디바이스가 동시 사진 및 비디오 캡처를 지원하는지 확인

많은 디바이스는 사진 및 비디오의 동시 캡처를 지원합니다. 캡처 디바이스가 이러한 기능을 지원하는지 확인하려면 MediaCapture.FindAllVideoProfiles를 호출하여 디바이스에서 지원되는 모든 카메라 프로필을 가져옵니다. 링크 쿼리를 사용하여 SupportedPhotoMediaDescription 및 SupportedRecordMediaDescription 둘 다에 대해 하나 이상의 항목을 갖는 프로필을 찾습니다. 이러한 프로필이 동시 캡처를 지원하는 것입니다.

var simultaneousPhotoAndVideoSupported = false;

IReadOnlyList<MediaCaptureVideoProfile> profiles = MediaCapture.FindAllVideoProfiles(videoDeviceId);

var match = (from profile in profiles
             where profile.SupportedPhotoMediaDescription.Any() &&
             profile.SupportedRecordMediaDescription.Any()
             select profile).FirstOrDefault();

if (match != null)
{
    // Simultaneous photo and video supported
    simultaneousPhotoAndVideoSupported = true;
}
else
{
    // Simultaneous photo and video not supported
    simultaneousPhotoAndVideoSupported = false;
}

이 쿼리를 구체화하여 동시 비디오 녹화 외의 기타 기능이나 특정 해상도를 지원하는 프로필을 찾을 수 있습니다. MediaCapture.FindKnownVideoProfiles를 사용하고 BalancedVideoAndPhoto 값을 지정하여 동시 캡처를 지원하는 프로필을 검색할 수도 있지만 모든 프로필을 쿼리하면 더 완전한 결과가 제공됩니다.