PeerTube/server/core/lib/live/shared/muxing-session.ts

547 lines
17 KiB
TypeScript
Raw Normal View History

2024-03-19 03:53:59 -05:00
import { wait } from '@peertube/peertube-core-utils'
import { FileStorage, LiveVideoError, VideoStreamingPlaylistType } from '@peertube/peertube-models'
import { computeOutputFPS } from '@server/helpers/ffmpeg/index.js'
import { LoggerTagsFn, logger, loggerTagsFactory } from '@server/helpers/logger.js'
import { CONFIG } from '@server/initializers/config.js'
import { MEMOIZE_TTL, P2P_MEDIA_LOADER_PEER_VERSION, VIDEO_LIVE } from '@server/initializers/constants.js'
import { removeHLSFileObjectStorageByPath, storeHLSFileFromContent, storeHLSFileFromPath } from '@server/lib/object-storage/index.js'
import { VideoFileModel } from '@server/models/video/video-file.js'
import { VideoStreamingPlaylistModel } from '@server/models/video/video-streaming-playlist.js'
import { MStreamingPlaylistVideo, MUserId, MVideoLiveVideo } from '@server/types/models/index.js'
import Bluebird from 'bluebird'
2021-08-27 07:32:44 -05:00
import { FSWatcher, watch } from 'chokidar'
import { EventEmitter } from 'events'
2024-03-19 03:53:59 -05:00
import { FfprobeData } from 'fluent-ffmpeg'
import { ensureDir } from 'fs-extra/esm'
import { appendFile, readFile, stat } from 'fs/promises'
import memoizee from 'memoizee'
import PQueue from 'p-queue'
2021-06-16 08:14:41 -05:00
import { basename, join } from 'path'
2023-01-27 02:04:02 -06:00
import {
generateHLSMasterPlaylistFilename,
generateHlsSha256SegmentsFilename,
getLiveDirectory,
getLiveReplayBaseDirectory
} from '../../paths.js'
2024-02-12 03:47:52 -06:00
import { isUserQuotaValid } from '../../user.js'
import { LiveQuotaStore } from '../live-quota-store.js'
import { LiveSegmentShaStore } from '../live-segment-sha-store.js'
import { buildConcatenatedName, getLiveSegmentTime } from '../live-utils.js'
import { AbstractTranscodingWrapper, FFmpegTranscodingWrapper, RemoteTranscodingWrapper } from './transcoding-wrapper/index.js'
2021-06-16 08:14:41 -05:00
interface MuxingSessionEvents {
'live-ready': (options: { videoUUID: string }) => void
2021-06-16 08:14:41 -05:00
'bad-socket-health': (options: { videoUUID: string }) => void
'duration-exceeded': (options: { videoUUID: string }) => void
'quota-exceeded': (options: { videoUUID: string }) => void
2021-06-16 08:14:41 -05:00
'transcoding-end': (options: { videoUUID: string }) => void
'transcoding-error': (options: { videoUUID: string }) => void
2021-06-16 08:14:41 -05:00
'after-cleanup': (options: { videoUUID: string }) => void
2021-06-16 08:14:41 -05:00
}
declare interface MuxingSession {
on<U extends keyof MuxingSessionEvents>(
event: U, listener: MuxingSessionEvents[U]
): this
emit<U extends keyof MuxingSessionEvents>(
event: U, ...args: Parameters<MuxingSessionEvents[U]>
): boolean
}
class MuxingSession extends EventEmitter {
private transcodingWrapper: AbstractTranscodingWrapper
2021-06-16 08:14:41 -05:00
private readonly context: any
private readonly user: MUserId
private readonly sessionId: string
private readonly videoLive: MVideoLiveVideo
2023-05-16 02:12:50 -05:00
private readonly inputLocalUrl: string
private readonly inputPublicUrl: string
2021-06-16 08:14:41 -05:00
private readonly fps: number
private readonly allResolutions: number[]
2021-08-06 06:35:25 -05:00
private readonly bitrate: number
private readonly ratio: number
private readonly hasAudio: boolean
2024-03-19 03:53:59 -05:00
private readonly probe: FfprobeData
2021-06-16 08:14:41 -05:00
private readonly videoUUID: string
private readonly saveReplay: boolean
private readonly outDirectory: string
private readonly replayDirectory: string
2021-06-16 08:14:41 -05:00
private readonly lTags: LoggerTagsFn
// Path -> Queue
private readonly objectStorageSendQueues = new Map<string, PQueue>()
2021-06-16 08:14:41 -05:00
private segmentsToProcessPerPlaylist: { [playlistId: string]: string[] } = {}
2023-01-27 02:04:02 -06:00
private streamingPlaylist: MStreamingPlaylistVideo
private liveSegmentShaStore: LiveSegmentShaStore
2023-05-02 06:51:06 -05:00
private filesWatcher: FSWatcher
private masterPlaylistCreated = false
private liveReady = false
2021-06-16 08:14:41 -05:00
private aborted = false
2021-06-16 08:14:41 -05:00
private readonly isAbleToUploadVideoWithCache = memoizee((userId: number) => {
2024-02-12 03:47:52 -06:00
return isUserQuotaValid({ userId, uploadSize: 1000 })
2021-06-16 08:14:41 -05:00
}, { maxAge: MEMOIZE_TTL.LIVE_ABLE_TO_UPLOAD })
private readonly hasClientSocketInBadHealthWithCache = memoizee((sessionId: string) => {
return this.hasClientSocketInBadHealth(sessionId)
}, { maxAge: MEMOIZE_TTL.LIVE_CHECK_SOCKET_HEALTH })
constructor (options: {
context: any
user: MUserId
sessionId: string
videoLive: MVideoLiveVideo
2023-05-16 02:12:50 -05:00
inputLocalUrl: string
inputPublicUrl: string
2021-06-16 08:14:41 -05:00
fps: number
2021-08-06 03:39:40 -05:00
bitrate: number
2021-08-06 06:35:25 -05:00
ratio: number
2021-06-16 08:14:41 -05:00
allResolutions: number[]
hasAudio: boolean
2024-03-19 03:53:59 -05:00
probe: FfprobeData
2021-06-16 08:14:41 -05:00
}) {
super()
this.context = options.context
this.user = options.user
this.sessionId = options.sessionId
this.videoLive = options.videoLive
2023-05-16 02:12:50 -05:00
this.inputLocalUrl = options.inputLocalUrl
this.inputPublicUrl = options.inputPublicUrl
2021-06-16 08:14:41 -05:00
this.fps = options.fps
2021-08-06 06:35:25 -05:00
2021-08-06 03:39:40 -05:00
this.bitrate = options.bitrate
2021-10-11 08:59:15 -05:00
this.ratio = options.ratio
2024-03-19 03:53:59 -05:00
this.probe = options.probe
2021-08-06 06:35:25 -05:00
this.hasAudio = options.hasAudio
2021-06-16 08:14:41 -05:00
this.allResolutions = options.allResolutions
this.videoUUID = this.videoLive.Video.uuid
this.saveReplay = this.videoLive.saveReplay
this.outDirectory = getLiveDirectory(this.videoLive.Video)
this.replayDirectory = join(getLiveReplayBaseDirectory(this.videoLive.Video), new Date().toISOString())
2021-06-16 08:14:41 -05:00
this.lTags = loggerTagsFactory('live', this.sessionId, this.videoUUID)
}
async runMuxing () {
2023-01-27 02:04:02 -06:00
this.streamingPlaylist = await this.createLivePlaylist()
this.createLiveShaStore()
2021-06-16 08:14:41 -05:00
this.createFiles()
await this.prepareDirectories()
2021-06-16 08:14:41 -05:00
this.transcodingWrapper = this.buildTranscodingWrapper()
2021-07-23 04:20:00 -05:00
this.transcodingWrapper.on('end', () => this.onTranscodedEnded())
this.transcodingWrapper.on('error', () => this.onTranscodingError())
2021-07-23 04:20:00 -05:00
await this.transcodingWrapper.run()
2021-06-16 08:14:41 -05:00
2023-05-02 06:51:06 -05:00
this.filesWatcher = watch(this.outDirectory, { depth: 0 })
2022-05-25 04:08:12 -05:00
this.watchMasterFile()
this.watchTSFiles()
2021-06-16 08:14:41 -05:00
}
abort () {
if (!this.transcodingWrapper) return
2021-06-16 08:14:41 -05:00
this.aborted = true
this.transcodingWrapper.abort()
2021-06-17 02:40:45 -05:00
}
destroy () {
this.removeAllListeners()
this.isAbleToUploadVideoWithCache.clear()
this.hasClientSocketInBadHealthWithCache.clear()
2021-06-16 08:14:41 -05:00
}
2022-05-25 04:08:12 -05:00
private watchMasterFile () {
2023-05-19 05:01:36 -05:00
this.filesWatcher.on('add', async path => {
2023-05-02 06:51:06 -05:00
if (path !== join(this.outDirectory, this.streamingPlaylist.playlistFilename)) return
if (this.masterPlaylistCreated === true) return
2021-06-16 08:14:41 -05:00
2023-01-27 02:04:02 -06:00
try {
2024-02-12 03:47:52 -06:00
if (this.streamingPlaylist.storage === FileStorage.OBJECT_STORAGE) {
let masterContent = await readFile(path, 'utf-8')
// If the disk sync is slow, don't upload an empty master playlist on object storage
// Wait for ffmpeg to correctly fill it
while (!masterContent) {
await wait(100)
masterContent = await readFile(path, 'utf-8')
}
logger.debug('Uploading live master playlist on object storage for %s', this.videoUUID, { masterContent, ...this.lTags() })
const url = await storeHLSFileFromContent(this.streamingPlaylist, this.streamingPlaylist.playlistFilename, masterContent)
this.streamingPlaylist.playlistUrl = url
}
2023-01-27 02:04:02 -06:00
this.streamingPlaylist.assignP2PMediaLoaderInfoHashes(this.videoLive.Video, this.allResolutions)
await this.streamingPlaylist.save()
} catch (err) {
logger.error('Cannot update streaming playlist.', { err, ...this.lTags() })
}
this.masterPlaylistCreated = true
2021-06-16 08:14:41 -05:00
logger.info('Master playlist file for %s has been created', this.videoUUID, this.lTags())
2021-06-16 08:14:41 -05:00
})
}
2022-05-25 04:08:12 -05:00
private watchTSFiles () {
2021-06-16 08:14:41 -05:00
const startStreamDateTime = new Date().getTime()
const addHandler = async (segmentPath: string) => {
2023-05-02 06:51:06 -05:00
if (segmentPath.endsWith('.ts') !== true) return
logger.debug('Live add handler of TS file %s.', segmentPath, this.lTags())
2021-06-16 08:14:41 -05:00
const playlistId = this.getPlaylistIdFromTS(segmentPath)
2021-06-16 08:14:41 -05:00
const segmentsToProcess = this.segmentsToProcessPerPlaylist[playlistId] || []
2022-05-25 04:08:12 -05:00
this.processSegments(segmentsToProcess)
2021-06-16 08:14:41 -05:00
this.segmentsToProcessPerPlaylist[playlistId] = [ segmentPath ]
if (this.hasClientSocketInBadHealthWithCache(this.sessionId)) {
this.emit('bad-socket-health', { videoUUID: this.videoUUID })
2021-06-16 08:14:41 -05:00
return
}
// Duration constraint check
if (this.isDurationConstraintValid(startStreamDateTime) !== true) {
this.emit('duration-exceeded', { videoUUID: this.videoUUID })
2021-06-16 08:14:41 -05:00
return
}
// Check user quota if the user enabled replay saving
if (await this.isQuotaExceeded(segmentPath) === true) {
this.emit('quota-exceeded', { videoUUID: this.videoUUID })
2021-06-16 08:14:41 -05:00
}
}
const deleteHandler = async (segmentPath: string) => {
2023-05-02 06:51:06 -05:00
if (segmentPath.endsWith('.ts') !== true) return
logger.debug('Live delete handler of TS file %s.', segmentPath, this.lTags())
try {
await this.liveSegmentShaStore.removeSegmentSha(segmentPath)
} catch (err) {
logger.warn('Cannot remove segment sha %s from sha store', segmentPath, { err, ...this.lTags() })
}
2024-02-12 03:47:52 -06:00
if (this.streamingPlaylist.storage === FileStorage.OBJECT_STORAGE) {
try {
await removeHLSFileObjectStorageByPath(this.streamingPlaylist, segmentPath)
} catch (err) {
logger.error('Cannot remove segment %s from object storage', segmentPath, { err, ...this.lTags() })
}
}
}
2021-06-16 08:14:41 -05:00
2023-05-02 06:51:06 -05:00
this.filesWatcher.on('add', p => addHandler(p))
this.filesWatcher.on('unlink', p => deleteHandler(p))
2021-06-16 08:14:41 -05:00
}
private async isQuotaExceeded (segmentPath: string) {
if (this.saveReplay !== true) return false
2022-07-13 08:37:36 -05:00
if (this.aborted) return false
2021-06-16 08:14:41 -05:00
try {
const segmentStat = await stat(segmentPath)
LiveQuotaStore.Instance.addQuotaTo(this.user.id, this.sessionId, segmentStat.size)
2021-06-16 08:14:41 -05:00
const canUpload = await this.isAbleToUploadVideoWithCache(this.user.id)
return canUpload !== true
} catch (err) {
2021-12-07 06:45:01 -06:00
logger.error('Cannot stat %s or check quota of %d.', segmentPath, this.user.id, { err, ...this.lTags() })
2021-06-16 08:14:41 -05:00
}
}
private createFiles () {
for (let i = 0; i < this.allResolutions.length; i++) {
const resolution = this.allResolutions[i]
const file = new VideoFileModel({
resolution,
size: -1,
extname: '.ts',
infoHash: null,
fps: this.fps,
storage: this.streamingPlaylist.storage,
2021-06-16 08:14:41 -05:00
videoStreamingPlaylistId: this.streamingPlaylist.id
})
VideoFileModel.customUpsert(file, 'streaming-playlist', null)
2021-12-07 06:45:01 -06:00
.catch(err => logger.error('Cannot create file for live streaming.', { err, ...this.lTags() }))
2021-06-16 08:14:41 -05:00
}
}
private async prepareDirectories () {
await ensureDir(this.outDirectory)
2021-06-16 08:14:41 -05:00
if (this.videoLive.saveReplay === true) {
await ensureDir(this.replayDirectory)
2021-06-16 08:14:41 -05:00
}
}
private isDurationConstraintValid (streamingStartTime: number) {
const maxDuration = CONFIG.LIVE.MAX_DURATION
// No limit
if (maxDuration < 0) return true
const now = new Date().getTime()
const max = streamingStartTime + maxDuration
return now <= max
}
2022-05-25 04:08:12 -05:00
private processSegments (segmentPaths: string[]) {
Bluebird.mapSeries(segmentPaths, previousSegment => this.processSegment(previousSegment))
.catch(err => {
if (this.aborted) return
logger.error('Cannot process segments', { err, ...this.lTags() })
})
}
2021-06-16 08:14:41 -05:00
private async processSegment (segmentPath: string) {
// Add sha hash of previous segments, because ffmpeg should have finished generating them
await this.liveSegmentShaStore.addSegmentSha(segmentPath)
if (this.saveReplay) {
await this.addSegmentToReplay(segmentPath)
}
2024-02-12 03:47:52 -06:00
if (this.streamingPlaylist.storage === FileStorage.OBJECT_STORAGE) {
try {
await storeHLSFileFromPath(this.streamingPlaylist, segmentPath)
await this.processM3U8ToObjectStorage(segmentPath)
} catch (err) {
logger.error('Cannot store TS segment %s in object storage', segmentPath, { err, ...this.lTags() })
2021-06-16 08:14:41 -05:00
}
}
2022-07-13 08:37:36 -05:00
// Master playlist and segment JSON file are created, live is ready
if (this.masterPlaylistCreated && !this.liveReady) {
this.liveReady = true
this.emit('live-ready', { videoUUID: this.videoUUID })
}
2021-06-16 08:14:41 -05:00
}
private async processM3U8ToObjectStorage (segmentPath: string) {
const m3u8Path = join(this.outDirectory, this.getPlaylistNameFromTS(segmentPath))
logger.debug('Process M3U8 file %s.', m3u8Path, this.lTags())
const segmentName = basename(segmentPath)
const playlistContent = await readFile(m3u8Path, 'utf-8')
// Remove new chunk references, that will be processed later
const filteredPlaylistContent = playlistContent.substring(0, playlistContent.lastIndexOf(segmentName) + segmentName.length) + '\n'
try {
if (!this.objectStorageSendQueues.has(m3u8Path)) {
this.objectStorageSendQueues.set(m3u8Path, new PQueue({ concurrency: 1 }))
}
const queue = this.objectStorageSendQueues.get(m3u8Path)
await queue.add(() => storeHLSFileFromContent(this.streamingPlaylist, m3u8Path, filteredPlaylistContent))
} catch (err) {
logger.error('Cannot store in object storage m3u8 file %s', m3u8Path, { err, ...this.lTags() })
}
}
private onTranscodingError () {
this.emit('transcoding-error', ({ videoUUID: this.videoUUID }))
}
private onTranscodedEnded () {
this.emit('transcoding-end', ({ videoUUID: this.videoUUID }))
2023-05-16 02:12:50 -05:00
logger.info('RTMP transmuxing for video %s ended. Scheduling cleanup', this.inputLocalUrl, this.lTags())
setTimeout(() => {
// Wait latest segments generation, and close watchers
2023-05-02 06:51:06 -05:00
const promise = this.filesWatcher?.close() || Promise.resolve()
promise
.then(() => {
// Process remaining segments hash
for (const key of Object.keys(this.segmentsToProcessPerPlaylist)) {
this.processSegments(this.segmentsToProcessPerPlaylist[key])
}
})
.catch(err => {
logger.error(
'Cannot close watchers of %s or process remaining hash segments.', this.outDirectory,
{ err, ...this.lTags() }
)
})
this.emit('after-cleanup', { videoUUID: this.videoUUID })
}, 1000)
}
2021-06-16 08:14:41 -05:00
private hasClientSocketInBadHealth (sessionId: string) {
const rtmpSession = this.context.sessions.get(sessionId)
if (!rtmpSession) {
2021-12-07 06:45:01 -06:00
logger.warn('Cannot get session %s to check players socket health.', sessionId, this.lTags())
2021-06-16 08:14:41 -05:00
return
}
for (const playerSessionId of rtmpSession.players) {
const playerSession = this.context.sessions.get(playerSessionId)
if (!playerSession) {
2021-12-07 06:45:01 -06:00
logger.error('Cannot get player session %s to check socket health.', playerSession, this.lTags())
2021-06-16 08:14:41 -05:00
continue
}
if (playerSession.socket.writableLength > VIDEO_LIVE.MAX_SOCKET_WAITING_DATA) {
return true
}
}
return false
}
2022-05-25 04:08:12 -05:00
private async addSegmentToReplay (segmentPath: string) {
2021-06-16 08:14:41 -05:00
const segmentName = basename(segmentPath)
const dest = join(this.replayDirectory, buildConcatenatedName(segmentName))
2021-06-16 08:14:41 -05:00
try {
const data = await readFile(segmentPath)
await appendFile(dest, data)
} catch (err) {
2021-12-07 06:45:01 -06:00
logger.error('Cannot copy segment %s to replay directory.', segmentPath, { err, ...this.lTags() })
2021-06-16 08:14:41 -05:00
}
}
2023-01-27 02:04:02 -06:00
private async createLivePlaylist (): Promise<MStreamingPlaylistVideo> {
const playlist = await VideoStreamingPlaylistModel.loadOrGenerate(this.videoLive.Video)
playlist.playlistFilename = generateHLSMasterPlaylistFilename(true)
playlist.segmentsSha256Filename = generateHlsSha256SegmentsFilename(true)
playlist.p2pMediaLoaderPeerVersion = P2P_MEDIA_LOADER_PEER_VERSION
playlist.type = VideoStreamingPlaylistType.HLS
playlist.storage = CONFIG.OBJECT_STORAGE.ENABLED && CONFIG.OBJECT_STORAGE.STREAMING_PLAYLISTS.STORE_LIVE_STREAMS
2024-02-12 03:47:52 -06:00
? FileStorage.OBJECT_STORAGE
: FileStorage.FILE_SYSTEM
2023-01-27 02:04:02 -06:00
return playlist.save()
}
private createLiveShaStore () {
this.liveSegmentShaStore = new LiveSegmentShaStore({
videoUUID: this.videoLive.Video.uuid,
sha256Path: join(this.outDirectory, this.streamingPlaylist.segmentsSha256Filename),
streamingPlaylist: this.streamingPlaylist,
sendToObjectStorage: this.streamingPlaylist.storage === FileStorage.OBJECT_STORAGE
2023-01-27 02:04:02 -06:00
})
}
private buildTranscodingWrapper () {
const options = {
streamingPlaylist: this.streamingPlaylist,
videoLive: this.videoLive,
lTags: this.lTags,
2023-05-22 06:44:22 -05:00
sessionId: this.sessionId,
2023-05-16 02:12:50 -05:00
inputLocalUrl: this.inputLocalUrl,
inputPublicUrl: this.inputPublicUrl,
toTranscode: this.allResolutions.map(resolution => {
let toTranscodeFPS: number
try {
toTranscodeFPS = computeOutputFPS({ inputFPS: this.fps, resolution })
} catch (err) {
err.liveVideoErrorCode = LiveVideoError.INVALID_INPUT_VIDEO_STREAM
throw err
}
return {
resolution,
fps: toTranscodeFPS
}
}),
fps: this.fps,
bitrate: this.bitrate,
ratio: this.ratio,
hasAudio: this.hasAudio,
2024-03-19 03:53:59 -05:00
probe: this.probe,
segmentListSize: VIDEO_LIVE.SEGMENTS_LIST_SIZE,
segmentDuration: getLiveSegmentTime(this.videoLive.latencyMode),
outDirectory: this.outDirectory
}
return CONFIG.LIVE.TRANSCODING.ENABLED && CONFIG.LIVE.TRANSCODING.REMOTE_RUNNERS.ENABLED
? new RemoteTranscodingWrapper(options)
: new FFmpegTranscodingWrapper(options)
}
private getPlaylistIdFromTS (segmentPath: string) {
const playlistIdMatcher = /^([\d+])-/
return basename(segmentPath).match(playlistIdMatcher)[1]
}
private getPlaylistNameFromTS (segmentPath: string) {
return `${this.getPlaylistIdFromTS(segmentPath)}.m3u8`
}
2021-06-16 08:14:41 -05:00
}
// ---------------------------------------------------------------------------
export {
MuxingSession
}