Tài liệu Tích hợp API v1 - HoaThinh3D Cloud

curl -X POST "https://app.hoathinh3d.cloud/api/v1/videos/search" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"searchText": "Tập 152","pageSize": 10,"pageIndex": 1,"categoryId": 24}'

{
  "data": [
    {
      "id": 152,
      "title": "Trọng Lực Vương Giả - Tập 12",
      "description": "Video đã render hoàn tất",
      "status": "ready",
      "duration": 1420,
      "posterUrl": "https://cdn.example.com/videos/152/poster.jpg",
      "m3u8": "https://cdn.example.com/videos/152/master.m3u8",
      "embedUrl": "https://app.hoathinh3d.cloud/embed/152",
      "subtitles": [
        {
          "language": "vi",
          "label": "Tiếng Việt",
          "format": "vtt",
          "url": "https://cdn.example.com/videos/152/subtitles/vi.vtt",
          "isDefault": true
        }
      ],
      "qualities": ["720p", "1080p"]
    }
  ],
  "meta": {
    "pageIndex": 1,
    "pageSize": 10,
    "total": 1
  }
}

{
  "sessionId": "ps_b7f29a0c1e84",
  "videoId": 797,
  "url": "https://cdn.hoathinh3d.cloud/videos/797/.../master.m3u8?pt=eyJhbGciOi...",
  "embedUrl": "https://app.hoathinh3d.cloud/embed/797?pt=eyJhbGciOi...",
  "expiresAt": "2026-08-26T04:30:00.000Z",
  "subtitles": [
    {
      "language": "vi",
      "label": "Thuyết Minh",
      "format": "vtt",
      "url": "https://cdn.hoathinh3d.cloud/videos/797/.../vi.vtt?pt=eyJhbGciOi...",
      "isDefault": true
    }
  ]
}

// 1. Lấy dữ liệu phim từ API tìm kiếm (/api/v1/videos/search)
const res = await fetch('https://app.hoathinh3d.cloud/api/v1/videos/search', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer ' + process.env.RENDER_HLS_API_KEY,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ searchText: 'Trụ Tiên Tập 81', pageSize: 1 })
});
const { data } = await res.json();
const video = data[0];

// 2. Lấy cấu hình vị trí phụ đề Realtime từ Admin (tự động đồng bộ theo Admin):
const subConfigRes = await fetch('https://app.hoathinh3d.cloud/api/v1/playback/subtitles-config');
const { subtitlePositions } = await subConfigRes.json();

// 3. Khởi tạo ArtPlayer phát trực tiếp link m3u8
const art = new Artplayer({
  container: '#player',
  url: video.m3u8,
  subtitle: {
    url: video.subtitles?.[0]?.url || '',
    type: 'vtt',
    style: {
      color: '#FFFFFF',
      fontSize: 'clamp(18px, 3.2cqi, 40px)',
      textShadow: '0 2px 4px rgba(0,0,0,0.9)',
      bottom: '10%', // Sát đáy mặc định
    },
  },
  customType: {
    m3u8: function(videoElement, url, artInstance) {
      if (Hls.isSupported()) {
        const hls = new Hls({ maxBufferLength: 30, maxMaxBufferLength: 60 });
        hls.loadSource(url);
        hls.attachMedia(videoElement);
        artInstance.hls = hls;
      } else if (videoElement.canPlayType('application/vnd.apple.mpegurl')) {
        videoElement.src = url;
      }
    }
  }
});

// 4. Tự động đồng bộ vị trí phụ đề Realtime theo Admin và tỷ lệ khung hình video:
art.on('video:loadedmetadata', () => {
  const v = art.video;
  let targetBottom = subtitlePositions?.pos16x9 || 10;
  if (v && v.videoWidth && v.videoHeight) {
    const ratio = v.videoWidth / v.videoHeight;
    if (ratio >= 2.05) targetBottom = subtitlePositions?.pos21x9 || 22; // 21:9 Cinema
    else if (ratio <= 0.8) targetBottom = subtitlePositions?.pos9x16 || 28; // 9:16 Shorts
  }
  art.subtitle.style('bottom', targetBottom + '%');
});