Skip to content

armgit / peach

Public Imported from GitHub
0

Peach: Local-first video metadata scraper and media manager.

7.6 KB
Raw Blame
/* 进度条上方那块预览:指着哪一秒,就显示那一秒的画面和时间。详情、小窗与沉浸三处共用。
 *
 * 只认「宿主元素 + 进度比例」,不认事件:Video.js 的进度条和沉浸自绘的那条各自把指针换成比例
 * 交进来。时间轴采集铺好了接触印相就按它取格;取不到、且有快照时退回九宫格那九格,否则只报时间。
 * 这里只读已经铺好的图,`/timeline` 不现抽,`/poster` 只从已有快照裁格、不读视频。 */
import { api, fmtClock } from '@peach/legacy/core';

import { timelineFrame, type TimelineSheets } from './timeline';

export interface SeekPreviewItem {
  id?: number | string;
  width?: number | null;
  height?: number | null;
  /** 有九宫格快照(与卡片悬停同一判据);没有就不退回九宫格,免得每格去撞 404。 */
  has_thumb?: unknown;
}

/** 一帧落在第几张接触印相、第几格;`rows` 是这一张自己的行数。 */
export interface SheetTile { page: number; slot: number; columns: number; rows: number }

/** 自有接触印相按页预热的上限:两小时的片子 10 秒一帧是 8 张,再长的按需取。 */
export const PRELOAD_PAGES = 12;

export function sheetTile(seconds: number, sheet: TimelineSheets): SheetTile | null {
  const index = timelineFrame(seconds, sheet);
  if (index === null) return null;
  const columns = sheet.columns || 10, per = columns * (sheet.rows || 10);
  const page = Math.floor(index / per);
  // 末张通常不满 10 行,行数按它自己那几帧反算:按满行去铺,格子会落到图外面的空白上。
  return { page, slot: index % per, columns, rows: Math.ceil(Math.min(per, sheet.frames - page * per) / columns) };
}

/** 预览中心点:跟着指针,但整块留在进度条里,两端各让出 `inset`。放不下时居中。 */
export function previewCenter(pointer: number, track: number, width: number, inset = 0): number {
  if (width + inset * 2 >= track) return track / 2;
  return Math.min(track - inset - width / 2, Math.max(inset + width / 2, pointer));
}

/** 只预热 Peach 自有接触印相:页数可数。外部来源的 `s` 是帧号、一帧一图,可能几百张,按需取。 */
export function preloadPages(sheet: TimelineSheets | null | undefined): number {
  if (!sheet || (sheet.source || 'peach') !== 'peach' || sheet.cues?.length || !(sheet.interval > 0) || sheet.frames <= 0) return 0;
  const pages = Math.ceil(sheet.frames / ((sheet.columns || 10) * (sheet.rows || 10)));
  return pages <= PRELOAD_PAGES ? pages : 0;
}

export interface SeekPreview {
  /** 指针进了进度条或开始拖:此时才预热整片的接触印相,没碰进度条的播放不多下载。 */
  prime(): void;
  /** `ratio` 是进度比例,`duration` 是整片秒数。 */
  show(ratio: number, duration: number): void;
  hide(): void;
  dispose(): void;
}

/** `inset`:进度条贴着视口边时(沉浸),预览离两端留的距离;Video.js 的进度条本身已经内缩。 */
export function createSeekPreview(host: HTMLElement, item: SeekPreviewItem | null,
  options: { thumbnail?: boolean; inset?: number } = {}): SeekPreview {
  const hasThumbnail = !!item?.id && options.thumbnail !== false;
  const preview = document.createElement('div');
  preview.className = 'vjs-peach-seek-preview'; preview.dataset.playerSeekPreview = ''; preview.hidden = true;
  preview.innerHTML = `${hasThumbnail ? '<i class="vjs-peach-seek-frame" hidden><img alt=""></i>' : ''}<span class="mono">0:00</span>`;
  host.append(preview);
  const frame = preview.querySelector<HTMLElement>('.vjs-peach-seek-frame');
  const image = preview.querySelector('img'), label = preview.querySelector('span')!;
  const id = encodeURIComponent(String(item?.id ?? ''));
  const aspect = (width: number, height: number) => { frame?.style.setProperty('--seek-aspect', String(width / height)) };
  if (item?.width && item.height) aspect(item.width, item.height);
  let sheets: TimelineSheets | null = null, shown = '', indexedImage = false, cell = -1, primed = false, disposed = false;
  /* 九宫格一格取不到,多半是快照没了:九格同源,不再逐格去试。 */
  let posterless = item?.has_thumb !== true;
  const warm: HTMLImageElement[] = [];
  const sheetSource = (sheet: TimelineSheets, page: number) =>
    `/timeline?id=${id}&s=${page}&source=${encodeURIComponent(sheet.source || 'peach')}`;
  const preload = () => {
    if (!primed || !sheets) return;
    for (const sheet of [sheets, sheets.fallback]) {
      for (let page = 0; page < preloadPages(sheet); page++) {
        const source = sheetSource(sheet!, page);
        if (warm.some((img) => img.dataset.source === source)) continue;
        const img = new Image(); img.decoding = 'async'; img.dataset.source = source; img.src = source;
        warm.push(img);
      }
    }
  };
  if (frame) {
    (api(`/api/timeline?id=${id}`) as Promise<TimelineSheets | null>).then((meta) => {
      if (disposed || !meta || !(meta.frames > 0) || !(meta.interval > 0 || meta.cues?.length)) return;
      sheets = meta; preload();
    }).catch(() => {});
  }
  const showSheetFrame = (seconds: number, sheet: TimelineSheets) => {
    const tile = sheetTile(seconds, sheet);
    if (!tile || !frame || !image) return false;
    indexedImage = !!sheet.cues;
    // 外部逐帧图按图片自身比例取景(见 `onload`);回到拼图时取景框回到片源比例。
    if (!indexedImage && item?.width && item.height) aspect(item.width, item.height);
    const source = sheetSource(sheet, tile.page);
    if (source !== shown) { shown = source; image.src = source }
    frame.hidden = false;
    // 取景框按片源比例,图按格子铺满:两边比例一致,`fill` 才既不裁也不拉。
    image.style.objectFit = 'fill';
    image.style.width = `${tile.columns * 100}%`; image.style.height = `${tile.rows * 100}%`;
    image.style.left = `${-(tile.slot % tile.columns) * 100}%`; image.style.top = `${-Math.floor(tile.slot / tile.columns) * 100}%`;
    return true;
  };
  const showPoster = (ratio: number) => {
    if (!frame || !image) return;
    if (posterless) { frame.hidden = true; return }
    const next = Math.min(8, Math.floor(ratio * 9));
    if (next === cell && shown === `poster:${next}`) return;
    cell = next; frame.hidden = false; image.removeAttribute('style');
    indexedImage = false; shown = `poster:${next}`;
    image.src = `/poster?id=${id}&c=${next}`;
  };
  if (image && frame) {
    image.onerror = () => {
      if (shown.startsWith('poster:')) posterless = true;
      frame.hidden = true; sheets = indexedImage ? sheets?.fallback || null : null; shown = ''; cell = -1;
    };
    image.onload = () => { if (indexedImage && image.naturalWidth && image.naturalHeight) aspect(image.naturalWidth, image.naturalHeight) };
  }
  return {
    prime() { if (!primed) { primed = true; preload() } },
    show(ratio, duration) {
      if (!duration || disposed) return;
      const clamped = Math.min(1, Math.max(0, ratio)), seconds = duration * clamped;
      label.textContent = fmtClock(seconds);
      if (frame && !(sheets && showSheetFrame(seconds, sheets)) && !(sheets?.fallback && showSheetFrame(seconds, sheets.fallback))) {
        showPoster(clamped);
      }
      preview.hidden = false;
      // 宽度按显出来之后的实测值夹边:框宽由样式按片源比例和视口定,这里不另算一套。
      const track = host.getBoundingClientRect().width;
      preview.style.left = `${previewCenter(clamped * track, track, preview.offsetWidth, options.inset)}px`;
    },
    hide() { preview.hidden = true },
    dispose() { disposed = true; warm.length = 0; preview.remove() },
  };
}