說明中心
常見問答
點數、方案、線路、播放連結與裝置如何運作,以及無法播放時該檢查什麼。
第 139 項,共 139 個問題
如何使用本頁
每個問題都有固定代碼(例如LINE-07)。聯絡客服時請附上該代碼,或複製問題的連結。
選單、按鈕與欄位名稱與面板顯示的相同。使用者(user)是登入面板的帳號(管理員、經銷商);線路(line)是觀眾的 IPTV 訂閱。兩者絕不混用。
- 觀眾 經銷商可將此解答原文轉給觀眾
- 管理員 適用於面板的營運者
服務概覽與各方職責
GENGEN-01 這項服務提供什麼?
一套完整的 OTT / IPTV 系統:管理面板(dashboard)、供觀眾應用程式使用的 API 伺服器、直播頻道、電影、影集與廣播的傳送,以及網頁播放器。我們提供並維護系統;經銷商使用它讓客戶取得觀看權利(線路)。
GEN-02 這項服務不做什麼?
GEN-03 系統中各角色是誰?
| 角色 | 身分 | 登入位置 |
|---|---|---|
| Admin(管理員) | 面板的營運者 | dashboard |
| Reseller(經銷商) | 銷售線路;從管理員取得點數 | dashboard、Reseller API |
| Sub-reseller(子經銷商) | 建立在另一位經銷商之下的經銷商 | dashboard、Reseller API |
| Line(線路) | 訂閱者,即最終觀眾 | IPTV 應用程式、機上盒、網頁播放器。絕不登入 dashboard |
GEN-04 頻道要經過哪些步驟才到達觀眾?
- 管理員建立內容目錄(頻道、電影、影集、廣播)並將其分組為頻道包(bouquet)。
- 管理員建立方案(package):頻道包 + 期限 + 連線數 + 以點數計的價格。
- 經銷商花費點數銷售方案 → 系統建立一條線路。
- 客戶在應用程式中輸入線路的資料;系統檢查該線路(未過期、已啟用、在限制範圍內),並從適當的伺服器播放。
GEN-05 經銷商能對內容做什麼,不能做什麼?
GEN-06 我可以在哪裡取得支援?
側邊欄的Support項目會開啟獨立的支援網站。面板本身沒有工單系統。送出請求時請附上:線路的使用者名稱(切勿附密碼)、發生時間、應用程式 / 裝置,以及您已嘗試過的本頁問題代碼。
GEN-07 介面有哪些語言?
面板、網頁播放器與本說明頁都有語言切換器,共 27 種語言。英文與越南文為基準翻譯;其他語言中,新增的畫面可能暫時維持英文。面板寄出的電子郵件目前僅有英文。
面板帳號與登入
ACCACC-01 為什麼我的客戶無法登入 dashboard?
這是設計使然:線路不是面板帳號。客戶只會在 IPTV 應用程式、機上盒或網頁播放器中使用線路的資料。反過來說,經銷商帳號也不能用來觀看頻道。
ACC-02 我看到的選單比本頁描述的少,為什麼?
選單與操作取決於管理員給您帳號的群組。群組沒有權限的頁面不會顯示在側邊欄,也無法開啟。請向管理員申請更多權限。
ACC-03 在哪裡變更我的面板密碼?
在帳號區(個人資料 → 變更密碼)。面板密碼以雜湊儲存,沒有人能讀回,連管理員也不行。若忘記密碼,請上層帳號(您的上層經銷商或管理員)為您設定新密碼。
ACC-04 為什麼更換網路後我就被登出?
面板可設定為在 IP 位址變更時結束工作階段,避免被竊取的工作階段遭重複使用。請重新登入。這是管理員的設定。
ACC-05 多次輸入錯誤的登入資料會怎麼樣?
面板會限制登入失敗的次數(由管理員設定)。超過上限後,需要等待一段時間才能再試。
ACC-06 示範帳號與正式帳號有何不同?
示範帳號僅供瀏覽介面:不能變更密碼、編輯個人資料、建立啟用碼,也不能執行任何無法復原的操作。
ACC-07 我的帳號顯示為「已停用」,這是什麼意思?
您的上層帳號將其關閉:您無法登入面板,您的 API 金鑰也會被拒絕。已售出的線路不會被刪除。請聯絡您的上層帳號。
點數
CRDCRD-01 什麼是點數?
面板的預付單位。每次銷售(建立線路、續約、建立啟用碼、建立子經銷商)都會依方案價格或群組費用扣除點數。點數不是金錢,面板也不做換算:一點數值多少,由您與上層帳號自行約定。
CRD-02 如何儲值點數?
點數由上往下流動:管理員給經銷商點數,經銷商再轉給子經銷商。向上層帳號付款是在面板之外進行。
CRD-03 扣的是誰的點數?
一律是執行該操作的帳號的點數,即使線路被指派給下層的子經銷商也一樣。
CRD-04 在哪裡查看我的點數紀錄?
Credits頁面:每筆異動一列,包含日期、金額、異動後餘額、原因與操作者。這是帳本,也是您餘額的權威來源。
CRD-05 點數不足會怎麼樣?
整個操作會被拒絕:不會建立線路,也不會扣款。餘額不會變成負數。
CRD-06 如果我按了兩次儲存或網路中斷,會被重複扣款嗎?
不會。每個銷售請求都帶有請求 ID(request_id);再次送出相同的 ID 會回傳先前的結果。建立線路與扣除點數永遠一起成功或一起取消。
CRD-08 我可以收回已轉給子經銷商的點數嗎?
可以:在子經銷商的編輯表單中,於點數轉移欄位輸入負數。任何餘額都不會低於 0。
CRD-09 如何事先知道我能買幾條線路?
線路表單的方案選擇器會顯示您自己的價格。透過 API,pricing操作會回傳您的餘額、各方案的價格,以及您負擔得起的數量。
方案、頻道包與價格
PKGPKG-01 頻道包與方案有何不同?
頻道包(bouquet)是內容清單(頻道、電影、影集)。方案(package)是您銷售的產品:一個或多個頻道包、期限、連線數、輸出格式、鎖定,以及以點數計的價格(正式價與試用價)。
PKG-02 為什麼我看不到某個方案?
方案只能由管理員為其選定的群組銷售。不是給您群組的方案不會出現在選擇器中,透過 API 送出時也會被拒絕。
PKG-03 我的價格與方案價格不同,為什麼?
管理員可以為每位經銷商對每個方案設定專屬價格(0 = 免費)。專屬價格適用於建立正式線路、續約與正式啟用碼;不適用於試用。
PKG-04 管理員變更方案的頻道包後,已售出的線路也會改變嗎?
不會。頻道包在銷售時就已複製到線路中;之後編輯方案不會影響已售出的線路。線路會在下次續約 / 變更方案時取得方案的新頻道包。(當頻道包內部的內容變更時,持有該頻道包的每條線路會立即看到。刪除頻道包會從每條線路與方案中移除其 ID。變更全域頻道包順序時,只有在您勾選「apply to sold lines and packages」方塊時,才會改變已售線路上儲存的順序;線路的頻道包組合不會改變。)
PKG-05 我可以只銷售方案的一部分嗎?
只有在您的群組開啟Allow Bouquet Selection時才行:勾選方案中的部分頻道包;未勾選任何項目 = 整個方案;方案以外的頻道包會被捨棄。價格不變。
PKG-06 線路的哪些屬性由方案決定?
PKG-07 什麼是「MAG only」/「Enigma only」方案?
只能銷售給該類型機上盒的方案;不能用於一般線路或另一種裝置類型。反過來說,方案必須允許該裝置類型,才能用於 Add MAG / Add Enigma 表單。
線路:建立、編輯、續約、刪除
LINELINE-01 建立線路需要什麼?
您必須選擇群組可銷售的方案,且點數足夠。使用者名稱 / 密碼:自行輸入(群組允許時),或留空讓系統產生。管理員建立線路時也可以將其中一項(或兩項)留空:系統會產生 10 個字元,並在儲存後立即顯示;編輯表單仍需要使用者名稱。
LINE-02 為什麼我不能自己選擇使用者名稱 / 密碼?
您的群組關閉了Allow Username Change/Allow Password Change:新線路會使用系統產生的值。當您可以自行輸入時,最小長度由群組設定(預設為 8 個字元)。
LINE-03 在哪裡可以再次看到線路的密碼?
在線路的編輯表單,以及 Lines 清單的Generate play link對話框中。線路密碼以可讀形式保存,因為 IPTV 應用程式與播放清單連結需要它們。產生的密碼會在儲存後立即顯示。
LINE-04 舊線路沒有顯示密碼,客戶也無法登入?
部分由舊版面板建立的線路只保存了雜湊密碼。這類線路無法登入,面板也不會顯示其密碼。請在線路的編輯表單設定新密碼,並將它傳給客戶。
LINE-05 銷售後,經銷商可以編輯線路的哪些內容?
啟用 / 停用、經銷商備註、聯絡方式、分類範本、擁有者(在您自己的階層內);群組允許時可改使用者名稱與密碼;群組開啟Allow Line Restrictions時可改限制(IP、user agent、ISP 鎖定);群組允許時可在方案範圍內重新選擇頻道包。方案、到期日、連線數、試用標記、輸出格式、裝置鎖定與國家不能直接編輯,只能透過續約 / 變更方案來改變。
LINE-06 如何續約線路?
兩種方式,同一條規則:
- 清單中的Renew (charged)按鈕:使用線路目前的方案;
- 編輯表單的Extend with package欄位:選擇任何您可銷售的方案(這也是變更方案的方式)。
當您編輯線路並在同一次儲存中選擇續約時,兩者是同一筆交易:若續約被拒絕(點數不足、方案不可銷售),編輯也不會儲存,也不會扣點數。修正後再儲存一次。
LINE-07 續約時會保留剩餘時間嗎?
- 線路尚未過期且新方案與舊方案相容→ 時間加在目前的到期日上。
- 線路已過期,或兩個方案不相容 → 從今天起算;剩餘時間不保留。
只有在新方案開啟相容性檢查選項時才會檢查「相容」:兩個方案必須有相同的頻道包、輸出格式、連線數、restreamer 標記與裝置鎖定。選項關閉時一律視為相容。新方案預設開啟此選項(管理員可關閉);既有方案維持原本的設定。MAG / Enigma 線路只能以允許該類機上盒的方案續約或變更。
LINE-08 變更方案(升級 / 降級)如何計費?
變更方案 = 購買新方案的一個正式期間:收取新方案的全額價格(若有專屬價格則為專屬價格),未使用的部分不折抵。線路會採用新方案的所有屬性。
LINE-09 停用與刪除線路有何不同?
LINE-10 線路狀態各代表什麼意思?
| 狀態 | 意義 | 誰能解除 |
|---|---|---|
| Active | 可使用 | — |
| Disabled | 被經銷商 / 擁有者關閉 | 經銷商 |
| Banned | 被管理員鎖定 | 僅管理員 |
| Expired | 已超過到期日 | 續約 |
| Trial | 試用線路,試用期結束前可使用 | 續約後成為正式線路 |
LINE-11 線路過期時會怎麼樣?
在線路續約前,客戶會被拒絕(同時過期又被封鎖的線路會看到「已過期」的影片,因為先檢查到期);進行中的連線會在約一分鐘內關閉。線路不會自動刪除:續約後它會以相同的使用者名稱 / 密碼恢復運作。
LINE-12 我可以將線路交給子經銷商嗎?
可以:選擇您下層的帳號作為擁有者。擁有者會在自己的清單中看到該線路。點數仍然由按下儲存的人負擔。
LINE-13 我能看到誰的線路?
您自己的,以及您下層每個帳號的線路。不在您階層內的線路對您而言不存在(回應為「not found」)。
LINE-14 「Contact」與「Reseller notes」欄位是做什麼用的?
讓您記住客戶是誰(電子郵件、電話號碼、訂單編號)。訂閱者永遠看不到這些內容。線路被刪除時,它們會被永久清除。
LINE-15 我可以看到線路正在觀看什麼、從哪裡觀看嗎?
群組具備權限時:Logs → Line Activity顯示每條線路的觀看紀錄,Logs → Live Connections顯示您階層內各線路所有開啟的連線(哪條線路、哪個頻道、來自哪個位址),並附有關閉連線的按鈕。只有在管理員為您的群組開啟檢視客戶連線紀錄的選項(群組表單中的client connection logs方塊)時,Live Connections 才能開啟;您永遠看不到階層以外線路的連線。
LINE-17 線路表單的到期日包含時間嗎? 管理員
包含。線路表單的Expires on欄位是以面板時區表示的日期與時間,因此線路可以在特定的整點到期。開啟表單後不動此欄位直接儲存,會精確保留到秒的到期時間,編輯備註或頻道包不會讓以小時計的試用線路多出時間。無法讀取的值會在欄位本身回報,絕不會變成「永不過期」。批次編輯頁面仍然接受日期,並視為該日結束。
試用
TRITRI-01 我何時可以建立試用線路?
當以下所有條件都成立時:管理員沒有對經銷商關閉試用;方案有試用期;您的群組Allowed Trials> 0;您的點數 ≥ 群組的Minimum Trial Credits;且您在計算期間內建立的試用線路數尚未達到配額。
TRI-02 試用配額以哪個期間計算?
依群組設定:day= 最近 24 小時,month= 最近 30 天。例如配額為每天 5 條:任何 24 小時內最多 5 條試用線路。較早的試用離開該期間後,就會釋出名額。
TRI-03 試用要花點數嗎?
恰好是方案的試用價(通常為 0)。經銷商的專屬價格不適用於試用。
TRI-05 如何將試用轉為正式線路?
以方案為線路續約:線路會取得正式期間,不再是試用。使用者名稱與密碼維持不變,客戶不必重新設定任何東西。
播放連結、應用程式與格式
PLAYPLAY-01 在哪裡取得要給客戶的連結?
Lines → Generate play link:選擇格式;連結會以線路的使用者名稱與密碼建立。透過 API,get_line會直接回傳現成的連結:m3u、m3u_hls、xmltv、player_api、web_player。
PLAY-02 客戶可以使用哪些應用程式? 觀眾
任何支援Xtream Codes API的應用程式(IPTV Smarters、TiviMate、XCIPTV、GSE…):輸入伺服器位址 + 使用者名稱 + 密碼。只接受播放清單的應用程式請使用M3U連結。MAG機上盒使用 portal,Enigma2機上盒使用播放清單 / 外掛。沒有任何裝置時,可在瀏覽器中使用網頁播放器。
PLAY-03 MPEG-TS 還是 HLS?
MPEG-TS:換台快速,適合 IPTV 應用程式與機上盒。HLS:在瀏覽器、Apple 裝置與不穩定的網路上表現良好。線路只能使用其方案允許的格式;不被允許的格式的連結會被拒絕。
PLAY-04 有哪些播放清單類型?
m3u_plus(含台標、群組、EPG ID,建議的預設值)、一般的m3u、適用於 Enigma2 / DreamBox / GigaBlue / Octagon / MediaStar / StarLive 的類型,以及簡易清單類型。請在 Generate play link 對話框中選擇。
PLAY-05 節目表(EPG)從哪裡來? 觀眾
Xtream 應用程式會自行取得。M3U 應用程式請使用線路的XMLTV連結(m3u_plus播放清單已包含 EPG 位址)。
PLAY-06 有 catch-up(回看)嗎? 觀眾
有,在管理員啟用存檔的頻道上;應用程式會在這些頻道上顯示回看圖示。
PLAY-07 網頁播放器在哪裡,如何登入? 觀眾
位於 API 伺服器的/player/(web_player連結)。以線路的使用者名稱 / 密碼或啟用碼登入。
PLAY-08 變更線路密碼後,舊連結還能用嗎?
不能。密碼是連結的一部分,並儲存在應用程式中;變更密碼後,客戶必須重新輸入 / 取得新連結。這也是中斷未經授權使用線路者的方法。
PLAY-09 我可以使用自己的網域作為播放連結嗎?
可以:在 API 金鑰頁面設定Your own play address(或使用set_play_baseAPI 操作)。您要將網域的 DNS 指向面板的 API 伺服器,而且營運者也要設定他們那一端;使用前請先告知管理員。此位址適用於 API 回傳給您系統的連結。
MAG / Enigma2 機上盒
DEVDEV-01 如何新增 MAG / Enigma 機上盒?
Devices → Add MAG / Add Enigma:輸入 MAC,選擇方案。系統會一步完成銷售新線路並附加裝置;裝置以 MAC 登入,無需任何人輸入使用者名稱 / 密碼。點數的扣除方式與一般線路完全相同。
DEV-02 客戶已有線路,想再加一台機上盒?
在裝置表單中,選擇客戶的既有線路而非方案:裝置會與該線路配對,免費。客戶繼續在應用程式中使用該線路;機上盒會跟隨線路的方案、到期日、頻道包與狀態。
DEV-03 配對的應用程式與機上盒如何計算連線數?
它們共用連線數限制:應用程式與機上盒是同一位訂閱者。
DEV-04 如何為機上盒續約?
為其線路續約(連結在裝置表單上)。對於配對的裝置,請為客戶的線路續約,機上盒會自動跟隨。
DEV-05 客戶把機上盒換成新的?
編輯裝置上的 MAC。若線路開啟了裝置鎖定,請清除已記錄的序號 / 裝置 ID,讓新機上盒可以註冊。
DEV-06 刪除裝置會刪除線路嗎?
會。如同舊版面板,刪除裝置也會刪除其線路(連同連線紀錄與待處理事件)。若要保留已付費的線路,請使用Convert to line按鈕:裝置會被移除,線路成為一般線路。當您刪除客戶的線路時,配對的裝置會以自己的線路獨立繼續運作。
DEV-07 經銷商可以遠端控制機上盒嗎?
對自己的MAG機上盒可以:傳送訊息到電視、播放頻道、重新載入 portal、重新開機、關閉線路的連線(群組需有檢視客戶連線紀錄的權限)、重設已記錄的 ISP 並重設 STB 鎖定。Enigma機上盒的 X-Plugin 指令與螢幕截圖、封鎖裝置,以及將裝置移到另一條線路,僅限管理員。啟用 / 停用經銷商的裝置會啟用 / 停用其線路;經銷商無法解除裝置的Banned狀態。
啟用碼
CODECODE-01 啟用碼有什麼用途?
以代碼方式銷售使用權(刮刮卡、以訊息傳送的代碼):客戶在應用程式或網頁播放器中輸入代碼即可觀看,不需要使用者名稱 / 密碼。期間從客戶第一次啟用代碼時才開始計算。
CODE-02 如何建立啟用碼,費用是多少?
Active Codes → New:選擇方案、數量(每批 1–500)、代碼長度(6–24)、純數字選項(用電視遙控器容易輸入)、試用選項。點數在建立時扣除 = 方案價格 × 代碼數量。每個代碼都附帶一條專屬線路,在啟用前處於鎖定狀態。
CODE-03 代碼包含哪些字元?
大寫字母與數字,不含容易混淆的字元(0、O、1、I);或僅有數字。客戶輸入小寫仍會被接受。
CODE-04 一個代碼可以用在幾台裝置上? 觀眾
一台。代碼會綁定第一台啟用它的裝置;其他裝置輸入相同代碼會被拒絕。該裝置可以重複輸入代碼,線路的登入資料不會改變。
CODE-05 如果客戶更換裝置怎麼辦?
對該代碼執行Reset device;新裝置就可以啟用它。期間不會增加時間。
CODE-06 客戶輸入代碼時出現錯誤,代表什麼意思? 觀眾
CODE-07 如何延長已啟用的代碼?
在Active Codes頁面勾選代碼,選擇Extend (days)操作並輸入天數。只有已啟用的代碼才會增加天數(未使用的代碼期間尚未開始);仍有效的代碼從目前的到期日起延長,已過期的從現在起算。此操作不扣點數。透過 API:extend_active_code。
CODE-08 刪除代碼時會退還點數嗎?
經銷商建立的未使用代碼:全額退還,並在點數帳本留下一列紀錄。已啟用的代碼:不退款。
CODE-09 如何一次管理大量代碼?
Batches頁面會顯示每一批的總數 / 就緒 / 已啟用 / 已停用,並可匯出 TXT 檔(每行一個代碼)。批次操作:啟用、停用、重設裝置、刪除。
連線數限制與保護線路的鎖定
SECSEC-01 「Max connections」如何計算?
指同一條線路同時觀看的裝置數量。0 = 無限制。在同一台裝置上再次開啟您正在觀看的頻道,不算另一個連線。
SEC-02 超過上限時,誰會被中斷? 觀眾
預設:新的連線可進入,最舊的連線被關閉(優先關閉來自同一裝置的連線,其次是同一 IP)。被關閉的播放器約在 30 秒內停止。管理員可改為拒絕新連線,而不是關閉舊連線。
SEC-03 「第二 IP」規則是什麼?
管理員開啟時:當線路正從某個 IP 觀看,來自另一個 IP 的直播連線會被拒絕。此規則可限制於連線數少的線路(例如 1 個連線的線路;連線數無限的線路只有在門檻為 0 時才會被綁定)。開啟Match The Address By Network時,同一個 /24 網路(IPv6:/64)的位址視為同一位觀眾。這是防止帳號共用的工具。
SEC-04 我可以將線路限制在特定 IP 或應用程式嗎?
群組開啟Allow Line Restrictions時:Allowed IPs欄位(IP、CIDR 範圍或網域名稱,每行一個;網域在連線時才會查詢,因此動態 IP 仍可使用)與Allowed User-Agents。留空 = 全部允許。注意:這些限制是在播放時阻擋;應用程式仍可登入並顯示頻道清單。
SEC-05 ISP 鎖定是什麼?
線路會記住第一次連線的網路服務供應商,並拒絕來自其他供應商的使用。客戶更換供應商時,請將 ISP 鎖定關閉再開啟,以記錄新的供應商。此功能不適用於 MAG 機上盒。
SEC-06 裝置鎖定是什麼?
它會將線路綁定到第一台登入的機上盒(序號、裝置 ID);其他機上盒會被拒絕。由方案決定。
SEC-07 國家限制如何運作?
線路只能從其強制國家連線(ALL= 任何地方)。留空時,套用面板的一般允許國家清單。出國旅行或使用 VPN 的客戶可能因此被拒絕。
SEC-08 為什麼 IP 位址被封鎖? 觀眾
- 自動:同一個 IP 在短時間內以許多不同的使用者名稱 / 啟用碼登入失敗,或大量湧入請求。自動封鎖會在管理員設定的時間後自行解除(預設 60 分鐘)。
- 手動:管理員封鎖了該 IP / IP 範圍;不會過期。
IP 被封鎖期間,沒有任何線路能從該 IP 連線。重複輸錯同一個使用者名稱不會造成封鎖。
SEC-09 連線還可能因為哪些其他原因被封鎖?
管理員可以依User-Agent(應用程式)、網路服務供應商(ISP)與ASN(例如主機代管 / VPN 範圍)封鎖。管理員為其開啟「bypass UA」的線路會略過應用程式封鎖清單。
SEC-10 什麼是 restreamer?
提供給夥伴的線路,夥伴會拉取串流再轉發。它不受連線數限制、第二 IP 規則、長時間連線自動結束與 ASN 封鎖的約束。由方案 / 管理員決定;不適用於一般觀眾。
SEC-11 非常長時間的連續連線會被切斷嗎? 觀眾
管理員可以設定連續連線的最長時間;超過後連線會被關閉,客戶按下播放即可繼續。訊號中斷約 90 秒的連線也視為已關閉。
子經銷商
SUBSUB-01 我可以建立子經銷商嗎?
當您的群組開啟Can Create Sub-Resellers,且Groups for sub-resellers中至少有一個群組時。每次建立都會扣除群組上設定的建立費用(點數)。經銷商階層最多 5 層。
SUB-02 子經銷商屬於哪個群組,可以做什麼?
您從管理員允許的清單中選擇一個群組;該群組決定子經銷商的權限、可銷售的方案與試用配額。
SUB-03 我可以對子經銷商管理什麼?
電子郵件、名稱、密碼、狀態、群組(從清單中選擇)、備註、轉移 / 收回點數,以及其下的所有線路。您無法變更其角色或擁有者。
SUB-04 子經銷商能看到我的什麼內容?
什麼都看不到:每個帳號只能看到自己以下的內容,看不到上層或其他分支。
SUB-05 刪除子經銷商時,它的線路與點數會到哪裡?
群組需開啟Can Delete Users。剩餘的點數、線路與下層帳號會轉移給執行刪除的帳號。客戶的線路持續運作。被刪除帳號的個人資料(使用者名稱、電子郵件、名稱、密碼、API 金鑰、備註)會被清除;該使用者名稱與電子郵件可以再次使用。
SUB-06 新的子經銷商會收到電子郵件嗎?
管理員啟用歡迎郵件時:新帳號會收到其登入名稱與登入連結。郵件絕不包含密碼,密碼需由您自己傳給對方。
分類範本
CATCAT-01 分類範本有什麼用途?
用來重新排序、重新命名或隱藏客戶在應用程式中看到的分類(直播、電影、影集、廣播),可針對每條線路設定,而不影響面板本身的分類。
CAT-02 隱藏分類會怎麼樣?
該分類的所有內容也會從使用該範本的線路的應用程式與播放清單中隱藏。
CAT-03 編輯範本時,使用它的線路會改變嗎?
會,所有被指派該範本的線路會立即改變。刪除範本時,其線路會恢復為預設版面。
CAT-04 我可以看到並編輯哪些範本?
可檢視:您自己的、下層帳號的、系統範本,以及上層共用的範本。可編輯:只有您自己的與下層的。若要調整系統範本,請複製它並編輯副本。
CAT-05 有哪些值得知道的限制?
自訂的分類順序不適用於 M3U 播放清單的電影 / 影集部分(名稱與隱藏仍然適用)。使用 Xtream API 的應用程式會取得全部內容。
Reseller API、API 金鑰、webhook
APIAPI-01 Reseller API 有什麼用途?
讓您自己的系統(網路商店、帳務、機器人)無需開啟 dashboard 即可銷售與管理線路 / 子經銷商。位址:{API}/reseller/v1,以X-API-Key標頭驗證。完整文件位於 API 伺服器的/docs/。
API-02 在哪裡取得 API 金鑰?
API Key頁面。金鑰只會在建立時顯示一次,請立即複製。若遺失,請建立新的金鑰(舊的會失效)。
API-03 所有系統都應該使用同一把金鑰嗎?
最好不要。為每個系統建立一把額外金鑰:給它一個名稱,限制可使用它的 IP / CIDR,可選擇設為唯讀(僅能列出與檢視),並可單獨撤銷而不影響其他金鑰。
API-04 API 可以做什麼?
| 需求 | 操作 |
|---|---|
| 餘額、價格、可負擔的數量、使用者名稱 / 試用規則 | user_info、pricing、packages |
| 線路 | get_lines、get_line、create_line、renew_line、change_package、edit_line、enable_line、disable_line、delete_line |
| 子經銷商 | get_users、get_user、create_user、edit_user、adjust_credits、enable_user、disable_user、delete_user |
| 啟用碼 | 建立、列出、啟用 / 停用、重設裝置、刪除 |
| Webhook、自有播放位址、API 呼叫紀錄 | create_webhook…、set_play_base、api_logs |
dashboard 的每一條規則(群組、專屬價格、試用配額、階層範圍)在 API 中都以完全相同的方式適用。
API-05 網路錯誤後重試,會被重複扣款嗎?
不會,只要對同一筆交易送出相同的request_id:系統會回傳先前的結果。續約的request_id綁定於該線路:將它用於另一條線路會回傳衝突錯誤(HTTP 409),且另一條線路不會改變,請為每筆交易產生新的request_id。
API-06 我的整合無法運作,如何自行檢查?
API Key 頁面有一張近期 API 呼叫表格(30 天):操作、結果、錯誤代碼、呼叫位址、連接器名稱。參數絕不會被記錄。
API-07 什麼是 webhook,有哪些事件?
當有事情發生時,面板會通知您的系統,您就不必一直詢問。事件:line.created、line.renewed、line.enabled、line.disabled、line.deleted、line.expiring(提前 3 天)、line.expired、credits.low(低於您設定的門檻)。接收位址必須是 https 且可從網際網路連到。
API-08 如何確認 webhook 是真的?
每個通知都帶有簽章X-Xtream-Signature: sha256=HMAC(secret, timestamp.body);密鑰只會在建立端點時顯示一次。webhook 絕不包含密碼。
API-09 webhook 停止傳送了?
每個通知會嘗試 3 次;連續 20 次傳送失敗的端點會被關閉。請修正您那一端,使用Send test,若端點已被關閉,請重新建立。
API-10 API 會回傳線路密碼嗎?
會,但只回傳給線路的擁有者(您與階層中您上層的帳號)。請勿將線路密碼存入記錄檔,也不要透過不安全的管道傳送。
API-11 `edit_line` 可以為線路續約嗎?
可以,當您隨附package_id(也接受舊名稱package):除了編輯之外,此操作會像change_package一樣銷售該方案的一個正式期間,價格相同、request_id相同,回應中帶有credits_charged。編輯與續約是同一筆交易:被拒絕時(點數不足、方案無效、同時送出trial),任何內容都不會改變。沒有方案的edit_line只會編輯使用者名稱、密碼、聯絡方式與備註,不會動到方案或到期日。
商店 / 帳務系統的連接器
CONCON-01 如何向我的客戶收款?
使用您自己的系統與金流閘道。面板不處理付款。連接器會將您的商店系統與面板連結起來:客戶在您那邊付款 → 連接器呼叫 Reseller API 來建立 / 續約線路。
CON-02 哪些平台有連接器?
WHMCS、Blesta、WISECP、HostBill、ClientExec、FOSSBilling、Paymenter、WordPress(WooCommerce / Easy Digital Downloads)、Odoo、PrestaShop、OpenCart、Magento、Dolibarr、ERPNext,以及適用於 Shopify、Upmind 與 Invoice Ninja 的「webhook bridge」。
CON-03 在哪裡下載與安裝?
側邊欄Resources → All Connectors:每個連接器都有說明、連線資料、安裝步驟、Download按鈕,以及用於驗證檔案的 SHA-256。
CON-04 連接器經過多少測試?
每個連接器不同,且各連接器的頁面都有說明:有些在真實平台內執行過(例如 WordPress + WooCommerce、Odoo、FOSSBilling、Paymenter),其他則只測試了核心部分。請閱讀「how it was tested」那一行,並在正式銷售前先於測試環境試用。
CON-05 連接器安全嗎,它會對面板做什麼?
CON-06 連接器可以銷售什麼?
線路(建立、續約、變更方案、暫停、刪除)以及附有點數的子經銷商帳號。
資料、刪除與隱私
DATADATA-01 已刪除的線路可以還原嗎?
不行。刪除就是消失:線路的資料(使用者名稱、密碼、聯絡方式、備註)、連線紀錄(IP、裝置、觀看內容)、附屬於該線路的機上盒及其啟用碼。沒有資源回收筒,也沒有還原功能或 API。客戶回來時,請建立新的線路。
DATA-02 刪除後系統還保留什麼?
只保留供營運者使用的匿名統計紀錄(新客戶或回頭客、哪些方案受歡迎)。其中沒有任何可辨識客戶的資料,經銷商、連接器或 API 都無法存取。
DATA-03 備份可以還原已刪除的線路嗎?
不行。資料庫備份只用於事故後重建系統,由營運者持有;不會用來復原刪除。舊的備份會輪替淘汰,因此被刪除的資料也會從中消失。
DATA-04 為什麼線路密碼可讀,而面板密碼不可讀?
線路密碼必須輸入到應用程式中,且是播放清單連結的一部分,因此面板為線路的擁有者保留其可讀性。面板帳號的密碼只以雜湊儲存。
DATA-05 誰能看到我的線路與客戶?
您、階層中您上層的帳號,以及管理員。其他經銷商與您下層的帳號看不到。
DATA-06 面板會寄電子郵件 / 訊息給我的客戶嗎?
絕對不會。線路的客戶屬於經銷商;您透過自己的系統聯絡他們。
DATA-07 線路到期前會通知我嗎?
有兩種方式:即將到期線路的每日摘要電子郵件(管理員啟用時;預設提前 3 天),以及供您系統使用的line.expiring/line.expiredwebhook。
疑難排解
FIX請由上往下檢查。多數「無法觀看」的問題都出在前 5 列。
FIX-01 客戶無法登入 / 無法觀看 觀眾
| # | 檢查項目 | 徵兆 | 處理方式 |
|---|---|---|---|
| 1 | 使用者名稱 / 密碼 | 應用程式回報資料錯誤 | 與線路表單比對(區分大小寫,無空格);重新傳送Generate play link的連結 |
| 2 | 到期日 | 應用程式回報Expired | 續約(LINE-06) |
| 3 | 狀態 | Disabled/Banned | 重新啟用;Banned請聯絡管理員 |
| 4 | 伺服器位址 | 無法連線 | 使用播放連結中確切的位址與連接埠,以及正確的http/https |
| 5 | 連線數 | 別人開始觀看時被踢出 | SEC-01、SEC-02 |
| 6 | IP 被封鎖 | 該網路下沒有任何線路能進入 | SEC-08:等待封鎖解除,或請管理員解除 |
| 7 | ISP 鎖定 / 國家 / Allowed IPs | 只在更換網路、使用行動數據、使用 VPN 或旅行時失敗 | SEC-04、SEC-05、SEC-07 |
| 8 | 格式 | HLS / TS 連結被拒絕 | 使用方案允許的格式(PLAY-03) |
| 9 | 應用程式被封鎖 | 只在某個應用程式失敗 | 試試其他應用程式;SEC-09 |
FIX-02 可以登入、清單也有顯示,但頻道無法播放 觀眾
FIX-03 頻道或頻道群組不見了 觀眾
FIX-04 卡頓、畫面凍結 觀眾
依序嘗試:另一個頻道(是單一頻道還是全部?)→ 另一個網路 → 另一種格式(用 HLS 取代 MPEG-TS)→ 另一個應用程式。每個頻道在每個網路上都失敗 → 請告訴客服使用者名稱、時間與頻道。
FIX-06 我無法建立線路
FIX-07 下載播放清單時回傳錯誤 429 或 404 頁面
FIX-08 我無法開啟 dashboard 的某個頁面
FIX-09 我沒有收到面板寄來的電子郵件
只有在管理員設定了郵件伺服器並啟用該類訊息時才會寄出電子郵件;帳號必須有真實的電子郵件地址。請檢查垃圾郵件匣。
名詞表
- 線路(Line)
- 單一觀眾的 IPTV 訂閱:使用者名稱、密碼、到期日、頻道包、限制
- 使用者(User)
- 登入面板的帳號:管理員、經銷商、子經銷商
- 群組(Group)
- 面板帳號的權限群組;決定選單、可銷售的方案、線路規則、試用
- 頻道包(Bouquet)
- 內容清單(頻道、電影、影集)
- 方案(Package)
- 要銷售的產品:頻道包 + 期限 + 限制 + 以點數計的價格
- 點數(Credit)
- 用於購買方案的預付單位
- 試用(Trial)
- 方案的試用期
- 啟用碼(Activation code)
- 客戶可用來自行啟用付費線路的代碼
- MAG / Enigma2
- 兩大系列的機上盒;以 MAC 位址登入
- Xtream Codes API
- 多數 IPTV 應用程式使用的協定(伺服器 + 使用者名稱 + 密碼)
- M3U / XMLTV
- 播放清單 / 節目表的檔案格式
- MPEG-TS / HLS
- 兩種串流格式
- EPG
- 節目表
- Catch-up(回看)
- 在節目播出後再觀看
- Restreamer
- 提供給夥伴的線路,夥伴會拉取串流再轉發
- 連接器(Connector)
- 將經銷商的商店系統與面板連結起來的軟體
- Webhook
- 有事情發生時,面板傳送給經銷商系統的通知
沒有符合的問題
請試試其他關鍵字或問題代碼,或清除篩選條件。
仍然無法解決?
請提供線路的使用者名稱(切勿提供密碼)、發生時間、使用的應用程式或裝置,以及您已嘗試過的問題代碼。