ba-story-player v0.8.1

剧情播放器组件仓库

本仓库是剧情播放器组件仓库, 用于播放碧蓝档案游戏剧情.

在进入全屏后, 如果宽高比小于16/9, 则维持宽高比, 若大于, 则锁定为16/9. 全屏时会自动检测是否横屏并自动旋转.

使用

<script setup>
import storyPlayer from 'ba-story-player'
import 'ba-story-player/dist/style.css'
</script>

props

story

type: StoryRawUnit[]

剧情原始数据数组.

dataUrl

type: string

资源服务器地址, 用于获取立绘语音等游戏资源. 各资源的具体路径请参照lib/utils.ts中的getResourcesUrl.

width

type: number

播放器宽度, 单位是px, 可变.

height

播放器高度, 单位是px, 可变. 注意请不要设置偏离16/9太多的宽高比, 可能导致播放器表现变差.

storySummary

type:

export interface StorySummary {
  /**
   * 章节名
   */
  chapterName: string,
  /**
   * 简介
   */
  summary: string
}

language

type: 'Cn'|'Jp'|'En'|'Tw'

语言选项

startFullScreen

type: boolean

是否立即全屏, 用于移动端.

useMp3

type: boolean

使用mp3代替ogg格式音频, 用于解决safari浏览器的音频解码问题.

useSuperSampling

type: boolean

是否使用超分素材, 目前该功能尚未实现, 选项无实际效果.

event

end

播放结束时发送

贡献说明

请参照贡献指南