BV书签功能：视频时间点标记与快速跳转

2026-02-04 04:12:49作者：申梦珏Efrain

哔哩哔哩的第三方 Android TV 应用。A third-party Android TV app for Bilibili.

项目地址：https://gitcode.com/GitHub_Trending/bv/bv

你还在为寻找视频中的精彩片段而反复拖动进度条吗？BV的智能书签功能让你一键标记、快速跳转，彻底告别繁琐的手动定位！

📋 读完本文你能得到

BV书签功能的完整使用指南
时间点标记与管理的技术实现原理
多设备同步播放记录的实用技巧
高级书签功能的深度解析

🎯 为什么需要视频书签功能？

在观看长视频内容时，我们经常遇到这样的痛点：

痛点场景	传统解决方案	BV书签方案
精彩片段回看	手动记录时间点	一键标记，自动保存
多设备续播	记忆播放位置	云端同步，无缝衔接
学习内容复习	截图或笔记	时间点精准定位
分享特定片段	描述时间位置	直接跳转到精确秒数

🔧 BV书签功能架构解析

graph TD
    A[用户操作] --> B[书签管理模块]
    B --> C[本地存储]
    B --> D[云端同步]
    C --> E[Room数据库]
    D --> F[B站API]
    E --> G[播放记录持久化]
    F --> H[多设备同步]
    G --> I[快速恢复播放]
    H --> I

核心技术实现

BV使用Android Jetpack Room数据库来管理本地播放记录和书签数据：

@Database(
    entities = [SearchHistoryDB::class, UserDB::class],
    version = 3,
    exportSchema = true,
    autoMigrations = [
        AutoMigration(from = 1, to = 2),
        AutoMigration(from = 2, to = 3)
    ]
)
@TypeConverters(Converters::class)
abstract class AppDatabase : RoomDatabase() {
    abstract fun searchHistoryDao(): SearchHistoryDao
    abstract fun userDao(): UserDao
}

🚀 基础书签功能使用指南

1. 自动播放记录

BV会自动记录每个视频的最后播放位置：

// 自动保存播放进度
val setHistory = {
    logger.info { "play history: ${videoDetailViewModel.videoDetail?.history}" }
    lastPlayedCid = videoDetailViewModel.videoDetail?.history?.lastPlayedCid ?: 0
    lastPlayedTime = videoDetailViewModel.videoDetail?.history?.progress ?: 0
}

2. 手动添加书签

在播放界面使用遥控器或触控操作：

操作方式	功能描述	适用场景
菜单键 + 标记	添加当前时间点书签	精彩片段标记
长按确认键	快速添加书签	紧急标记需求
语音指令	语音添加书签	双手不便时

3. 书签管理界面

通过以下路径访问书签管理：

主菜单 → 我的 → 播放记录 → 书签管理

⚡ 快速跳转操作流程

sequenceDiagram
    participant User
    participant UI
    participant Player
    participant Database
    
    User->>UI: 选择书签
    UI->>Database: 查询时间点数据
    Database-->>UI: 返回时间戳
    UI->>Player: seekTo(时间戳)
    Player-->>User: 跳转到指定位置

精准跳转代码实现

// 播放器跳转核心代码
override fun seekTo(time: Long) {
    mPlayer?.seekTo(time)
    mDanmakuPlayer?.seekTo(time)
}

// 使用示例
videoPlayer.seekTo(bookmarkTimestamp)
mDanmakuPlayer?.seekTo(bookmarkTimestamp)

🌐 多设备同步机制

BV支持通过B站账号同步播放记录和书签：

同步类型	数据内容	同步时机
播放进度	最后播放位置	每次暂停/退出
书签数据	手动标记点	实时同步
观看历史	完整记录	定时同步

同步状态检查

// 检查登录状态和同步能力
val updateHistory = {
    scope.launch(Dispatchers.IO) {
        runCatching {
            videoDetailViewModel.loadDetailOnlyUpdateHistory(videoDetailViewModel.videoDetail!!.aid)
        }
        setHistory()
    }
}

🎨 高级书签功能

1. 智能书签分类

BV支持多种书签类型：

书签类型	标识颜色	自动生成条件
精彩时刻	金色	高能弹幕集中时段
学习重点	蓝色	重复观看片段
搞笑片段	绿色	评论区热议时间点
自定义	用户设置	手动添加