공교육 멀티미디어 교안 시연과 영상 싱크 0초 동기화: ZeliPlay의 온디바이스 하드웨어 가속 미디어 파이프라인 및 수업 전용 창 오케스트레이션 아키텍처

public ZeliPlayWindow()
{
    this.InitializeComponent();

    // 윈도우 핸들 추출 및 AppWindow 획득
    IntPtr hWnd = WinRT.Interop.WindowNative.GetWindowHandle(this);
    Microsoft.UI.WindowId windowId = Microsoft.UI.Win32Interop.GetWindowIdFromWindow(hWnd);
    _appWindow = Microsoft.UI.Windowing.AppWindow.GetFromWindowId(windowId);

    // 공교육 교실 최적화 1100x700 지오메트리 복원
    ZeliDesk.Core.WindowStateManager.RestoreWindowState(this, _appWindow, "ZeliPlay", 1100, 700);

    ExtendsContentIntoTitleBar = true;
    SetTitleBar(AppTitleBar);

    // 기본 AlwaysOnTop 활성화 (수업용 PIP 브리핑 지원)
    if (AppWindow?.Presenter is OverlappedPresenter op) op.IsAlwaysOnTop = true;

    // 순정 네이티브 미디어 플레이어 엔진 결합
    _mediaPlayer = new MediaPlayer();
    _mediaPlayer.MediaEnded += MediaPlayer_MediaEnded;
    _mediaPlayer.MediaFailed += MediaPlayer_MediaFailed; // 예외 크래시 방어 델리게이트
    MediaPlayer.SetMediaPlayer(_mediaPlayer);

    PlaylistView.ItemsSource = Playlist;
}

private void MediaPlayer_MediaFailed(MediaPlayer sender, MediaPlayerFailedEventArgs args)
{
    // 백그라운드 미디어 실패 이벤트를 UI 스레드로 안전 마샬링
    DispatcherQueue.TryEnqueue(async () =>
    {
        var current = Playlist.FirstOrDefault(x => x.IsPlaying);
        if (current != null)
        {
            current.IsPlaying = false;
            current.UpdatePlayState(); // 인디케이터 즉시 리셋
        }

        // 드롭 가이드 힌트 복구로 빈 화면 프리징 방지
        DropHint.Visibility = Visibility.Visible;

        try
        {
            var dlg = new ContentDialog
            {
                Title = ZeliDesk.Services.Loc.Get("Common_Error"),
                Content = args.ErrorMessage,
                CloseButtonText = ZeliDesk.Services.Loc.Get("Common_Close"),
                XamlRoot = this.Content.XamlRoot
            };
            await dlg.ShowAsync();
        }
        catch { /* 다이얼로그 예외 무음 격리 */ }
    });
}

private void Window_Closed(object sender, WindowEventArgs args)
{
    // 오디오 장치 점유 락 및 GPU 버퍼 누수 원천 차단
    if (_mediaPlayer != null)
    {
        try { _mediaPlayer.Pause(); } catch { }
        try { _mediaPlayer.Source = null; } catch { }
        try { _mediaPlayer.Dispose(); } catch { } // COM 네이티브 메모리 즉시 릴리즈
    }
}

// 1. 탐색기 드롭 이벤트 수신 및 ObservableCollection 적재
private async void Player_Drop(object sender, DragEventArgs e)
{
    if (e.DataView.Contains(StandardDataFormats.StorageItems))
    {
        var items = await e.DataView.GetStorageItemsAsync();
        bool anyAdded = false;

        foreach (var item in items)
        {
            if (item is StorageFile file)
            {
                var mediaItem = new MediaItem
                {
                    FileName = file.Name,
                    FilePath = file.Path,
                    StorageFile = file,
                    IsPlaying = false
                };
                Playlist.Add(mediaItem);
                anyAdded = true;
            }
        }

        // 최초 파일 적재 시 지체 없는 0초 즉시 재생 트리거
        if (anyAdded && Playlist.Count > 0 && _mediaPlayer.Source == null)
        {
            var firstItem = Playlist.FirstOrDefault();
            if (firstItem != null) PlayMedia(firstItem);
        }
    }
}

// 2. 한 곡 종료 시 다음 트랙으로 끊김 없는(Gapless) 자동 전이
private void MediaPlayer_MediaEnded(MediaPlayer sender, object args)
{
    DispatcherQueue.TryEnqueue(() =>
    {
        var current = Playlist.FirstOrDefault(x => x.IsPlaying);
        if (current != null)
        {
            int index = Playlist.IndexOf(current);
            if (index >= 0 && index < Playlist.Count - 1)
            {
                PlaylistView.SelectedItem = Playlist[index + 1];
            }
        }
    });
}

private void BtnPin_Click(object sender, RoutedEventArgs e)
{
    if (AppWindow?.Presenter is not OverlappedPresenter presenter) return;

    _isPinned = !_isPinned;
    presenter.IsAlwaysOnTop = _isPinned; // 최상위 윈도우 Z-Order 강제 제어

    // 교사를 위한 시각적 상태 피드백
    TxtPin.Opacity = _isPinned ? 1.0 : 0.5;
    PinBg.Color = _isPinned
        ? Windows.UI.Color.FromArgb(0x35, 0x0E, 0xA7, 0x6C)
        : Windows.UI.Color.FromArgb(0x15, 0xFF, 0xFF, 0xFF);
    PinBorder.Color = _isPinned
        ? Windows.UI.Color.FromArgb(0x55, 0x0E, 0xA7, 0x6C)
        : Windows.UI.Color.FromArgb(0x20, 0xFF, 0xFF, 0xFF);
}