Hướng dẫn sử dụng

1Cấu hình RTSP Templates

Các mẫu URL RTSP được định nghĩa trong Backend/appsettings.json, mục RtspConfig.Templates. Mỗi template có hai trường:

• UrlTemplate – mẫu URL với placeholder {creds}, {host}, {track}, {start}, {end}
• TimeFormat – định dạng thời gian theo chuẩn .NET (ví dụ: yyyyMMddTHHmmss, yyyy_MM_dd_HH_mm_ss)

{
  "RtspConfig": {
    "Templates": {
      "[ARYA]": {
        "UrlTemplate": "rtsp://{creds}@{host}/cam/playback?channel={track}&subtype=0&starttime={start}&endtime={end}",
        "TimeFormat":  "yyyy_MM_dd_HH_mm_ss"
      },
      "[HIK_OLD]": {
        "UrlTemplate": "rtsp://{creds}@{host}/Streaming/tracks/{track}/?starttime={start}&endtime={end}&size=1064413088&rw_timeout=50000000",
        "TimeFormat":  "yyyyMMddTHHmmss"
      },
      "DEFAULT": {
        "UrlTemplate": "rtsp://{creds}@{host}/Streaming/tracks/{track}/?starttime={start}&endtime={end}&size=1064413088&rw_timeout=50000000",
        "TimeFormat":  "yyyyMMddTHHmmss"
      }
    }
  }
}

2Nhập liệu Camera Station

Vào menu Camera Stations → Create hoặc chỉnh sửa station hiện có.

3Quy tắc trường Description

Hệ thống tự động chọn RTSP template và token dựa vào nội dung trường Description. Có hai cú pháp hỗ trợ:

Cú pháp 1 — Chỉ chọn template (không override token)

Đặt tag là key trong appsettings.json vào bất kỳ vị trí nào trong Description:

Cú pháp 2 — Chọn template và nhúng token riêng

Dùng khi camera station cần token khác với token mặc định. Cú pháp: [[TYPE:token]]

Camera kho 6 [[ARYA:dXNlcjpwYXNz]]
                 ^^^^^^^^^^^^
                 └─ token riêng của camera này (Base64 hoặc plaintext)

[[HIK_OLD:admin:abc123]] kho cũ tầng 2

# Kết quả sau khi parse:
#   Template được chọn : [ARYA] hoặc [HIK_OLD]
#   Token gửi lên backend: dXNlcjpwYXNz / admin:abc123
#   Token mặc định bị BỎ QUA

Luồng xử lý

1. Khi tạo / trích xuất VideoClip, hệ thống đọc Description của CameraStation.
2. Frontend parse Description (DescriptionParser):
   • Nếu tìm thấy [[TYPE:token]] → chuẩn hoá thành [TYPE] trong Description, lấy token override.
   • Ngược lại → giữ nguyên Description, token = token mặc định của VideoClip.
3. Payload gửi Backend chứa Description (đã chuẩn hoá) và Token (đã chọn đúng).
4. Backend dùng RtspTemplateHelper: duyệt keys, key nào Contains trong Description → chọn template đó.
5. Nếu không có key nào khớp → dùng template DEFAULT.
6. TimeFormat của template được áp dụng cho {start} và {end}.

4Kiểm tra kết quả trích xuất

Sau khi tạo và chạy VideoClip, kiểm tra log của Backend container để xác nhận template đã được chọn đúng:

# Xem realtime log
docker logs -f <backend-container-name>

# Tìm dòng log template
docker logs <backend-container-name> 2>&1 | grep "RTSP template key matched"

Dòng log mẫu khi chọn đúng template [ARYA]:

info: Backend.Controllers.VideoCaptureController[0]
      RTSP template key matched: [ARYA], TimeFormat: yyyy_MM_dd_HH_mm_ss

5Chạy Unit Test

Toàn bộ test chạy trong Docker container video-extraction-dev (image mcr.microsoft.com/dotnet/sdk:8.0). Workspace được mount tại /app.

Backend Tests – RtspTemplateHelperTests

Kiểm tra logic chọn template và định dạng thời gian (14 test cases, không cần DB, không cần FFmpeg).

# Khởi động container (nếu chưa chạy)
docker start video-extraction-dev

# Chạy backend tests
docker exec video-extraction-dev \
  dotnet test /app/Backend.Tests/Backend.Tests.csproj \
  --logger "console;verbosity=normal"

Frontend Tests – StationDescriptionTests & DescriptionParserTests

Kiểm tra logic tìm kiếm Description từ DB, parse [[TYPE:token]] và đóng gói extract request (15 + 19 test cases).

# Chỉ chạy StationDescriptionTests
docker exec video-extraction-dev \
  dotnet test /app/Frontend/UnitTest/UnitTest.csproj \
  --filter "FullyQualifiedName~StationDescriptionTests" \
  --logger "console;verbosity=normal"

# Chỉ chạy DescriptionParserTests (parser [[TYPE:token]])
docker exec video-extraction-dev \
  dotnet test /app/Frontend/UnitTest/UnitTest.csproj \
  --filter "FullyQualifiedName~DescriptionParserTests" \
  --logger "console;verbosity=normal"

# Chạy toàn bộ frontend tests
docker exec video-extraction-dev \
  dotnet test /app/Frontend/UnitTest/UnitTest.csproj \
  --logger "console;verbosity=normal"

6Câu hỏi thường gặp