DreamineVMS.Web.Services.Hls.HlsSegmentStore 클래스 참조

더 자세히 ...

Public 멤버 함수
	HlsSegmentStore (IWebHostEnvironment env)
string	GetCameraDir (string tenantId, string cameraId)
async Task	SaveSegmentAsync (string tenantId, string cameraId, string filename, Stream data)
Stream? string ContentType	GetFile (string tenantId, string cameraId, string filename)
void	ClearCameraHls (string tenantId, string cameraId)

Public 속성
Stream?	Stream

정적 Private 멤버 함수
static void	CleanupOldSegments (string dir)
static string	Sanitize (string s)
static bool	IsAllowedFilename (string f)

Private 속성
readonly string	_root

정적 Private 속성
const int	RetainedSegmentCount = 45
static readonly TimeSpan	RetainedSegmentAge = TimeSpan.FromMinutes(2)

상세한 설명

에이전트가 푸시한 HLS 세그먼트를 파일로 저장하고 서빙합니다.

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

생성자 & 소멸자 문서화

HlsSegmentStore()

DreamineVMS.Web.Services.Hls.HlsSegmentStore.HlsSegmentStore ( IWebHostEnvironment env )

inline

지정한 설정으로 HlsSegmentStore 클래스의 새 인스턴스를 초기화합니다.

매개변수

env	env에 사용할 IWebHostEnvironment 값입니다.

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

    {
        _root = Path.Combine(env.ContentRootPath, "App_Data", "hls");
        Directory.CreateDirectory(_root);
    }

다음을 참조함 : _root.

멤버 함수 문서화

CleanupOldSegments()

void DreamineVMS.Web.Services.Hls.HlsSegmentStore.CleanupOldSegments ( string dir )

inlinestaticprivate

Cleanup Old Segments 작업을 수행합니다.

매개변수

dir	dir에 사용할 string 값입니다.

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

    {
        try
        {
            var thresholdUtc = DateTime.UtcNow - RetainedSegmentAge;
            var segments = Directory.GetFiles(dir, "*.ts")
                .OrderBy(File.GetLastWriteTimeUtc)
                .ToArray();
 
            foreach (var f in segments.Take(Math.Max(0, segments.Length - RetainedSegmentCount)))
            {
                try { File.Delete(f); } catch { }
            }
 
            foreach (var f in segments.Where(f => File.GetLastWriteTimeUtc(f) < thresholdUtc))
            {
                try { File.Delete(f); } catch { }
            }
        }
        catch { }
    }

다음을 참조함 : RetainedSegmentAge, RetainedSegmentCount.

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

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

ClearCameraHls()

void DreamineVMS.Web.Services.Hls.HlsSegmentStore.ClearCameraHls ( string tenantId, string cameraId )

inline

Clear Camera Hls 작업을 수행합니다.

매개변수

tenantId	tenant Id에 사용할 string 값입니다.
cameraId	camera Id에 사용할 string 값입니다.

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

    {
        try
        {
            var dir = Path.Combine(_root, Sanitize(tenantId), Sanitize(cameraId));
            if (!Directory.Exists(dir)) return;
            foreach (var f in Directory.GetFiles(dir))
                try { File.Delete(f); } catch { }
        }
        catch { }
    }

다음을 참조함 : _root, Sanitize().

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

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

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

GetCameraDir()

string DreamineVMS.Web.Services.Hls.HlsSegmentStore.GetCameraDir ( string tenantId, string cameraId )

inline

Camera Dir 값을 가져옵니다.

매개변수

tenantId	tenant Id에 사용할 string 값입니다.
cameraId	camera Id에 사용할 string 값입니다.

반환값

Get Camera Dir 작업에서 생성한 string 결과입니다.

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

    {
        var dir = Path.Combine(_root, Sanitize(tenantId), Sanitize(cameraId));
        Directory.CreateDirectory(dir);
        return dir;
    }

다음을 참조함 : _root, Sanitize().

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

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

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

GetFile()

Stream? string ContentType DreamineVMS.Web.Services.Hls.HlsSegmentStore.GetFile ( string tenantId, string cameraId, string filename )

inline

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

    {
        if (!IsAllowedFilename(filename)) return (null, "");
        var path = Path.Combine(_root, Sanitize(tenantId), Sanitize(cameraId), filename);
        if (!File.Exists(path)) return (null, "");
        var ct = filename.EndsWith(".m3u8", StringComparison.OrdinalIgnoreCase)
            ? "application/vnd.apple.mpegurl"
            : "video/mp2t";
        try
        {
            // MemoryStream으로 읽어 파일 핸들 즉시 해제 → 쓰기와 동시 접근 허용
            using var fs = new FileStream(path, FileMode.Open, FileAccess.Read, FileShare.ReadWrite | FileShare.Delete);
            var memory = new MemoryStream((int)Math.Min(fs.Length, int.MaxValue));
            fs.CopyTo(memory);
            memory.Position = 0;
            return (memory, ct);
        }
        catch { return (null, ""); }
    }

다음을 참조함 : _root, IsAllowedFilename(), Sanitize(), Stream.

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

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

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

IsAllowedFilename()

bool DreamineVMS.Web.Services.Hls.HlsSegmentStore.IsAllowedFilename ( string f )

inlinestaticprivate

Is Allowed Filename 조건을 확인합니다.

매개변수

f	f에 사용할 string 값입니다.

반환값

Is Allowed Filename 조건이 충족되면 true이고, 그렇지 않으면 false입니다.

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

                                                    =>
        f.EndsWith(".m3u8", StringComparison.OrdinalIgnoreCase) ||
        f.EndsWith(".ts", StringComparison.OrdinalIgnoreCase);

다음에 의해서 참조됨 : GetFile(), SaveSegmentAsync().

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

Sanitize()

string DreamineVMS.Web.Services.Hls.HlsSegmentStore.Sanitize ( string s )

inlinestaticprivate

Sanitize 작업을 수행합니다.

매개변수

s	이벤트를 발생시킨 객체입니다.

반환값

Sanitize 작업에서 생성한 string 결과입니다.

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

                                             =>
        string.Concat(s.Where(c => char.IsLetterOrDigit(c) || c is '-' or '_'));

다음에 의해서 참조됨 : ClearCameraHls(), GetCameraDir(), GetFile().

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

SaveSegmentAsync()

async Task DreamineVMS.Web.Services.Hls.HlsSegmentStore.SaveSegmentAsync ( string tenantId, string cameraId, string filename, Stream data )

inline

Segment Async 데이터를 저장합니다.

매개변수

tenantId	tenant Id에 사용할 string 값입니다.
cameraId	camera Id에 사용할 string 값입니다.
filename	filename에 사용할 string 값입니다.
data	data에 사용할 Stream 값입니다.

반환값

Save Segment Async 작업에서 생성한 Task 결과입니다.

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

    {
        if (!IsAllowedFilename(filename)) return;
        var dir = GetCameraDir(tenantId, cameraId);
        var path = Path.Combine(dir, filename);
 
        // 임시 파일에 쓴 뒤 원자적 rename → 읽기 중 충돌 방지
        var tmp = path + ".tmp";
        await using (var fs = new FileStream(tmp, FileMode.Create, FileAccess.Write, FileShare.Read))
        {
            await data.CopyToAsync(fs);
        }
 
        File.Move(tmp, path, overwrite: true);
 
        if (filename.EndsWith(".m3u8", StringComparison.OrdinalIgnoreCase))
            CleanupOldSegments(dir);
    }

다음을 참조함 : CleanupOldSegments(), GetCameraDir(), IsAllowedFilename(), Stream.

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

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

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

멤버 데이터 문서화

_root

readonly string DreamineVMS.Web.Services.Hls.HlsSegmentStore._root

private

root 값을 보관합니다.

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

다음에 의해서 참조됨 : ClearCameraHls(), GetCameraDir(), GetFile(), HlsSegmentStore().

RetainedSegmentAge

readonly TimeSpan DreamineVMS.Web.Services.Hls.HlsSegmentStore.RetainedSegmentAge = TimeSpan.FromMinutes(2)

staticprivate

Retained Segment Age 값을 보관합니다.

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

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

RetainedSegmentCount

const int DreamineVMS.Web.Services.Hls.HlsSegmentStore.RetainedSegmentCount = 45

staticprivate

Retained Segment Count 값을 보관합니다.

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

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

Stream

Stream? DreamineVMS.Web.Services.Hls.HlsSegmentStore.Stream

File 값을 가져옵니다.

매개변수

tenantId	tenant Id에 사용할 string 값입니다.
cameraId	camera Id에 사용할 string 값입니다.
filename	filename에 사용할 string 값입니다.

반환값

Get File 작업에서 생성한 (Stream? Stream, string ContentType) 결과입니다.

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

다음에 의해서 참조됨 : GetFile(), SaveSegmentAsync().

---

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

• HlsSegmentStore.cs