Buat efek kamera untuk Makeplay.

Format paket

Efek adalah file zip berekstensi .mfx berisi effect.json (manifest), script.js opsional, dan aset. Setiap file di paket harus terdaftar di assets; file .md, .txt, .json tambahan dan isi src/ diabaikan dengan peringatan. Studio membuat paket ini untukmu.

effect.mfx  (zip)
├── effect.json
├── script.js
└── assets/
    ├── icon.png
    ├── ears.png
    └── …

{
  "format": 1,
  "id": "budi.telinga-kelinci",
  "name": "Telinga Kelinci",
  "version": "1.0.0",
  "description": "Telinga kelinci yang ikut kepala.",
  "hint": "Buka mulut!",
  "icon": "icon",
  "category": "face",
  "trackers": ["face"],
  "assets": [
    { "id": "icon", "path": "assets/icon.png", "type": "image" },
    { "id": "ears", "path": "assets/ears.png", "type": "image" }
  ],
  "nodes": [
    { "id": "ears", "kind": "faceSticker2D", "asset": "ears",
      "anchor": "headTop", "offset": [0, 0.02], "scale": 1.5 }
  ],
  "triggers": []
}

Koordinat dan satuan

Kamera ditampilkan seperti cermin (selfie). Konten yang menempel ikut gambar yang dicerminkan; teks dan UI tidak pernah dicerminkan. Kiri/kanan pada nama titik selalu berarti kiri/kanan orang itu sendiri.

effect.json

Aset

ID aset diawali huruf (A-Z a-z 0-9 _ -, maks. 64). Path relatif dengan garis miring biasa, tanpa ..

Node

Setiap node punya id unik (diawali huruf), kind, name opsional, visible (bawaan true), z (urutan gambar di lapisannya), dan children. Anak hanya mewarisi visibilitas, bukan posisi.

Urutan gambar: kamera/latar/LUT/warna → model 3D → stiker wajah → sprite → partikel → teks/UI.

Titik jangkar

Jenis node

Properti yang bisa diubah

Aksi setProperty dan script hanya boleh mengubah properti berikut (plus visible di semua node).

Pemicu

Pemicu menjalankan aksi tanpa kode. Sinyal kontinu memakai histeresis: menyala di ambang atas, mati di ambang bawah, dan harus bertahan sebentar, jadi tidak berkedip di dekat ambang. cooldownMs (bawaan 300) membatasi seberapa sering aksi berjalan; onEnd berjalan saat sinyal kontinu berakhir.

{
  "id": "mouth",
  "on": { "type": "mouthOpen" },
  "cooldownMs": 300,
  "actions": [{ "do": "setProperty", "node": "hearts", "property": "emitting", "value": true }],
  "onEnd":   [{ "do": "setProperty", "node": "hearts", "property": "emitting", "value": false }]
}

Aksi: show hide toggle playSound stopSound emit setProperty. Di Studio, tombol simulasi (buka mulut, kedip, senyum, miring, tangan, ketuk) memicu efekmu tanpa harus bergerak di depan kamera.

Script API

script.js adalah JavaScript biasa (tanpa import/export) yang berjalan di Web Worker terisolasi. Definisikan fungsi-fungsi ini di tingkat atas. Editor Studio memuat effect-api.d.ts, jadi kamu mendapat pelengkapan otomatis dan pemeriksaan tipe lewat JSDoc.

/** @type {MakeEffect.OnStart} */
function onStart(api) {}

/** @type {MakeEffect.OnFrame} */
function onFrame(dt, state, api) {}

/** @type {MakeEffect.OnSignal} */
function onSignal(type, phase, api) {}

function onTap(x, y, api) {}

function onStop(api) {}

let score = 0;

/** @type {MakeEffect.OnStart} */
function onStart(api) {
  api.setUi("score", 0, "Skor");
}

/** @type {MakeEffect.OnFrame} */
function onFrame(dt, state, api) {
  if (!state.face) return;
  for (const s of state.signals) {
    if (s.type === "mouthOpen" && s.phase === "start") {
      score += 1;
      api.setUi("score", score);
      api.emit("hearts", 15, state.face.points.mouthCenter[0], state.face.points.mouthCenter[1]);
    }
  }
  if (state.time > 30) api.endGame(score);
}

state

face.roll > 0 berarti kepala miring ke kiri orang itu (kiri layar pada tampilan cermin). Untuk mengukur jarak, kalikan x dengan screen.aspect.

api

Sandbox

• Script berjalan di Web Worker khusus tanpa DOM. fetch, XMLHttpRequest, WebSocket, importScripts, indexedDB, timer, eval, Function, WebAssembly, dan constructor fungsi dihapus sebelum script dijalankan.
• Validator menolak script yang menyebut import, export, API jaringan, eval( atau Function( — lengkap dengan nomor barisnya — sebelum ditinjau.
• Frame dikirim berurutan: script yang lambat kehilangan frame script, kamera tetap lancar.
• Setiap perintah divalidasi (node ada, jenis benar, angka wajar, properti diizinkan). Perintah yang salah dibuang dan dilaporkan ke konsol.

Batas

Waktu script dirata-rata per 30 frame. Jendela di atas anggaran, atau satu frame di atas 10× anggaran, dihitung sebagai pelanggaran; jendela yang bersih menghapus satu. Pada 3 pelanggaran script dihentikan dan efek dimatikan. Script yang tidak menjawab dalam 250 ms (1 detik saat memuat dan onStart) langsung dihentikan.

Runtime dan performa

Per frame: kamera → tracker MediaPipe yang dideklarasikan efek (wajah dengan blendshape, tangan, segmentasi) → sinyal dan pemicu → pass warna dan latar → lapisan 3D → lapisan 2D → frame script. Tracker hanya diunduh bila efek memakainya, dari server Make sendiri (tanpa CDN).

Kualitas otomatis mulai di level 1 dan mengukur fps. Di bawah 85% dari target 30 fps selama 2 detik, level turun; di atas 97% selama 6 detik, level naik.

• Pakai hanya tracker yang dibutuhkan. Segmentasi dan tangan paling berat.
• Kecilkan gambar: tekstur 512–1024 px biasanya cukup untuk stiker.
• Buat sprite sekali lalu pakai ulang (setSprite) daripada membuat dan menghapus tiap frame.
• Perhatikan fps, waktu tracker, dan waktu script di pratinjau Studio; uji juga di HP lewat QR.

Uji dan terbitkan

• Validasi langsung. Studio menjalankan validator yang sama dengan server setiap kali kamu mengubah sesuatu. Klik masalahnya untuk melompat ke node, properti, aset, atau baris script.
• Unggah versi. Draf dikemas jadi .mfx lalu diunggah. Nomor versi yang sama mengganti draf; versi baru harus lebih tinggi dari versi yang terakhir diajukan.
• Periksa dan uji di HP. Pemeriksaan otomatis menjalankan semua cek termasuk uji sandbox. "Uji di HP" membuat kode QR pribadi yang berlaku sekitar 10 menit dan hanya bisa dibuka aplikasi Make yang masuk dengan akunmu.
• Ajukan untuk ditinjau. Satu versi per efek bisa ditinjau sekaligus. Kamu bisa menariknya kembali selama belum diputuskan. Penolakan selalu disertai alasan.
• Terbit. Setelah disetujui, efek muncul di katalog dan kamera Makeplay. Video yang dibuat dengannya menampilkan nama efek dan akunmu.

Pemeriksaan otomatis

Status efek

Sebelum disetujui pertama kali, nama, deskripsi, kategori, dan ikon proyek mengikuti unggahan terbaru. Setelah terbit, semua perubahan publik lewat versi baru yang ditinjau.

Program kreator

• Statistik harian per efek: dipakai (kamera membuka efek), video yang diposting, dan tayangan video itu, untuk 7–90 hari.
• Lencana: Kreator Efek (efek pertama terbit), Efek Trending (masuk 20 teratas), dan Pilihan Make.
• Profil kreator efek publik dengan semua efekmu yang terbit dan jumlah pemakaiannya.
• Rekap bulanan per efek (dipakai, video, tayangan, kreator yang dijangkau) sebagai data untuk program hadiah. Tidak ada pembayaran otomatis.