Video Embed

Video Embed digunakan untuk memutar video YouTube atau Vimeo di dalam form, misalnya video induksi K3 yang wajib ditonton sebelum task diselesaikan. Komponen ini ada di grup Display pada palette, dengan nama "Video embed".

Mapping ke Engine

Komponen ini tidak menyimpan process variable. Saat form disubmit, payload tidak berisi key video. Spec form hanya menyimpan sumber video dan pengaturan pemutarnya. Syarat tonton hanya diperiksa di form, bukan di server.

Properties

• Name: Judul di atas pemutar, dalam dua bahasa (EN dan ID). Default "Safety induction video". Name juga dipakai di pesan syarat tonton.
• Key: Identitas komponen di dalam form. Default safety_induction_video. Video tidak mengirim nilai, jadi tidak ada yang tersimpan di key ini. Key yang kosong, berisi spasi, atau sudah dipakai field lain membuat Save Changes nonaktif.
• Play the video from: Sumber video. Saat ini hanya Link yang bisa dipilih. Uploaded file dan File variable tampil nonaktif, karena lampiran form belum menerima video.
• YouTube or Vimeo link: Tautan video. Tautan watch, share (youtu.be), Shorts, live, dan embed diterima. Di bawahnya tampil hasil pengecekan, misalnya "YouTube video jNQXAC9IVRw · plays from www.youtube-nocookie.com".
• Galat tautan yang membuat Save Changes nonaktif:
  • "Paste the YouTube or Vimeo link": tautan kosong.
  • Enter a full link, e.g. https://www.youtube.com/watch?v=…: teks bukan tautan lengkap.
  • Use an https:// link: tautan diawali http://.
  • "This YouTube link doesn't point to one video (playlists and channels can't be embedded)": tautan playlist atau channel.
  • "This Vimeo link doesn't point to one video": tautan Vimeo tanpa nomor video.
  • "Only YouTube and Vimeo links can be embedded — upload other videos as a file": tautan dari situs lain.
• Shape: Rasio pemutar, 16:9 wide atau 4:3. Default 16:9. Lebar pemutar selalu mengikuti form.
• Caption: Keterangan opsional dalam dua bahasa, tampil di bawah pemutar.
• Show the name: Menampilkan Name sebagai judul di atas pemutar. Bila syarat tonton aktif, judul diberi tanda *.
• Tooltip: Teks bantuan singkat yang muncul saat kursor diarahkan ke ikon informasi di samping judul; diaktifkan lewat toggle.
• Disabled: Pemutar diganti gambar diam yang redup. Video tidak bisa diputar dan syarat tonton tidak berlaku.
• Hide If (tab Logic): Ekspresi FEEL untuk menyembunyikan komponen. Komponen disembunyikan ketika ekspresi bernilai true, dievaluasi ulang saat nilai field lain berubah. Video yang disembunyikan tidak menahan Complete Task.
• Validation:
  • Must watch before Complete Task: Complete Task ditahan sampai video cukup ditonton. Pesannya mengikuti Name, misalnya "Watch at least 90% of the safety induction video before completing".
  • Watch at least: Batas tonton 50–100%, naik per 5%. Default 90%. Nilai di luar rentang memunculkan "Use 50–100%" dan membuat Save Changes nonaktif. Hanya bagian yang benar-benar diputar yang dihitung.
  • Allow skipping ahead: Default mati. Saat mati, pengguna tidak bisa melompat melewati titik terjauh yang sudah ditonton. Bagian yang dilompati tidak pernah dihitung, baik saklar ini hidup maupun mati.

Perilaku saat diisi

• Video YouTube diputar dari youtube-nocookie.com (mode privasi). Video Vimeo diputar dengan do-not-track. Selama memuat, pemutar menampilkan "YouTube · privacy mode" atau "Vimeo · do not track".
• Bila syarat tonton aktif, di bawah pemutar tampil garis progres dan baris seperti "Watched 1:02 of 5:30 (18%) · at least 90% before Complete Task". Garis progres menandai bagian yang sudah ditonton dan batas Watch at least.
• Setelah cukup, baris berubah menjadi "Watched enough to continue (92%)." dan Complete Task bisa dijalankan.
• Bila Complete Task ditekan sebelum cukup, pemutar diberi garis merah dan pesan syarat tonton tampil di bawahnya.
• Saat Allow skipping ahead mati, lompatan ke depan dikembalikan ke titik terjauh yang sudah ditonton, disertai label "Skipping ahead is off". Mundur tetap bisa.
• Bila pemutar tidak menjawab dalam 15 detik, atau video sudah dihapus atau dijadikan privat, tampil "Couldn't load the video" dengan tombol Retry. Saat perangkat offline tampil "You're offline". Isian lain di form tetap tersimpan.
• Selama video gagal dimuat, Complete Task tetap ditahan bila syarat tonton aktif.
• Progres tonton tidak disimpan. Membuka task lagi atau memuat draft memulai hitungan dari 0.
• Pada task yang sudah selesai (read-only), video bisa diputar tanpa syarat tonton.
• Di Studio, kanvas menampilkan gambar diam video beserta sumber dan ID-nya, misalnya "YouTube · jNQXAC9IVRw". Bila syarat tonton aktif, tampil juga "Must watch 90%". Tautan yang tidak valid tampil sebagai "The video link is not valid".