DreamineVMS.Blazor.ViewModels.LivePageViewModel 클래스 참조

더 자세히 ...

DreamineVMS.Blazor.ViewModels.LivePageViewModel에 대한 상속 다이어그램 :

DreamineVMS.Blazor.ViewModels.LivePageViewModel에 대한 협력 다이어그램:

Public 멤버 함수
	LivePageViewModel (IVmsCameraRepository repository, ICameraRuntimeStateService runtimeState, IJSRuntime jsRuntime)
void	Initialize ()
async Task	OnAfterRenderAsync (bool firstRender)
async Task	SynchronizePlayersAsync ()
async ValueTask	DisposeAsync ()

정적 Public 멤버 함수
static string	GetPlayerId (CameraDevice camera)

속성
IReadOnlyList< CameraDevice >	Cameras = Array.Empty<CameraDevice>() [get, private set]

이벤트
EventHandler?	PlayersNeedSync

Private 멤버 함수
async Task	EnsurePlayerAsync (CameraDevice camera)
async Task	DestroyPlayerAsync (CameraDevice camera, string? reason)
void	OnRuntimeStateChanged (object? sender, CameraRuntimeState state)

정적 Private 멤버 함수
static string	BuildVersionedHlsUrl (CameraDevice camera, CameraRuntimeState state)

Private 속성
readonly IVmsCameraRepository	_repository
readonly ICameraRuntimeStateService	_runtimeState
readonly IJSRuntime	_jsRuntime
readonly object	_gate = new()
bool	_isInitialized
bool	_isDisposed

상세한 설명

Live Blazor 페이지의 ViewModel입니다.

FFmpeg HLS 스트림의 시작/재시작은 BackgroundService가 담당합니다. 이 ViewModel은 RuntimeState와 video element를 동기화합니다. StopAll → StartAll 사이클에서 기존 hls.js 인스턴스를 제거하고, 다시 Connected/Connecting 상태가 되면 안전하게 재연결합니다.

LivePageViewModel.cs 파일의 24 번째 라인에서 정의되었습니다.

생성자 & 소멸자 문서화

LivePageViewModel()

DreamineVMS.Blazor.ViewModels.LivePageViewModel.LivePageViewModel ( IVmsCameraRepository repository, ICameraRuntimeStateService runtimeState, IJSRuntime jsRuntime )

inline

LivePageViewModel 클래스의 새 인스턴스를 초기화합니다.

매개변수

repository	카메라 Repository입니다.
runtimeState	카메라 런타임 상태 서비스입니다.
jsRuntime	Blazor JSRuntime입니다.

예외

ArgumentNullException

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

LivePageViewModel.cs 파일의 121 번째 라인에서 정의되었습니다.

    {
        _repository = repository ?? throw new ArgumentNullException(nameof(repository));
        _runtimeState = runtimeState ?? throw new ArgumentNullException(nameof(runtimeState));
        _jsRuntime = jsRuntime ?? throw new ArgumentNullException(nameof(jsRuntime));
    }

다음을 참조함 : _jsRuntime, _repository, _runtimeState.

멤버 함수 문서화

BuildVersionedHlsUrl()

string DreamineVMS.Blazor.ViewModels.LivePageViewModel.BuildVersionedHlsUrl ( CameraDevice camera, CameraRuntimeState state )

inlinestaticprivate

Versioned Hls Url 값을 구성합니다.

매개변수

camera	camera에 사용할 CameraDevice 값입니다.
state	state에 사용할 CameraRuntimeState 값입니다.

반환값

Build Versioned Hls Url 작업에서 생성한 string 결과입니다.

LivePageViewModel.cs 파일의 353 번째 라인에서 정의되었습니다.

    {
        ArgumentNullException.ThrowIfNull(camera);
        ArgumentNullException.ThrowIfNull(state);
 
        string separator = camera.HlsUrl.Contains('?', StringComparison.Ordinal) ? "&" : "?";
        return $"{camera.HlsUrl}{separator}session={state.RestartCount}";
    }

다음을 참조함 : DreamineVMS.Models.CameraDevice.HlsUrl.

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

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

DestroyPlayerAsync()

async Task DreamineVMS.Blazor.ViewModels.LivePageViewModel.DestroyPlayerAsync ( CameraDevice camera, string? reason )

inlineprivate

Destroy Player Async 작업을 수행합니다.

매개변수

camera	camera에 사용할 CameraDevice 값입니다.
reason	reason에 사용할 string? 값입니다.

반환값

Destroy Player Async 작업에서 생성한 Task 결과입니다.

LivePageViewModel.cs 파일의 440 번째 라인에서 정의되었습니다.

    {
        try
        {
            await _jsRuntime.InvokeVoidAsync(
                "dreamineVmsHls.destroy",
                GetPlayerId(camera),
                string.IsNullOrWhiteSpace(reason) ? "Stream stopped." : reason);
        }
        catch (JSDisconnectedException)
        {
            // Circuit이 끊긴 상태는 무시합니다.
        }
        catch
        {
            // 화면 종료 중 JS 런타임이 이미 끊긴 경우는 무시합니다.
        }
    }

다음을 참조함 : _jsRuntime, GetPlayerId().

다음에 의해서 참조됨 : DisposeAsync(), SynchronizePlayersAsync().

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

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

DisposeAsync()

async ValueTask DreamineVMS.Blazor.ViewModels.LivePageViewModel.DisposeAsync ( )

inline

이 인스턴스가 소유한 리소스를 해제합니다.

반환값

Dispose Async 작업에서 생성한 ValueTask 결과입니다.

LivePageViewModel.cs 파일의 296 번째 라인에서 정의되었습니다.

    {
        lock (_gate)
        {
            if (_isDisposed)
            {
                return;
            }
 
            _isDisposed = true;
 
            if (_isInitialized)
            {
                _runtimeState.StateChanged -= OnRuntimeStateChanged;
                _isInitialized = false;
            }
        }
 
        foreach (CameraDevice camera in Cameras)
        {
            await DestroyPlayerAsync(camera, "Live view disposed.");
        }
    }

다음을 참조함 : _gate, _isDisposed, _isInitialized, Cameras, DestroyPlayerAsync(), OnRuntimeStateChanged().

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

EnsurePlayerAsync()

async Task DreamineVMS.Blazor.ViewModels.LivePageViewModel.EnsurePlayerAsync ( CameraDevice camera )

inlineprivate

Ensure Player Async 작업을 수행합니다.

매개변수

camera

camera에 사용할 CameraDevice 값입니다.

반환값

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

LivePageViewModel.cs 파일의 386 번째 라인에서 정의되었습니다.

    {
        try
        {
            CameraRuntimeState state = _runtimeState.GetState(camera.Id);
            string source = BuildVersionedHlsUrl(camera, state);
 
            await _jsRuntime.InvokeVoidAsync(
                "dreamineVmsHls.init",
                GetPlayerId(camera),
                source);
        }
        catch (JSDisconnectedException)
        {
            // Circuit이 끊긴 상태는 무시합니다.
        }
        catch (Exception ex)
        {
            System.Diagnostics.Debug.WriteLine($"[LivePageViewModel] player init failed: {camera.Id}: {ex}");
        }
    }

다음을 참조함 : _jsRuntime, _runtimeState, BuildVersionedHlsUrl(), GetPlayerId(), DreamineVMS.Models.CameraDevice.Id.

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

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

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

GetPlayerId()

string DreamineVMS.Blazor.ViewModels.LivePageViewModel.GetPlayerId ( CameraDevice camera )

inlinestatic

Live 화면에서 사용하는 video element ID를 반환합니다.

매개변수

camera

카메라 정보입니다.

반환값

HTML video element ID입니다.

LivePageViewModel.cs 파일의 274 번째 라인에서 정의되었습니다.

    {
        ArgumentNullException.ThrowIfNull(camera);
        return $"video-{camera.Id}";
    }

다음에 의해서 참조됨 : DestroyPlayerAsync(), EnsurePlayerAsync().

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

Initialize()

void DreamineVMS.Blazor.ViewModels.LivePageViewModel.Initialize ( )

inline

Live 화면 진입 시 카메라 목록을 로드하고 RuntimeState 변경을 구독합니다.

LivePageViewModel.cs 파일의 159 번째 라인에서 정의되었습니다.

    {
        lock (_gate)
        {
            if (_isInitialized || _isDisposed)
            {
                return;
            }
 
            Cameras = _repository.GetAll()
                .Where(camera => camera.Enabled)
                .OrderBy(camera => camera.DisplayOrder)
                .Take(5)
                .ToArray();
 
            _runtimeState.StateChanged += OnRuntimeStateChanged;
            _isInitialized = true;
        }
    }

다음을 참조함 : _gate, _isDisposed, _isInitialized, _repository, Cameras, OnRuntimeStateChanged().

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

OnAfterRenderAsync()

async Task DreamineVMS.Blazor.ViewModels.LivePageViewModel.OnAfterRenderAsync ( bool firstRender )

inline

Video DOM이 생성된 뒤 player 상태를 RuntimeState와 동기화합니다.

매개변수

firstRender

첫 렌더링 여부입니다.

반환값

비동기 작업입니다.

LivePageViewModel.cs 파일의 203 번째 라인에서 정의되었습니다.

    {
        if (!firstRender)
        {
            return;
        }
 
        await SynchronizePlayersAsync();
    }

다음을 참조함 : SynchronizePlayersAsync().

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

OnRuntimeStateChanged()

void DreamineVMS.Blazor.ViewModels.LivePageViewModel.OnRuntimeStateChanged ( object? sender, CameraRuntimeState state )

inlineprivate

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

매개변수

sender	이벤트를 발생시킨 객체입니다.
state	state에 사용할 CameraRuntimeState 값입니다.

LivePageViewModel.cs 파일의 483 번째 라인에서 정의되었습니다.

    {
        if (Cameras.All(c => c.Id != state.CameraId))
        {
            return;
        }
 
        if (_isDisposed)
        {
            return;
        }
 
        PlayersNeedSync?.Invoke(this, EventArgs.Empty);
    }

다음을 참조함 : _isDisposed, DreamineVMS.Models.CameraRuntimeState.CameraId, Cameras, PlayersNeedSync.

다음에 의해서 참조됨 : DisposeAsync(), Initialize().

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

SynchronizePlayersAsync()

async Task DreamineVMS.Blazor.ViewModels.LivePageViewModel.SynchronizePlayersAsync ( )

inline

현재 RuntimeState에 맞춰 hls.js player를 생성 또는 제거합니다.

반환값

비동기 작업입니다.

LivePageViewModel.cs 파일의 229 번째 라인에서 정의되었습니다.

    {
        if (_isDisposed)
        {
            return;
        }
 
        foreach (CameraDevice camera in Cameras)
        {
            CameraRuntimeState state = _runtimeState.GetState(camera.Id);
 
            if (state.State is CameraConnectionState.Connected or CameraConnectionState.Connecting)
            {
                await EnsurePlayerAsync(camera);
                continue;
            }
 
            await DestroyPlayerAsync(camera, state.LastMessage);
        }
    }

다음을 참조함 : _isDisposed, _runtimeState, Cameras, DestroyPlayerAsync(), EnsurePlayerAsync(), DreamineVMS.Models.CameraDevice.Id, DreamineVMS.Models.CameraRuntimeState.LastMessage, DreamineVMS.Models.CameraRuntimeState.State.

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

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

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

멤버 데이터 문서화

_gate

readonly object DreamineVMS.Blazor.ViewModels.LivePageViewModel._gate = new()

private

gate 값을 보관합니다.

LivePageViewModel.cs 파일의 61 번째 라인에서 정의되었습니다.

다음에 의해서 참조됨 : DisposeAsync(), Initialize().

_isDisposed

bool DreamineVMS.Blazor.ViewModels.LivePageViewModel._isDisposed

private

is Disposed 값을 보관합니다.

LivePageViewModel.cs 파일의 79 번째 라인에서 정의되었습니다.

다음에 의해서 참조됨 : DisposeAsync(), Initialize(), OnRuntimeStateChanged(), SynchronizePlayersAsync().

_isInitialized

bool DreamineVMS.Blazor.ViewModels.LivePageViewModel._isInitialized

private

is Initialized 값을 보관합니다.

LivePageViewModel.cs 파일의 70 번째 라인에서 정의되었습니다.

다음에 의해서 참조됨 : DisposeAsync(), Initialize().

_jsRuntime

readonly IJSRuntime DreamineVMS.Blazor.ViewModels.LivePageViewModel._jsRuntime

private

js Runtime 값을 보관합니다.

LivePageViewModel.cs 파일의 52 번째 라인에서 정의되었습니다.

다음에 의해서 참조됨 : DestroyPlayerAsync(), EnsurePlayerAsync(), LivePageViewModel().

_repository

readonly IVmsCameraRepository DreamineVMS.Blazor.ViewModels.LivePageViewModel._repository

private

repository 값을 보관합니다.

LivePageViewModel.cs 파일의 34 번째 라인에서 정의되었습니다.

다음에 의해서 참조됨 : Initialize(), LivePageViewModel().

_runtimeState

readonly ICameraRuntimeStateService DreamineVMS.Blazor.ViewModels.LivePageViewModel._runtimeState

private

runtime State 값을 보관합니다.

LivePageViewModel.cs 파일의 43 번째 라인에서 정의되었습니다.

다음에 의해서 참조됨 : EnsurePlayerAsync(), LivePageViewModel(), SynchronizePlayersAsync().

속성 문서화

Cameras

IReadOnlyList<CameraDevice> DreamineVMS.Blazor.ViewModels.LivePageViewModel.Cameras = Array.Empty<CameraDevice>()

getprivate set

Live 화면에 표시할 카메라 목록입니다.

LivePageViewModel.cs 파일의 149 번째 라인에서 정의되었습니다.

{ get; private set; } = Array.Empty<CameraDevice>();

다음에 의해서 참조됨 : DisposeAsync(), Initialize(), OnRuntimeStateChanged(), SynchronizePlayersAsync().

이벤트 문서화

PlayersNeedSync

EventHandler? DreamineVMS.Blazor.ViewModels.LivePageViewModel.PlayersNeedSync

RuntimeState 변경으로 player 동기화가 필요할 때 발생합니다.

LivePageViewModel.cs 파일의 139 번째 라인에서 정의되었습니다.

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

---

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

• LivePageViewModel.cs