Documentation & API Guide

Panduan Lengkap ClyraMotion

Pelajari cara mengonfigurasi, menggunakan parameter kustom, dan membangun tautan rahasia (Hash Obfuscation) pada pemutar video Cloudflare Workers Anda.

ClyraMotion adalah skrip berbasis Cloudflare Workers yang berfungsi sebagai proksi ekstraktor multi-sumber, pemutar video premium berbasis JW Player, serta generator tautan. Skrip ini dirancang untuk melakukan bypass terhadap CORS, menangani proteksi Hotlink, serta menyembunyikan URL asli media Anda.

Catatan Keamanan: Skrip ini dihosting sepenuhnya di edge network Cloudflare (Serverless). Pastikan Anda tidak menyebarkan DRIVE_API_KEY Anda secara publik jika repositori kode Anda berstatus publik.

Fitur Utama

Multi-Source Extraction

Mendukung G-Drive, G-Photos, Dailymotion, OK.ru, Vimeo, OneDrive, Mediafire, Yandex Disk, dan HLS langsung.

Hash Obfuscation

Sembunyikan URL video asli Anda menggunakan sistem enkripsi Double Base64 untuk mencegah pencurian tautan.

Multi-Subtitle & Audio

Dukungan penyisipan file subtitle (VTT/SRT) dalam berbagai bahasa secara dinamis melalui parameter URL.

Halaman Unduhan Khusus

Rute khusus /download/ yang dilengkapi fitur hitung mundur (countdown) dan penyesuaian multi-resolusi.

Lanjutkan Tontonan

Sistem cerdas berbasis localStorage yang merekam progres durasi menonton pengguna beserta UI Notifikasi Interaktif.

Optimasi Mobile

Fitur "Double tap to seek" (-10s / +10s) dan auto-rotate ke Landscape saat mode layar penuh (Fullscreen) di HP.

Referensi Parameter URL

ClyraMotion mendeteksi video dan pengaturannya berdasarkan kueri parameter (Query Strings). Parameter ini dapat disuntikkan secara terbuka di belakang URL (setelah rute Hash).

Parameter Contoh Nilai Fungsi & Penjelasan
poster https://.../bg.jpg Mengubah gambar latar belakang (Thumbnail) pada JW Player sebelum video diputar. Ekstensi yang disarankan: JPG, PNG, WEBP.
logo https://.../logo.png Menambahkan Watermark (Logo kustom) di pojok kanan atas Player. Ekstensi transparan direkomendasikan (PNG/SVG).
sub https://.../id.vtt Menambahkan Track Caption (Subtitle). Dapat dipanggil lebih dari sekali untuk multi-subtitle (misal: &sub=url1&sub=url2).
lang Indonesia Label nama bahasa untuk subtitle yang ditambahkan. Urutannya harus sama persis dengan urutan pemanggilan parameter sub.
Penting: Format subtitle yang sangat disarankan dan dijamin bekerja pada HTML5 Player adalah .vtt (WebVTT). Format .srt terkadang tidak dirender dengan baik pada peramban iOS/Safari.

Sistem Routing (Path)

ClyraMotion menyediakan 3 (tiga) rute jalur utama yang bisa digunakan sesuai kebutuhan antarmuka akhir bagi pengguna.

1. Rute Player Standar (/v/ atau /video/)

Menampilkan pemutar JW Player secara penuh dalam satu halaman. Sangat cocok digunakan di dalam tag <iframe> untuk disematkan di website utama Anda.

https://yourdomain.com/v/HASH_CODE_DISINI

2. Rute Bergaya YouTube (/watch/)

Fungsinya persis sama dengan rute standar, disediakan khusus untuk membuat URL terasa lebih elegan dan familiar (seperti YouTube).

https://yourdomain.com/watch/HASH_CODE_DISINI

3. Rute Halaman Unduhan (/download/)

Rute ini tidak memuat JW Player, melainkan mengalihkan pengguna ke sebuah antarmuka halaman penuh (Full Page UI). Halaman ini menampilkan hitung mundur (10 detik) lalu menampilkan tombol Unduh MP4 multi-resolusi.

https://yourdomain.com/download/HASH_CODE_DISINI

Dukungan Sumber Video

Berikut adalah format asli URL (Main Video URL) yang didukung untuk dimasukkan ke dalam generator atau di-hash:

Platform Format File Format URL Asli yang Diterima Generator
Dailymotion M3U8 / HLS https://www.dailymotion.com/video/k7rGZ... atau sekadar ID-nya: k7rGZ...
Google Drive MP4 https://drive.google.com/file/d/ID_FILE/view atau sekadar ID-nya saja.
Google Photos MP4 https://photos.app.goo.gl/ALBUM_ID
Vimeo MP4 https://vimeo.com/123456789
OK.ru (Odnoklassniki) MP4 https://ok.ru/video/1234567890
Direct Media MP4 / MKV Tautan mentah yang berakhiran .mp4, .mkv, atau .webm.
Direct Live Stream M3U8 / HLS Tautan mentah yang berakhiran .m3u8. Akan secara otomatis dibungkus oleh Proxy CORS internal skrip.

Developer API (Link Obfuscation)

Jika Anda memiliki backend sendiri (PHP, Node.js, Python, dll) dan ingin secara otomatis menghasilkan tautan ClyraMotion tanpa harus membuka halaman Homepage Generator secara manual, Anda bisa mereplikasinya menggunakan metode enkripsi Double Base64.

Logika Pembuatan:

  1. Ambil URL Sumber asli (misal: tautan Dailymotion).
  2. Lakukan URL Encode (RFC 3986) pada tautan tersebut.
  3. Lakukan konversi Base64 sebanyak dua kali (Double Encode).
  4. Tempelkan hasil string ke belakang routing /v/.
  5. Opsional: Tambahkan parameter terbuka seperti ?poster=...&sub=... di bagian paling akhir tautan yang sudah direkayasa.

Contoh Kode (JavaScript / Node.js)

const rawVideoUrl = "https://www.dailymotion.com/video/k2l7D...";
const safeString = encodeURIComponent(rawVideoUrl);

// Lakukan Encode Base64 Dua Kali (Double Btoa)
const hashStr = btoa(btoa(safeString));

// Parameter Ekstra (Terbuka)
const queryParams = "?poster=https://img.com/bg.jpg&sub=https://sub.com/id.vtt&lang=ID";

// Hasil Akhir
const finalStreamingLink = "https://watch.clyra.web.id/v/" + hashStr + queryParams;
console.log(finalStreamingLink);

Contoh Kode (PHP)

$rawVideoUrl = "https://www.dailymotion.com/video/k2l7D...";
$safeString = rawurlencode($rawVideoUrl);

// Lakukan Encode Base64 Dua Kali
$hashStr = base64_encode(base64_encode($safeString));

$queryParams = "?poster=https://img.com/bg.jpg&logo=https://img.com/logo.png";
$finalLink = "https://watch.clyra.web.id/v/" . $hashStr . $queryParams;

echo $finalLink;

Powered By Blogger