ซับไตเติ้ล (Subtitle)

ByteArk Player SDK for Android รองรับซับไตเติ้ลที่ฝังมากับ HLS/DASH manifest โดยสามารถปรับแต่งหน้าตาของซับไตเติ้ลและให้ผู้ชมเลือกภาษาได้ผ่าน UI

ตั้งค่าหน้าตาของซับไตเติ้ล

val playerBuilder = ByteArkPlayerBuilder.Builder()
  .withContext(this)
  .withSubtitleSize(SubtitleSize.MEDIUM)
  .withSubtitleBackgroundEnabled(true)
  .withSubtitlePaddingBottomPercentage(10)  // ระยะห่างจากขอบล่าง 10% ของหน้าจอ
  .build()

Builder method	Type	Description
withSubtitleSize(size: SubtitleSize)	enum	ขนาดตัวอักษร (SMALL, MEDIUM, LARGE)
withSubtitleBackgroundEnabled(enabled: Boolean)	Boolean	แสดงพื้นหลังตัวอักษรหรือไม่
withSubtitlePaddingBottomPercentage(percentage: Int)	Int	ระยะห่างจากขอบล่างของหน้าจอ (เป็น %)

เลือกซับไตเติ้ลผ่าน API

// ดูซับไตเติ้ลทั้งหมด
val subtitles: List<ByteArkSubtitle> = mPlayerFragment.getSubtitles()
// ซับไตเติ้ลปัจจุบัน
val current: ByteArkSubtitle? = mPlayerFragment.getCurrentSubtitle()
// เลือกซับไตเติ้ล
mPlayerFragment.setSubtitle(subtitles[0])

รับ Cue ของซับไตเติ้ล

override fun onCues(cues: List<Cue>) {
  // ใช้สำหรับ render ซับไตเติ้ลเอง (ถ้าต้องการ)
}