Event Listeners Reference

ByteArk Player ส่ง Event ต่างๆ ผ่าน Player instance ซึ่งสามารถลงทะเบียน Listener เพื่อรับ Event เหล่านั้นได้

Note

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

การใช้งาน

player.on(type, fn)

เพิ่ม Event listener ที่จะทำงานทุกครั้งเมื่อ Event ที่ subscribe ไว้เกิดขึ้น

Parameters

Attribute	Description	Type
type	ชนิดของ Event ที่ต้องการ subscribe	String
fn	Function ที่จะถูกเรียกเมื่อ Event เกิดขึ้น	Function

player.one(type, fn)

เพิ่ม Event listener ที่จะทำงานครั้งเดียวเมื่อ Event ที่ subscribe ไว้เกิดขึ้น

Parameters

Attribute	Description	Type
type	ชนิดของ Event ที่ต้องการ subscribe	String
fn	Function ที่จะถูกเรียกเมื่อ Event เกิดขึ้น	Function

player.off(type, fn)

ลบ Event listener ที่ถูกเพิ่มผ่าน player.on หรือ player.one

Parameters

Attribute	Description	Type
type	ชนิดของ Event ที่ต้องการ unsubscribe	String
fn	Function ที่ลงทะเบียนไว้	Function

ตัวอย่าง

player.on('play', function() {
  console.log('เริ่มเล่นวิดีโอ');
});
player.one('ready', function() {
  console.log('Player พร้อมใช้งาน (เรียกครั้งเดียว)');
});

Lifecycle events

Event	Description
ready	เกิดขึ้นเมื่อ Video Player พร้อมที่จะใช้งาน
firstplay	เกิดขึ้นเมื่อมีการเล่นวิดีโอครั้งแรก
play	เกิดขึ้นเมื่อมีการเริ่มเล่นวิดีโอ
pause	เกิดขึ้นเมื่อมีการหยุดเล่นวิดีโอชั่วคราว
ended	เกิดขึ้นเมื่อเล่นวิดีโอจนจบ

Buffer & seek events

Event	Description
seeking	เกิดขึ้นเมื่อผู้ชมทำการ Seek วิดีโอ
waiting	เกิดขึ้นเมื่อ Video Player กำลังรอโหลดข้อมูล (Buffer)

Progress events

Event	Description
timeupdate	เกิดขึ้นเมื่อมีการเปลี่ยนตำแหน่งปัจจุบันของการเล่นวิดีโอ (current playback position)
ratechange	เกิดขึ้นเมื่อมีการเปลี่ยนความเร็วในการเล่นวิดีโอ

UI events

Event	Description
fullscreenchange	เกิดขึ้นเมื่อเข้าหรือออกโหมด Fullscreen
volumechange	เกิดขึ้นเมื่อมีการปรับระดับเสียง
enterpictureinpicture	เกิดขึ้นเมื่อเข้าโหมด Picture-in-Picture
leavepictureinpicture	เกิดขึ้นเมื่อออกจากโหมด Picture-in-Picture

Error event

Event	Description
error	เกิดขึ้นเมื่อมี Error เกิดขึ้นกับ Player