# การปรับตั้งค่า Options

# การปรับตั้งค่าผ่าน options

ในการปรับตั้งค่าของ ByteArk Player นั้นสามารถทำได้โดย options ขณะเรียกเมธอด byteark เพื่อสร้างตัวเล่นวิดีโอ โดยมี options หลักๆ ดังนี้

Name Type Default Description
autoplay Boolean/String - เริ่มเล่นวิดีโออัตโนมัติ สามารถดูข้อมูลเพิ่มเติมได้จากหัวข้อ การเล่นวิดีโออัตโนมัติ
autoplayadsmuted Boolean false ยอมให้เริ่มเล่นวิดีโออัตโนมัติและปิดเสียง เมื่อมีโฆษณา preroll สามารถดูข้อมูลเพิ่มเติมได้จากหัวข้อ การเล่นวิดีโออัตโนมัติ
audioOnlyMode Boolean false ถ้าตั้งค่าเป็น true จะทำการซ่อน UI ต่างๆยกเว้น Control Bar ใช้สำหรับการเล่นไฟล์เสียงอย่างเดียว
audioPosterMode Boolean false ถ้าตั้งค่าเป็น true จะทำการแสดงภาพปก (poster image) แทนการเล่นวิดีโอ ใช้สำหรับการเล่นไฟล์เสียงอย่างเดียว
muted Boolean - เล่นวิดีโอแบบปิดเสียง
volume Number - ระดับเสียงของวิดีโอมีค่าระหว่าง 0 ถึง 1
aspectRatio String - กำหนดอัตราส่วนภาพของวิดีโอ (16: 9) ใช้เมื่อมีการตั้งค่า fluid: true
controls Boolean true แสดงหรือซ่อน แถบควบคุม
fluid Boolean - ใช้การแสดงผล layout แบบ fluid (video player จะขยายขนาดจนเต็ม container)
loop Boolean - เริ่มเล่นวิดีโอใหม่เมื่อเล่นจบ
playsinline Boolean true แสดงผลวิดีโอแบบ inline
preload String - ตั้งค่าให้ web browser preload วิดีโอหรือไม่ สามารถมีค่าเป็น auto : preload วิดีโอทันทีถ้าหาก web browser รองรับ none : ไม่ทำการ preload วิดีโอจนกว่าจะเริ่มเล่น
liveui Boolean - เปิด/ปิด seekbar เมื่อเล่นวิดีโอ Live Stream แบบ DVR
autoSeekToLiveEdge Boolean - seek ไปที่เวลาล่าสุดของ live stream หลังจากมีการ pause และ play live stream
closedCaptionButton Boolean false แสดงปุ่ม Close Caption/Subtitle ที่ control bar ถ้าหากวิดีโอมีซับไตเติ้ล
downloadUrl String - แสดงปุ่ม Download ที่ control bar เมื่อมีการใส่ url สำหรับดาวน์โหลดไฟล์
poster String - URL ของรูปภาพสำหรับแสดงผลก่อนเริ่มเล่นวิดีโอ
sources Object/Array - Source ของวิดีโอที่ใช้เล่น (ดูตัวอย่าง source object)
plugins Object - ปลั๊กอินเพิ่มความสามารถในการใช้งานของ ByteArk Player
errors Object - แสดงรูปภาพเมื่อมี error เกิดขึ้นตาม http status code (ตูตัวอย่าง error object)
xhrSetup Function - xhr setup function (xhr: XMLHttpRequest, url: string) => void

Note

เนืองจาก ByteArk Player พัฒนาโดยมีพื้นฐานมาจาก Video.js ทำให้สามารถใช้งาน options ต่างๆ ของ Video.js ได้ ซึ่งสามารถดู options ทั้งหมดได้จากเอกสารของ Video.js (opens new window)

# Source object

Name Type Required Description
src String Yes URL ของวิดีโอ
type String Yes ประเภทของวิดีโอ
title String No ชื่อของวิดีโอที่จะนำมาแสดงบน video player * Required เมื่อเปิดใช้งาน ByteArk Lighthouse
subtitle String No ชื่อตอน หรือรายละเอียดสั้นๆของวิดีโอ
videoId String No ไอดีของวิดีโอในระบบ ByteArk * Required เมื่อเปิดใช้งาน ByteArk Lighthouse
poster String No URL ของรูปภาพวิดีโอ