DreamineVMS.Views.MainWindow 클래스 참조

더 자세히 ...

DreamineVMS.Views.MainWindow에 대한 상속 다이어그램 :

DreamineVMS.Views.MainWindow에 대한 협력 다이어그램:

Public 멤버 함수
	MainWindow (IOptions< VmsServerOptions > serverOptions)

Private 멤버 함수
void	OnDataContextChanged (object sender, DependencyPropertyChangedEventArgs e)
void	OnOpenLiveTabRequested (object? sender, EventArgs e)
async void	OnLoaded (object sender, RoutedEventArgs e)
void	OnClosed (object? sender, EventArgs e)
async void	OnMainTabSelectionChanged (object sender, System.Windows.Controls.SelectionChangedEventArgs e)
void	AgentPasswordBox_PasswordChanged (object sender, RoutedEventArgs e)
async Task	EnsureSelectedLiveWebViewAsync ()
async Task	EnsureWpfLiveWebViewAsync ()
async Task	EnsureCamerasWebViewAsync ()
string	GetLiveUrl ()
void	RegisterWebViewRecovery (WebView2 webView, Func< string > urlFactory)

정적 Private 멤버 함수
static void	TryNavigateWebView (WebView2 webView, string url)
static void	TryDisposeWebView (ref WebView2? webView)
static async Task	NavigateServerAsync (WebView2 webView, string url, int timeoutMs=15000, int intervalMs=500)

Private 속성
readonly VmsServerOptions	_serverOptions
MainWindowViewModel?	_attachedViewModel
WebView2?	_wpfLiveWebView
WebView2?	_camerasWebView
bool	_wpfLiveInitialized
bool	_camerasInitialized

상세한 설명

DreamineVMS 메인 윈도우입니다.

MainWindow.xaml.cs 파일의 27 번째 라인에서 정의되었습니다.

생성자 & 소멸자 문서화

MainWindow()

DreamineVMS.Views.MainWindow.MainWindow ( IOptions< VmsServerOptions > serverOptions )

inline

MainWindow 인스턴스를 초기화합니다.

매개변수

serverOptions

VMS 서버 옵션입니다.

예외

ArgumentNullException

필수 입력 인자 중 하나가 null인 경우 발생합니다.

MainWindow.xaml.cs 파일의 108 번째 라인에서 정의되었습니다.

    {
        _serverOptions = serverOptions?.Value ?? throw new ArgumentNullException(nameof(serverOptions));
        InitializeComponent();
 
        if (DesignerProperties.GetIsInDesignMode(this))
        {
            return;
        }
 
        DataContextChanged += OnDataContextChanged;
        Loaded += OnLoaded;
        Closed += OnClosed;
        MainTabControl.SelectionChanged += OnMainTabSelectionChanged;
    }

다음을 참조함 : _serverOptions, OnClosed(), OnDataContextChanged(), OnLoaded(), OnMainTabSelectionChanged().

이 함수 내부에서 호출하는 함수들에 대한 그래프입니다.:

멤버 함수 문서화

AgentPasswordBox_PasswordChanged()

void DreamineVMS.Views.MainWindow.AgentPasswordBox_PasswordChanged ( object sender, RoutedEventArgs e )

inlineprivate

Agent Password Box Password Changed 작업을 수행합니다.

매개변수

sender	이벤트를 발생시킨 객체입니다.
e	이벤트와 관련된 데이터를 포함합니다.

MainWindow.xaml.cs 파일의 348 번째 라인에서 정의되었습니다.

    {
        if (DataContext is MainWindowViewModel vm)
            vm.AgentSettings.Password = AgentPasswordBox.Password;
    }

EnsureCamerasWebViewAsync()

async Task DreamineVMS.Views.MainWindow.EnsureCamerasWebViewAsync ( )

inlineprivate

Ensure Cameras Web View Async 작업을 수행합니다.

반환값

Ensure Cameras Web View Async 작업에서 생성한 Task 결과입니다.

MainWindow.xaml.cs 파일의 433 번째 라인에서 정의되었습니다.

    {
        if (_camerasInitialized)
        {
            return;
        }
 
        WebView2 webView = HybridWebViewHost.CreateWebView();
        CamerasTab.Content = webView;
        _camerasWebView = webView;
 
        string camerasUrl = $"http://localhost:{_serverOptions.Port}/cameras";
        RegisterWebViewRecovery(webView, () => camerasUrl);
        await NavigateServerAsync(webView, camerasUrl).ConfigureAwait(true);
        _camerasInitialized = true;
    }

다음을 참조함 : _camerasInitialized, _camerasWebView, NavigateServerAsync(), RegisterWebViewRecovery().

다음에 의해서 참조됨 : EnsureSelectedLiveWebViewAsync().

이 함수 내부에서 호출하는 함수들에 대한 그래프입니다.:

이 함수를 호출하는 함수들에 대한 그래프입니다.:

EnsureSelectedLiveWebViewAsync()

async Task DreamineVMS.Views.MainWindow.EnsureSelectedLiveWebViewAsync ( )

inlineprivate

Ensure Selected Live Web View Async 작업을 수행합니다.

반환값

Ensure Selected Live Web View Async 작업에서 생성한 Task 결과입니다.

MainWindow.xaml.cs 파일의 370 번째 라인에서 정의되었습니다.

    {
        if (MainTabControl.SelectedItem == WpfLiveTab)
        {
            await EnsureWpfLiveWebViewAsync().ConfigureAwait(true);
            return;
        }
 
        if (MainTabControl.SelectedItem == CamerasTab)
        {
            await EnsureCamerasWebViewAsync().ConfigureAwait(true);
        }
    }

다음을 참조함 : EnsureCamerasWebViewAsync(), EnsureWpfLiveWebViewAsync().

다음에 의해서 참조됨 : OnLoaded(), OnMainTabSelectionChanged().

이 함수 내부에서 호출하는 함수들에 대한 그래프입니다.:

이 함수를 호출하는 함수들에 대한 그래프입니다.:

EnsureWpfLiveWebViewAsync()

async Task DreamineVMS.Views.MainWindow.EnsureWpfLiveWebViewAsync ( )

inlineprivate

Ensure Wpf Live Web View Async 작업을 수행합니다.

반환값

Ensure Wpf Live Web View Async 작업에서 생성한 Task 결과입니다.

MainWindow.xaml.cs 파일의 400 번째 라인에서 정의되었습니다.

    {
        if (_wpfLiveInitialized)
        {
            return;
        }
 
        WebView2 webView = HybridWebViewHost.CreateWebView();
        WpfLiveTab.Content = webView;
        _wpfLiveWebView = webView;
 
        string liveUrl = GetLiveUrl();
        RegisterWebViewRecovery(webView, () => liveUrl);
        await NavigateServerAsync(webView, liveUrl).ConfigureAwait(true);
        _wpfLiveInitialized = true;
    }

다음을 참조함 : _wpfLiveInitialized, _wpfLiveWebView, GetLiveUrl(), NavigateServerAsync(), RegisterWebViewRecovery().

다음에 의해서 참조됨 : EnsureSelectedLiveWebViewAsync().

이 함수 내부에서 호출하는 함수들에 대한 그래프입니다.:

이 함수를 호출하는 함수들에 대한 그래프입니다.:

GetLiveUrl()

string DreamineVMS.Views.MainWindow.GetLiveUrl ( )

inlineprivate

Live Url 값을 가져옵니다.

반환값

Get Live Url 작업에서 생성한 string 결과입니다.

MainWindow.xaml.cs 파일의 466 번째 라인에서 정의되었습니다.

    {
        return $"http://localhost:{_serverOptions.Port}/live";
    }

다음에 의해서 참조됨 : EnsureWpfLiveWebViewAsync().

이 함수를 호출하는 함수들에 대한 그래프입니다.:

NavigateServerAsync()

async Task DreamineVMS.Views.MainWindow.NavigateServerAsync ( WebView2 webView, string url, int timeoutMs = 15000, int intervalMs = 500 )

inlinestaticprivate

Navigate Server Async 작업을 수행합니다.

매개변수

webView	web View에 사용할 WebView2 값입니다.
url	url에 사용할 string 값입니다.
timeoutMs	timeout Ms에 사용할 int 값입니다.
intervalMs	interval Ms에 사용할 int 값입니다.

반환값

Navigate Server Async 작업에서 생성한 Task 결과입니다.

MainWindow.xaml.cs 파일의 652 번째 라인에서 정의되었습니다.

    {
        try
        {
            await Task.Delay(1500).ConfigureAwait(true);
 
            using CancellationTokenSource cts = new(timeoutMs);
            using HttpClient http = new();
            bool alive = false;
 
            while (!cts.IsCancellationRequested)
            {
                try
                {
                    HttpResponseMessage response = await http.GetAsync(url, cts.Token).ConfigureAwait(true);
                    if ((int)response.StatusCode >= 200 && (int)response.StatusCode < 400)
                    {
                        alive = true;
                        break;
                    }
                }
                catch (HttpRequestException)
                {
                    // Server may not be ready yet.
                }
                catch (TaskCanceledException)
                {
                    // Retry until overall timeout.
                }
 
                await Task.Delay(intervalMs, cts.Token).ConfigureAwait(true);
            }
 
            if (!alive)
            {
                Debug.WriteLine($"[DreamineVMS] Server dashboard timeout: {url}");
                await HybridWebViewHost.ShowOfflineMessageAsync(webView, url).ConfigureAwait(true);
                return;
            }
 
            webView.Source = new Uri(url);
        }
        catch (TaskCanceledException)
        {
            Debug.WriteLine("[DreamineVMS] Server navigation canceled.");
        }
        catch (Exception ex)
        {
            Debug.WriteLine($"[DreamineVMS] Server navigation failed: {ex}");
        }
    }

다음에 의해서 참조됨 : EnsureCamerasWebViewAsync(), EnsureWpfLiveWebViewAsync().

이 함수를 호출하는 함수들에 대한 그래프입니다.:

OnClosed()

void DreamineVMS.Views.MainWindow.OnClosed ( object? sender, EventArgs e )

inlineprivate

Closed 이벤트 또는 상태 변경을 처리합니다.

매개변수

sender	이벤트를 발생시킨 객체입니다.
e	이벤트와 관련된 데이터를 포함합니다.

MainWindow.xaml.cs 파일의 265 번째 라인에서 정의되었습니다.

    {
        if (_attachedViewModel is not null)
        {
            _attachedViewModel.OpenLiveTabRequested -= OnOpenLiveTabRequested;
            _attachedViewModel = null;
        }
 
        // WebView2 인스턴스를 명시적으로 정리합니다.
        // Dispose하지 않으면 Chromium 서브프로세스가 살아남아 앱 종료를 막을 수 있습니다.
        TryDisposeWebView(ref _wpfLiveWebView);
        TryDisposeWebView(ref _camerasWebView);
 
        // WPF Shutdown을 명시적으로 트리거합니다.
        // host.RunDreamineWpfApp의 구현에 따라 자동 종료가 안 될 수 있으므로 안전망입니다.
        Application.Current?.Shutdown();
    }

다음을 참조함 : _attachedViewModel, _camerasWebView, _wpfLiveWebView, OnOpenLiveTabRequested(), TryDisposeWebView().

다음에 의해서 참조됨 : MainWindow().

이 함수 내부에서 호출하는 함수들에 대한 그래프입니다.:

이 함수를 호출하는 함수들에 대한 그래프입니다.:

OnDataContextChanged()

void DreamineVMS.Views.MainWindow.OnDataContextChanged ( object sender, DependencyPropertyChangedEventArgs e )

inlineprivate

Data Context Changed 이벤트 또는 상태 변경을 처리합니다.

매개변수

sender	이벤트를 발생시킨 객체입니다.
e	이벤트와 관련된 데이터를 포함합니다.

MainWindow.xaml.cs 파일의 148 번째 라인에서 정의되었습니다.

    {
        if (_attachedViewModel is not null)
        {
            _attachedViewModel.OpenLiveTabRequested -= OnOpenLiveTabRequested;
            _attachedViewModel = null;
        }
 
        if (DataContext is MainWindowViewModel viewModel)
        {
            _attachedViewModel = viewModel;
            _attachedViewModel.OpenLiveTabRequested += OnOpenLiveTabRequested;
        }
    }

다음을 참조함 : _attachedViewModel, OnOpenLiveTabRequested().

다음에 의해서 참조됨 : MainWindow().

이 함수 내부에서 호출하는 함수들에 대한 그래프입니다.:

이 함수를 호출하는 함수들에 대한 그래프입니다.:

OnLoaded()

async void DreamineVMS.Views.MainWindow.OnLoaded ( object sender, RoutedEventArgs e )

inlineprivate

Loaded 이벤트 또는 상태 변경을 처리합니다.

매개변수

sender	이벤트를 발생시킨 객체입니다.
e	이벤트와 관련된 데이터를 포함합니다.

MainWindow.xaml.cs 파일의 223 번째 라인에서 정의되었습니다.

    {
        HybridHostControl embeddedDashboard = new()
        {
            HostPage = "wwwroot/index.html",
            Services = App.ServiceProvider,
            RootComponentType = typeof(VmsLocalDashboard),
            RootSelector = "#app"
        };
 
        EmbeddedDashboardTab.Content = embeddedDashboard;
 
        // Live WebView는 동시에 두 개를 바로 띄우지 않습니다.
        // 두 Live 탭이 동시에 /live에 접속하면 Blazor Circuit과 hls.js player가 중복 생성되어
        // StopAll → StartAll 이후 source/session 동기화가 꼬일 수 있습니다.
        await EnsureSelectedLiveWebViewAsync().ConfigureAwait(true);
    }

다음을 참조함 : EnsureSelectedLiveWebViewAsync(), DreamineVMS.App.ServiceProvider.

다음에 의해서 참조됨 : MainWindow().

이 함수 내부에서 호출하는 함수들에 대한 그래프입니다.:

이 함수를 호출하는 함수들에 대한 그래프입니다.:

OnMainTabSelectionChanged()

async void DreamineVMS.Views.MainWindow.OnMainTabSelectionChanged ( object sender, System.Windows.Controls.SelectionChangedEventArgs e )

inlineprivate

Main Tab Selection Changed 이벤트 또는 상태 변경을 처리합니다.

매개변수

sender	이벤트를 발생시킨 객체입니다.
e	이벤트와 관련된 데이터를 포함합니다.

MainWindow.xaml.cs 파일의 307 번째 라인에서 정의되었습니다.

    {
        if (!IsLoaded) return;
 
        // 에이전트 설정 탭이 처음 열릴 때 PasswordBox에 저장된 비밀번호를 채워줍니다.
        // PasswordBox.Password는 DependencyProperty가 아니라 직접 바인딩이 불가능합니다.
        if (AgentPasswordBox is not null
            && DataContext is MainWindowViewModel vm
            && string.IsNullOrEmpty(AgentPasswordBox.Password)
            && !string.IsNullOrEmpty(vm.AgentSettings.Password))
        {
            AgentPasswordBox.Password = vm.AgentSettings.Password;
        }
 
        await EnsureSelectedLiveWebViewAsync().ConfigureAwait(true);
    }

다음을 참조함 : EnsureSelectedLiveWebViewAsync().

다음에 의해서 참조됨 : MainWindow().

이 함수 내부에서 호출하는 함수들에 대한 그래프입니다.:

이 함수를 호출하는 함수들에 대한 그래프입니다.:

OnOpenLiveTabRequested()

void DreamineVMS.Views.MainWindow.OnOpenLiveTabRequested ( object? sender, EventArgs e )

inlineprivate

Open Live Tab Requested 이벤트 또는 상태 변경을 처리합니다.

매개변수

sender	이벤트를 발생시킨 객체입니다.
e	이벤트와 관련된 데이터를 포함합니다.

MainWindow.xaml.cs 파일의 187 번째 라인에서 정의되었습니다.

    {
        // 레거시 메시지 호환용입니다. Blazor Server의 첫 화면은 Live View이며, 탭 전환은 수행하지 않습니다.
        Dispatcher.Invoke(() =>
        {
            if (!IsActive)
            {
                Activate();
            }
        });
    }

다음에 의해서 참조됨 : OnClosed(), OnDataContextChanged().

이 함수를 호출하는 함수들에 대한 그래프입니다.:

RegisterWebViewRecovery()

void DreamineVMS.Views.MainWindow.RegisterWebViewRecovery ( WebView2 webView, Func< string > urlFactory )

inlineprivate

Register Web View Recovery 작업을 수행합니다.

매개변수

webView	web View에 사용할 WebView2 값입니다.
urlFactory	url Factory에 사용할 Func<string> 값입니다.

MainWindow.xaml.cs 파일의 495 번째 라인에서 정의되었습니다.

    {
        webView.CoreWebView2InitializationCompleted += (_, e) =>
        {
            if (!e.IsSuccess || webView.CoreWebView2 is null)
            {
                Debug.WriteLine($"[DreamineVMS] WebView2 initialization failed: {e.InitializationException}");
                return;
            }
 
            webView.CoreWebView2.ProcessFailed += async (_, args) =>
            {
                Debug.WriteLine($"[DreamineVMS] WebView2 process failed: {args.ProcessFailedKind}. Reloading...");
 
                await Dispatcher.InvokeAsync(async () =>
                {
                    await Task.Delay(1000).ConfigureAwait(true);
                    TryNavigateWebView(webView, urlFactory());
                });
            };
        };
 
        webView.NavigationCompleted += (_, e) =>
        {
            if (e.IsSuccess)
            {
                return;
            }
 
            Debug.WriteLine($"[DreamineVMS] WebView2 navigation failed: {e.WebErrorStatus}. Reloading...");
            Dispatcher.InvokeAsync(async () =>
            {
                await Task.Delay(1500).ConfigureAwait(true);
                TryNavigateWebView(webView, urlFactory());
            });
        };
    }

다음을 참조함 : TryNavigateWebView().

다음에 의해서 참조됨 : EnsureCamerasWebViewAsync(), EnsureWpfLiveWebViewAsync().

이 함수 내부에서 호출하는 함수들에 대한 그래프입니다.:

이 함수를 호출하는 함수들에 대한 그래프입니다.:

TryDisposeWebView()

void DreamineVMS.Views.MainWindow.TryDisposeWebView ( ref WebView2? webView )

inlinestaticprivate

Dispose Web View 작업을 시도하고 성공 여부를 반환합니다.

매개변수

webView

web View에 사용할 WebView2? 값입니다.

MainWindow.xaml.cs 파일의 585 번째 라인에서 정의되었습니다.

    {
        if (webView is null)
        {
            return;
        }
 
        try
        {
            webView.Dispose();
        }
        catch (Exception ex)
        {
            Debug.WriteLine($"[DreamineVMS] WebView2 dispose failed: {ex}");
        }
 
        webView = null;
    }

다음에 의해서 참조됨 : OnClosed().

이 함수를 호출하는 함수들에 대한 그래프입니다.:

TryNavigateWebView()

void DreamineVMS.Views.MainWindow.TryNavigateWebView ( WebView2 webView, string url )

inlinestaticprivate

Navigate Web View 작업을 시도하고 성공 여부를 반환합니다.

매개변수

webView	web View에 사용할 WebView2 값입니다.
url	url에 사용할 string 값입니다.

MainWindow.xaml.cs 파일의 557 번째 라인에서 정의되었습니다.

    {
        try
        {
            webView.Source = new Uri(url);
        }
        catch (Exception ex)
        {
            Debug.WriteLine($"[DreamineVMS] WebView2 recovery navigation failed: {ex}");
        }
    }

다음에 의해서 참조됨 : RegisterWebViewRecovery().

이 함수를 호출하는 함수들에 대한 그래프입니다.:

멤버 데이터 문서화

_attachedViewModel

MainWindowViewModel? DreamineVMS.Views.MainWindow._attachedViewModel

private

attached View Model 값을 보관합니다.

MainWindow.xaml.cs 파일의 46 번째 라인에서 정의되었습니다.

다음에 의해서 참조됨 : OnClosed(), OnDataContextChanged().

_camerasInitialized

bool DreamineVMS.Views.MainWindow._camerasInitialized

private

cameras Initialized 값을 보관합니다.

MainWindow.xaml.cs 파일의 82 번째 라인에서 정의되었습니다.

다음에 의해서 참조됨 : EnsureCamerasWebViewAsync().

_camerasWebView

WebView2? DreamineVMS.Views.MainWindow._camerasWebView

private

cameras Web View 값을 보관합니다.

MainWindow.xaml.cs 파일의 64 번째 라인에서 정의되었습니다.

다음에 의해서 참조됨 : EnsureCamerasWebViewAsync(), OnClosed().

_serverOptions

readonly VmsServerOptions DreamineVMS.Views.MainWindow._serverOptions

private

server Options 값을 보관합니다.

MainWindow.xaml.cs 파일의 37 번째 라인에서 정의되었습니다.

다음에 의해서 참조됨 : MainWindow().

_wpfLiveInitialized

bool DreamineVMS.Views.MainWindow._wpfLiveInitialized

private

wpf Live Initialized 값을 보관합니다.

MainWindow.xaml.cs 파일의 73 번째 라인에서 정의되었습니다.

다음에 의해서 참조됨 : EnsureWpfLiveWebViewAsync().

_wpfLiveWebView

WebView2? DreamineVMS.Views.MainWindow._wpfLiveWebView

private

wpf Live Web View 값을 보관합니다.

MainWindow.xaml.cs 파일의 55 번째 라인에서 정의되었습니다.

다음에 의해서 참조됨 : EnsureWpfLiveWebViewAsync(), OnClosed().

---

이 클래스에 대한 문서화 페이지는 다음의 파일로부터 생성되었습니다.:

• MainWindow.xaml.cs