ComusThumbz 文档
管理员登录

视频细节

# Video Details

## What This Page Does

This page gives you a complete view of a single video on your site. You can edit its title, description, categories, tags, models, thumbnails, chapters, scheduling, pricing, and SEO settings -- all from one place. You can also review how the video is performing, handle user reports, and preview the video using the built-in player.

[Screenshot: video-admin-details-full-modal-view]

---

## How to Get Here

1. Go to **Admin Panel > Content > Videos**.
2. Find the video you want to manage.
3. Click the video's thumbnail, title, or detail icon.
4. The Video Details panel opens on top of the video list.

---

## Understanding the Page

When you open Video Details, you see a panel with the video's ID number in a green badge and the video title at the top. Below that, the page is divided into multiple sections that you can show, hide, and reorder to match the way you like to work.

### Section Visibility Controls

At the top of the page, a green bar contains a row of toggle cards. Each card controls the visibility of one section on the page.

- **Toggle a section on or off** by clicking its switch.
- **Reorder sections** by dragging a card by its handle (the `::` icon) to a new position. The matching section on the page moves to follow.
- Your visibility and order preferences are remembered automatically, so the page looks the same every time you come back.

The available section toggles are: Player, Technical, Engagement, Analytics, Thumbnails, Chapters, Media, Metadata, Schedule, Sponsors, SEO & Social, Production, Content Flags, User Reports, Storage Server, and File Paths.

[Screenshot: video-admin-details-visibility-panel]

[tip]Hide sections you rarely use to keep the page clean and focused on what matters to you.[/tip]

### Auto-Save

Every field on this page saves automatically when you finish editing it. You do not need to click a save button. Just make your change and click somewhere else -- the update is saved right away.

[success]The **Save All Changes** button at the bottom is purely for visual reassurance. Clicking it briefly displays a confirmation message, but your changes were already saved the moment you finished typing or selecting.[/success]

---

## Common Tasks

### How to Edit the Video Title

1. Click on the video title at the top of the page.
2. Type your new title.
3. Click anywhere outside the title.
4. The new title is saved automatically.

### How to Change the Video Status

1. Find the **Status** dropdown in the Basic Information section.
2. Select one of the following:
   - **Pending** -- The video is waiting to be processed.
   - **Processing** -- The video is currently being converted.
   - **Active** -- The video is live and visible on your site.
   - **Error** -- Something went wrong during processing.
   - **Deleted** -- The video is removed from public view.
3. The status updates automatically when you make your selection.

[info]Only videos set to **Active** appear on your site. All other statuses keep the video hidden from visitors.[/info]

### How to Set Who Can Watch the Video

1. Find the **Access Type** dropdown in the Basic Information section.
2. Choose one of the following:
   - **Free** -- Anyone can watch, no account needed.
   - **Members Only** -- Only logged-in members can watch.
   - **Subscription** -- Only subscribers can watch.
   - **Pay-Per-View** -- Visitors must pay to watch this video.
   - **Private** -- Not visible to anyone on the public site.
3. The change saves automatically.

[tip]If you choose **Pay-Per-View**, scroll down to the Sponsors & Monetization section to set the price and currency.[/tip]

### How to Edit the Description

1. Scroll to the **Description** text box in the Basic Information section.
2. Click inside the text box and type or edit the description.
3. Click anywhere outside the box when you are done.
4. The description saves automatically.

### How to Manage Thumbnails

Your video's thumbnails are the small preview images visitors see when browsing your site.

#### Set the Main Thumbnail

1. Scroll to the **Thumbnails** section.
2. Browse the thumbnail gallery to find the image you want as the main poster.
3. Click the green **M** badge on that thumbnail.
4. Confirm your choice in the popup.
5. The selected thumbnail gets a pulsing green border showing it is now the main image.

[tip]Choose a clear, eye-catching thumbnail. This is the first image visitors see and it strongly affects whether they click to watch.[/tip]

#### Delete a Thumbnail

1. Click the red **D** badge on the thumbnail you want to remove.
2. Confirm the deletion in the popup.

[warning]Deleting a thumbnail is permanent and cannot be undone. The image is removed from storage entirely.[/warning]

#### View a Thumbnail Full Size

Click on any thumbnail image to open it in a full-screen viewer. Click anywhere outside the image or the close button to return to the page.

[Screenshot: video-admin-details-thumbnails]

### How to Add Video Chapters

Chapters are clickable markers on the video timeline that help viewers jump to specific parts of the video.

#### Add a Chapter at the Current Playback Position

1. Play the video in the built-in player and pause at the spot where you want a chapter to begin.
2. In the Chapters section, look at the **Current Video Time** display to confirm the position.
3. Click **Add Chapter Here**.
4. The chapter form opens with the timestamp already filled in.
5. Type a **Title** for the chapter (required).
6. Optionally add a **Description**.
7. Click **Save Chapter**.

[tip]This is the easiest way to add chapters. Just play the video, pause where you want the marker, and click the button.[/tip]

#### Add a Chapter Manually

1. Click **Add Chapter Manually** in the Chapters section.
2. Enter the timestamp in seconds (for example, `125.5` for 2 minutes and 5.5 seconds).
3. Click **Preview** to jump the player to that position and verify it looks right.
4. Type a **Title** and optional **Description**.
5. Click **Save Chapter**.

#### Edit a Chapter

1. Click the pencil icon on the chapter card you want to change.
2. Update the title, description, or timestamp as needed.
3. Click **Update from Player** if you want to re-sync the timestamp to the current player position.
4. Click **Save Chapter**.

#### Delete a Chapter

1. Click the trash icon on the chapter card.
2. Confirm the deletion in the popup.

[Screenshot: video-admin-details-chapters]

### How to Assign Categories

1. Scroll to the **Categories** card (near the bottom of the page).
2. Select a category from the dropdown.
3. Click **+ Add**.
4. The category appears as a badge. It is saved automatically.
5. To remove a category, click the **x** on its badge.

[info]You can assign up to 10 categories per video.[/info]

### How to Add Tags

1. Scroll to the **Tags** card.
2. Type a tag in the text field.
3. Press **Enter** or click **+ Add**.
4. The tag appears as a badge and is saved automatically.
5. To remove a tag, click the **x** on its badge.

#### Use Suggested Tags

1. Click the **Suggestions** button to see a list of popular tags.
2. Click any suggested tag to add it to the video instantly.
3. Click **Suggestions** again to close the panel.

[info]If you try to add a tag that already exists on the video, you will see an alert and the duplicate will not be added.[/info]

### How to Assign Models / Performers

1. Scroll to the **Models** card.
2. Type at least 2 characters of a model's name in the search field.
3. A dropdown of matching results appears after a brief pause.
4. Click the model you want to assign. Models already assigned to this video are grayed out.
5. The model appears as a badge and is saved automatically.
6. To remove a model, click the **x** on its badge.

#### Create a New Model

If the model you need does not exist yet:

1. Type the model name in the search field.
2. At the bottom of the search results, click **Create new model: [name]**.
3. The model is created and assigned to the video in one step.

### How to Schedule a Video

You can control when a video becomes visible and when it disappears from your site.

1. Scroll to the **Schedule** section.
2. Set a **Start Date** to choose when the video should appear on your site.
3. Set an **End Date** to choose when the video should stop being visible.
4. Both fields save automatically.

[tip]Leave these fields empty if you want the video to be visible at all times (as long as its status is Active).[/tip]

### How to Set Up Sponsors and Pricing

1. Scroll to the **Sponsors & Monetization** section.
2. Select a **Primary Sponsor** from the dropdown if this video is sponsored.
3. If your sponsor has sub-sponsors, a second dropdown appears automatically -- select the appropriate **Sub-Sponsor**.
4. Select a **Cam Site** if you want to link this video to a cam site.
5. Enter a **Price** if this is a pay-per-view video.
6. Choose the **Currency** (USD, EUR, GBP, CAD, AUD, or JPY).

### How to Configure SEO and Social Sharing

Good SEO settings help your videos appear in search engine results. Social sharing settings control how your videos look when shared on social media.

1. Scroll to the **SEO & Social Media** section.
2. Fill in the **Meta Title** (recommended: keep under 70 characters). A character counter shows your progress.
3. Fill in the **Meta Description** (recommended: keep under 160 characters). A character counter shows your progress.
4. Add **Meta Keywords** separated by commas.
5. Set the **URL Slug** for a clean, readable web address.
6. Fill in the **Open Graph** fields (Title, Description, Image) to control how the video appears when shared on Facebook and LinkedIn.
7. Fill in the **Twitter** fields (Title, Description, Image) to control how the video appears when shared on Twitter.

[tip]Keep your Meta Title under 70 characters and Meta Description under 160 characters. The live character counters help you stay within these limits so your content displays properly in search results.[/tip]

[Screenshot: video-admin-details-seo]

### How to Add Production Details

1. Scroll to the **Production Details** section.
2. Fill in any relevant fields:
   - **Release Date** -- The official release date of the video.
   - **Production Year** -- The year the video was produced.
   - **Studio** -- The production studio name.
   - **Director**, **Producer** -- Key production credits.
   - **Series Name**, **Season Number**, **Episode Number** -- If the video is part of a series.
   - **Orientation** -- Whether the video is landscape, portrait, or square.

### How to Mark Content Flags

1. Scroll to the **Content Flags & Optimization** section.
2. Check or uncheck the following as needed:
   - **Copyright Claimed** -- Check this if the video has a copyright claim against it.
   - **DMCA Notices** -- Enter the number of DMCA notices received.
   - **SEO Optimized** -- Check this when you have completed the SEO fields.
   - **Social Media Optimized** -- Check this when social sharing tags are configured.
   - **Mobile Optimized** -- Check this if the video is confirmed to play well on mobile devices.

### How to Handle User Reports

When visitors report a problem with a video, those reports appear here.

1. Scroll to the **User Reports** section. A badge shows how many reports exist.
2. Review each report's details:
   - **Reason** -- What the user reported (such as broken video, wrong category, copyright issue, and so on).
   - **Reporter** -- The username of the person who filed the report.
   - **Date** -- When the report was submitted.
   - **Details** -- Any additional information the reporter provided.
3. Take action using the buttons on each report:
   - **Mark Reviewed** -- You have seen the report and are looking into it.
   - **Resolve** -- The issue has been fixed.
   - **Dismiss** -- The report is not valid or no action is needed.

[warning]Take copyright and DMCA reports seriously. These may have legal implications. Always investigate before dismissing.[/warning]

[Screenshot: video-admin-details-reports]

### How to Write Admin Notes

1. Scroll to the **Admin Notes** section.
2. Type any internal notes about this video. These notes are only visible to administrators.
3. Click outside the text box. Notes save automatically.

[tip]Use admin notes to record why changes were made, flag issues for other team members, or keep track of report investigations.[/tip]

---

## Using the Built-In Video Player

The page includes a full video player so you can preview the video without leaving the admin panel.

### Basic Playback Controls

- **Play/Pause** -- Click the play button or press the spacebar.
- **Seek** -- Click or drag on the progress bar to jump to a specific point.
- **Volume** -- Adjust with the volume slider.
- **Fullscreen** -- Click the fullscreen button in the lower right corner.

### Changing Video Quality

If the video has multiple quality levels available:

1. Click the gear icon in the player's control bar.
2. Select the quality level you prefer, or choose **Auto** to let the player decide based on your internet speed.

### Debug Information

If you need to investigate playback issues:

1. Look at the stats bar above the player. It shows the current source type, quality level, player state, and buffer status.
2. Click **Debug Console** below the player for a detailed log of playback events.
3. Click again to hide the console.

[info]The player in the admin panel may behave slightly differently from the player your visitors see. Some features may be enabled or disabled specifically for the admin preview.[/info]

---

## Viewing Video Analytics

### Engagement Statistics

The Engagement section shows key numbers about how the video is performing:

| Stat | What It Tells You |
|------|-------------------|
| **Views** | How many times the video has been watched |
| **Likes** | How many users liked the video |
| **Dislikes** | How many users disliked the video |
| **Comments** | How many comments the video has received |
| **Rating** | The average star rating (1 to 5) and number of votes |
| **Downloads** | How many times the video has been downloaded |
| **Impressions** | How many times the video appeared on a page |
| **Clicks** | How many times visitors clicked on the video |
| **CTR** | Click-through rate -- the percentage of impressions that resulted in clicks |

#### Setting Override Values

Some stats (Views, Likes, Dislikes, Downloads, and Rating Votes) have an override field next to them. You can enter a minimum display value here for social proof. The actual tracked number is always shown separately so you know the real count.

1. Click the override input next to the stat you want to adjust.
2. Type your desired minimum value.
3. Click outside the field. The override saves automatically.

### Analytics & Performance

Click the **Analytics & Performance** section header to expand it. This section has three tabs:

#### Performance Tab

- **Watch Time & Engagement** -- Shows the average watch time, completion rate (what percentage of the video people watch), and bounce rate (what percentage of viewers left early).
- **Category Comparison** -- Shows how this video's completion rate compares to the average for videos in the same category.
- **Views Trend** -- A 30-day chart showing daily view counts.
- **Activity & Resources** -- Shows when the video was last watched and how much bandwidth it has used.

#### Processing Tab

Shows the video's processing history, including when processing started, when it finished, and how long it took.

#### Playlists Tab

Shows which playlists include this video, along with the video's position in each playlist. If the video is not in any playlists, a message tells you so.

---

## Media Assets

The Media Assets section shows additional files generated from your video:

- **Preview Video** -- A short clip that plays when visitors hover over the video thumbnail.
- **Poster Image** -- The main image displayed before the video plays.
- **Animated GIF** -- An animated preview loop.
- **Contact Sheet** -- A grid of frames from throughout the video.

Click on any image to view it full size.

[Screenshot: video-admin-details-media-assets]

---

## Additional Metadata

| Setting | What It Does |
|---------|-------------|
| **Featured** | Check this to display the video in featured sections and homepage carousels |
| **HLS Enabled** | Check this if the video uses adaptive streaming (automatically adjusts quality based on viewer's internet speed) |
| **CDN Distributed** | Check this if the video files are hosted on a content delivery network |
| **Original File Deleted** | Shows whether the original uploaded file was removed after processing (display only, not editable) |

---

## Storage and File Locations

### Storage Server

Shows where the video's files are currently stored, including:

- The server name and type
- The server group it belongs to
- The server's health status (shown as a colored indicator: green for healthy, amber for warning, red for problems)
- The total number of files stored for this video

### Moving Files to a Different Server

If you need to move the video's files to a different storage server:

1. Scroll to the **Storage Server** section.
2. In the migration panel, select a destination server from the dropdown. Servers are grouped by server group and show their health status. Servers with problems are disabled.
3. Click **Migrate All Files**.
4. Confirm the migration in the popup.
5. Wait for the process to complete. The button changes to show progress.
6. The page reloads when the migration finishes successfully.

[warning]File migration may take time for large videos and cannot be stopped once started. Make sure the destination server has enough space before starting.[/warning]

### File Paths

The File Paths section lists the web addresses for all of the video's files (main video, poster, preview, animated GIF, contact sheet, streaming playlist, and sprite files). Click any link to open it in a new browser tab and verify the file is accessible.

---

## Settings and Options

### Fields That Affect Your Public Site

Changes you make on this page directly affect what visitors see on your site:

| Setting | What Changes on Your Site |
|---------|--------------------------|
| **Title** | Appears on video cards, the player page, and search results |
| **Description** | Shown on the video player page and used in search indexing |
| **Status** | Only Active videos appear on your site |
| **Access Type** | Controls who can watch: everyone, members, subscribers, or pay-per-view |
| **Featured** | Featured videos appear in homepage carousels and featured sections |
| **Categories / Tags / Models** | Affect filtering, browsing, related videos, and search results |
| **Main Thumbnail** | The image visitors see when browsing videos |
| **SEO Fields** | Affect how search engines and social media display your video |
| **Schedule Dates** | Videos only appear within the scheduled date range |
| **Price / Currency** | The cost shown to visitors for pay-per-view videos |
| **Chapters** | Appear as clickable markers on the video player timeline |

---

## Tips for New Users

[tip]
- Start by setting the **Title**, **Description**, **Categories**, and **Main Thumbnail** for each video. These are the most important fields for attracting viewers.
- Use the **Featured** checkbox sparingly. Featuring too many videos dilutes the impact of your homepage carousels.
- Fill in the **SEO fields** (Meta Title and Meta Description) for your most important videos to improve search engine visibility.
- Use **Chapters** on longer videos to help viewers find the parts they are interested in.
- Check the **User Reports** section regularly to address any issues visitors have flagged.
- Use **Admin Notes** to keep track of any decisions or changes you make so other administrators can see the context.
[/tip]

---

## Troubleshooting

### Video not playing in the preview player

**What you see:** The player shows a black screen or an error message.

**How to fix it:**
1. Scroll down to the **File Paths** section and click on the **Main Video** link.
2. If the link does not load, the video file may not be available on the storage server. Check the **Storage Server** section for the server's health status.
3. If the video has **HLS Enabled** checked, try unchecking it temporarily to see if the standard video file plays instead.
4. If the problem persists, the video may need to be reprocessed. Go to **Admin Panel > Content > Videos**, find the video, and check its processing status.

### Changes do not seem to be saving

**What you see:** You edit a field but the value reverts or does not appear to stick.

** 如何修复:**
1. 刷新页面并检查更改是否实际保存。 在背景中自动保存的作品,即使没有看到确认,该值也可能被保存.
2. 如果修改确实没有节省,你的届会可能已经过期。 登入,然后再试一次
3. 编辑后请确保点击外地。 更改,但离开字段时除外,在仍然打字时则不更改。

缩略图按钮已灰化

*你所看到的* 缩略图上的绿色**M**(设置主)和红色**D**(删除)按钮都淡出,无法点击.

** 如何修复:** 这发生在缩略图记录不完整时. 缩略图图像可见,但无法通过这些按钮管理 。 尝试后处理视频以正确再生缩略图.

未加载的章节

*你所看到的* 章节部分显示一个永不消失的加载消息,或者即使加载之后也没有章节出现.

** 如何修复:**
1. 点击章节部分中的** refresh**按钮重新装入章节列表。
2. 如果问题继续存在,请刷新整页。
3. 如果章节仍未出现,请联系您的系统管理员,以校验章节特性。

QQ 视频卡在处理状态中

*你所看到的* 视频状态显示 ** Processing ** 且从未改变 ** Active **.

** 如何修复:**
1. 检查分析部分的**Processing**标签,看看是否记录了起始时间。
2. 如果录像处理时间异常长(标准录像超过一小时),请联系系统管理员。 视频处理系统可能存在问题.

QQ 存储迁移失败

*你所看到的* 您试图将文件迁移到不同的服务器, 但得到错误消息 。

** 如何修复:**
1. 确保目的地服务器显示绿色(健康)或琥珀(警告)状态。 无法选择具有红色(关键)或灰色(未知)状态的服务器 。
2. 核实目的地服务器有足够的存储空间用于视频文件.
3. 几分钟后再试一次。 这个问题可能是暂时的。
4. 如果问题依然存在,请联系您的系统管理员。

- - - 说吧

□ 相关页面

* * * * 何时使用 * * * 页 * *
|,|也.
** 视频管理** 查看您完整的视频列表, 搜索视频, 或执行批量动作 QQ
###视频上传####### 将新视频添加到您的网站QQ
** 类别** 要创建或管理您指派给视频的类别QQ
* ** 模式** * * 详细管理模型/执行情况简介
* ** 服务器** * * 要查看和管理您的存储服务器及其健康状况 QQ

- - - 说吧

□ 版本历史

* 版本 * 日期 * 更改 * 。
|,|也.
| 1.0.0 | 2026-02-04 | 初创方便用户指南 |