# การปรับตั้งค่า Options
การปรับแต่ง ByteArk Player ทำได้ผ่าน Builder 2 ตัว: ByteArkPlayerConfigBuilder สำหรับตั้งค่า Player ทั้งระบบ และ ByteArkPlayerItemBuilder สำหรับกำหนดข้อมูลของวิดีโอที่จะเล่น
# ByteArkPlayerConfigBuilder
ใช้สำหรับตั้งค่าการทำงานของ Player
let config = try ByteArkPlayerConfigBuilder(licenseKey: "YOUR_BYTEARK_PLAYER_SDK_LICENSE")
.item(item)
.autoplay(true)
.build()
1
2
3
4
2
3
4
| Builder method | Type | Description |
|---|---|---|
init(licenseKey:) | String | License key ของ ByteArk Player SDK |
.item(_:) | ByteArkPlayerItem | กำหนดวิดีโอที่จะเล่น |
.autoplay(_:) | Bool | เริ่มเล่นวิดีโออัตโนมัติเมื่อ Player พร้อม |
.playbackEngine(_:) | ByteArkPlayerPlaybackEngine | กำหนด Playback engine แบบ Custom (ดู Playback Engine) |
.addPlugin(plugin:, name:) | ByteArkPlayerPlugin, String | เพิ่ม Plugin เข้า Player |
# ByteArkPlayerItemBuilder
ใช้สำหรับกำหนดข้อมูลวิดีโอแต่ละชิ้น
let item = try ByteArkPlayerItemBuilder()
.media(URL(string: "<MEDIA_URL>")!)
.title("Big Buck Bunny")
.build()
1
2
3
4
2
3
4
| Builder method | Type | Required | Description |
|---|---|---|---|
.media(_:) | URL | Yes | URL ของวิดีโอ (HLS .m3u8 หรือ progressive) |
.title(_:) | String | No | ชื่อวิดีโอ (จำเป็นเมื่อเปิดใช้ Lighthouse) |
.drmDataSource(_:) | ByteArkPlayerDrmDataSource | No | DRM data source สำหรับ FairPlay (ดู Apple FairPlay) |
# Plugin config builders
แต่ละ Plugin มี Config builder ของตัวเอง
| Plugin | Config builder | คู่มือ |
|---|---|---|
| Ads | ByteArkPlayerAdsConfigBuilder(adsTagUrl:) | การเล่นโฆษณา (Advertisement) |
| AirPlay | ByteArkPlayerAirplayConfigBuilder() | Apple AirPlay |
| Lighthouse | ByteArkPlayerLighthouseConfigBuilder(projectId:) | ByteArk Lighthouse |
| Nielsen | ByteArkPlayerNielsenConfigBuilder(...) | Nielsen DCR |
ดูรายละเอียดการตั้งค่าของแต่ละ Plugin ในคู่มือเฉพาะของแต่ละตัว