# การปรับตั้งค่า 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 ของรูปภาพวิดีโอ |