# ByteArk Lighthouse
ByteArk Player SDK for Flutter รองรับการเก็บสถิติการรับชมวิดีโอผ่าน ByteArk Lighthouse (opens new window) โดยกำหนดผ่าน lighthouseSetting ของ ByteArkPlayerConfig
# การตั้งค่า
final config = ByteArkPlayerConfig(
licenseKey: licenseKey,
playerItem: playerItem,
lighthouseSetting: ByteArkLighthouseSetting(
projectId: "<PROJECT_ID>",
debug: false,
),
);
1
2
3
4
5
6
7
8
2
3
4
5
6
7
8
| Property | Type | Description |
|---|---|---|
projectId | String? | Lighthouse Project ID (ติดต่อ ByteArk เพื่อรับ) |
debug | bool? | เปิดใช้ Debug mode สำหรับการพัฒนา |
# ส่ง Metadata เพิ่มเติม
สำหรับวิดีโอแต่ละชิ้น สามารถส่ง Metadata เพิ่มเติมไปให้ Lighthouse ได้ผ่าน lighthouseMetaData ของ ByteArkPlayerItem
final playerItem = ByteArkPlayerItem(
sources: [
ByteArkPlayerSource(url: "<MEDIA_URL>"),
],
mediaId: "VIDEO_ID",
title: "Big Buck Bunny",
lighthouseMetaData: ByteArkPlayerLighthouseMetaData(
userId: "user-123",
videoTitle: "Big Buck Bunny",
seriesTitle: "Shorts",
season: "1",
episode: "1",
),
);
1
2
3
4
5
6
7
8
9
10
11
12
13
14
2
3
4
5
6
7
8
9
10
11
12
13
14
ทุกฟิลด์ของ Metadata เป็นชนิด String? และเป็น Optional ทั้งหมด
# ฟิลด์เกี่ยวกับผู้ชม
| Field | Type | Description |
|---|---|---|
userId | String? | รหัสประจำตัวผู้ชม |
age | String? | อายุของผู้ชม |
gender | String? | เพศของผู้ชม |
nationality | String? | สัญชาติของผู้ชม |
country | String? | ประเทศของผู้ชม |
city | String? | เมืองหรือจังหวัดของผู้ชม |
lat | String? | ละติจูดของผู้ชม |
long | String? | ลองจิจูดของผู้ชม |
subscriptionPlan | String? | แพ็กเกจสมาชิกของผู้ชม |
accountCreationDate | String? | วันที่สร้างบัญชีผู้ชม |
# ฟิลด์เกี่ยวกับเนื้อหา
| Field | Type | Description |
|---|---|---|
videoTitle | String? | ชื่อวิดีโอ |
seriesId | String? | รหัสซีรีส์ |
seriesTitle | String? | ชื่อซีรีส์ |
season | String? | หมายเลขซีซัน |
episode | String? | หมายเลขตอน |
subEpisode | String? | หมายเลขตอนย่อย |
duration | String? | ความยาวของวิดีโอ |
publishedDate | String? | วันที่เผยแพร่เนื้อหา |
genres | String? | หมวดหมู่ของเนื้อหา (คั่นด้วยจุลภาคหากมีหลายหมวด) |
rating | String? | เรตติ้งของเนื้อหา (เช่น PG-13) |
# ฟิลด์กำหนดเอง
| Field | Type | Description |
|---|---|---|
d1 – d10 | String? | ฟิลด์ Custom dimension สำหรับเก็บสถิติเพิ่มเติมตามต้องการ |
Note
การใช้งาน Lighthouse ต้องระบุ mediaId และ title ของ ByteArkPlayerItem เสมอ