OBS Studio
Disertakan dengan Macro DeckGanti adegan, kendalikan siaran, rekaman, dan audio, dan bereaksi terhadap apa yang terjadi di OBS Studio.
Dialog Hubungkan OBS Studio dengan kolom nama konfigurasi, host, port, dan kata sandi
- Ganti adegan, profil, dan koleksi adegan
- Mulai dan hentikan siaran, rekaman, buffer putar ulang, dan kamera virtual
- Bisukan input, atur volume, serta alihkan sumber dan filter
- Variabel langsung untuk adegan, kode waktu, FPS, dan frame yang hilang
- Hubungkan beberapa instans OBS sekaligus
Integrasi OBS Studio menghubungkan Macro Deck ke OBS melalui server WebSocket yang sudah ada di OBS (obs-websocket 5). Setelah terhubung, tombol Anda dapat mengendalikan hampir semua yang Anda lakukan di OBS selama siaran, dan OBS melaporkan kembali setiap perubahan sehingga deck selalu menampilkan status terkini.
Yang dapat dilakukan
- Ganti adegan program, adegan pratinjau mode studio, profil, atau koleksi adegan.
- Mulai, hentikan, atau alihkan siaran, rekaman, buffer putar ulang, dan kamera virtual, simpan cuplikan putar ulang, jeda rekaman, pisahkan berkas rekaman, atau tambahkan penanda bab.
- Tampilkan atau sembunyikan sumber dalam adegan, aktifkan atau nonaktifkan filter, bisukan input atau ubah volumenya dalam persen atau dB.
- Ubah pengaturan sebuah sumber, misalnya teks dari sumber teks, berkas dari sumber gambar atau media, atau URL dari sumber browser.
- Mulai dan hentikan output OBS apa pun berdasarkan nama, termasuk output yang ditambahkan plugin.
Beberapa contoh penggunaan:
- Tombol BRB yang beralih ke adegan BRB dan membisukan mikrofon.
- Tombol Rekam yang mengalihkan rekaman dan menampilkan apakah OBS sedang merekam, dijeda, atau berhenti.
- Slider yang terikat pada variabel
obs_<input>_volumedari input musik Anda, sehingga menggeser slider mengubah volume di OBS. - Alur yang berjalan saat OBS melaporkan Siaran Dimulai dan mengirimkan notifikasi kepada Anda.
Cara kerjanya
Macro Deck mendengarkan peristiwa yang dikirim OBS, sehingga variabel seperti adegan saat ini, status bisu, dan status filter diperbarui dalam sepersekian detik setelah Anda mengubahnya di OBS. Tombol alih menyala selama statusnya aktif, juga saat Anda mengubahnya di OBS sendiri. Statistik seperti FPS, penggunaan CPU, bitrate, dan frame yang hilang dibaca setiap satu atau dua detik.
Selain variabel tetap, pemilih variabel mencantumkan setiap input, adegan, item adegan, dan filter dari OBS yang terhubung, beserta volume, status bisu, visibilitas, atau status aktifnya. Pemicu bereaksi terhadap pergantian adegan, perubahan rekaman dan siaran, cuplikan putar ulang dan tangkapan layar yang disimpan, input yang menjadi aktif, serta peristiwa khusus yang disiarkan skrip OBS Anda sendiri.
Anda dapat menambahkan lebih dari satu konfigurasi, misalnya satu untuk PC streaming dan satu untuk PC gaming. Setiap konfigurasi mendapat kumpulan variabelnya sendiri, dan setiap aksi memiliki kolom Konfigurasi untuk memilih OBS mana yang dikendalikan. Saat OBS ditutup atau jaringan terputus, Macro Deck terus mencoba terhubung kembali dan menjalankan pemicu Terputus dan Terhubung.
Yang Anda butuhkan
- Macro Deck 3 di Windows, macOS, atau Linux
- OBS Studio 28 atau yang lebih baru (sudah termasuk obs-websocket 5)
- Server WebSocket diaktifkan di OBS pada Tools > WebSocket Server Settings
- Memulai dan menghentikan output berdasarkan nama membutuhkan obs-websocket 5.7 atau yang lebih baru
Cara menyiapkan
Langkah 1: Aktifkan server WebSocket di OBS
Di OBS, buka Tools > WebSocket Server Settings dan centang Enable WebSocket server. Catat Server Port (bawaan
4455). Jika Enable Authentication dicentang, klik Show Connect Info untuk melihat kata sandinya.Langkah 2: Buka OBS Studio di Macro Deck
Di Macro Deck, klik Integrasi di bilah samping, lalu klik OBS Studio. Di tab Ringkasan, klik Tambah konfigurasi di bagian Konfigurasi. Mengaktifkan sakelar di kanan atas membuka dialog yang sama, dan integrasi menjadi aktif setelah penyiapan selesai.
Langkah 3: Masukkan detail koneksi
Isi dialog Hubungkan OBS Studio:
- Nama konfigurasi: nama pilihan Anda, misalnya
Streaming PC. - Host:
127.0.0.1jika OBS berjalan di komputer yang sama, atau alamat IP komputer yang menjalankan OBS. - Port: port server dari OBS, bawaannya
4455. - Kata sandi: kata sandi dari OBS. Biarkan kosong jika autentikasi dinonaktifkan.
Klik Lanjutkan. Macro Deck menguji koneksi sebelum menyimpan konfigurasi.
- Nama konfigurasi: nama pilihan Anda, misalnya
Langkah 4: Tambahkan aksi OBS ke tombol
Di halaman Deck, klik tombol yang ingin digunakan. Deck harus dalam keadaan tidak terkunci: jika tombol di kanan atas bertuliskan Kunci, deck tidak terkunci. Editor terbuka dengan Ketuk Singkat terpilih. Klik + Tambah aksi, pilih OBS Studio di sisi kiri dialog Tambah aksi, lalu pilih aksi seperti Atur Adegan. Pilih Konfigurasi dan Adegan, lalu klik Simpan.
Langkah 5: Tekan tombolnya
Tekan tombol di ponsel, tablet, atau di klien web. OBS beralih ke adegan yang dipilih. Jika tidak terjadi apa-apa, pastikan OBS sedang berjalan dan konfigurasi menampilkan Terhubung di halaman OBS Studio pada Integrasi.
Aksi35
Pasang aksi ini di tombol atau jalankan dari alur.
- Atur Adegan
- Mengganti adegan program yang aktif.
- Atur Adegan Pratinjau
- Mengganti adegan pratinjau mode studio.
- Atur Profil
- Mengalihkan OBS ke profil lain.
- Atur Koleksi Adegan
- Mengalihkan OBS ke koleksi adegan lain.
- Mulai Rekaman
- Memulai rekaman.
- Hentikan Rekaman
- Menghentikan rekaman.
- Alihkan Rekaman
- Memulai atau menghentikan rekaman, dan menampilkan apakah OBS sedang merekam, dijeda, atau berhenti.
- Jeda/Lanjutkan Rekaman
- Menjeda atau melanjutkan rekaman saat ini.
- Mulai Siaran
- Memulai siaran.
- Hentikan Siaran
- Menghentikan siaran.
- Alihkan Siaran
- Memulai atau menghentikan siaran.
- Mulai Kamera Virtual
- Memulai kamera virtual.
- Hentikan Kamera Virtual
- Menghentikan kamera virtual.
- Alihkan Kamera Virtual
- Memulai atau menghentikan kamera virtual.
- Mulai Buffer Putar Ulang
- Memulai buffer putar ulang.
- Hentikan Buffer Putar Ulang
- Menghentikan buffer putar ulang.
- Alihkan Buffer Putar Ulang
- Memulai atau menghentikan buffer putar ulang.
- Simpan Buffer Putar Ulang
- Menyimpan buffer putar ulang saat ini ke disk.
- Pisahkan berkas rekaman
- Memulai berkas rekaman baru sementara rekaman tetap berjalan.
- Buat bab rekaman
- Menambahkan penanda bab ke berkas yang sedang direkam (hanya format Hybrid MP4).
- Atur folder rekaman
- Mengatur folder tempat OBS menulis rekaman baru.
- Mulai output
- Memulai output OBS berdasarkan nama, termasuk output yang ditambahkan plugin.
- Hentikan output
- Menghentikan output OBS berdasarkan nama, termasuk output yang ditambahkan plugin.
- Alihkan output
- Memulai atau menghentikan output OBS berdasarkan nama, termasuk output yang ditambahkan plugin.
- Dapatkan status output
- Membaca apakah output OBS aktif ke dalam variabel.
- Atur Visibilitas Sumber
- Menampilkan, menyembunyikan, atau mengalihkan sumber dalam adegan.
- Bisukan Input
- Membisukan, membunyikan, atau mengalihkan status bisu input audio.
- Atur Volume Input
- Mengatur, menaikkan, atau menurunkan volume input audio dalam persen atau dB.
- Atur Filter Sumber
- Mengaktifkan, menonaktifkan, atau mengalihkan filter pada sumber.
- Atur pengaturan input
- Mengubah satu pengaturan sumber, misalnya teks dari sumber teks atau URL dari sumber browser.
- Dapatkan Volume Input
- Membaca persentase volume input audio ke dalam variabel.
- Dapatkan Status Filter
- Membaca apakah filter sumber aktif ke dalam variabel.
- Dapatkan Status Bisu Input
- Membaca apakah input audio dibisukan ke dalam variabel.
- Dapatkan Visibilitas Sumber
- Membaca apakah sumber terlihat dalam adegan ke dalam variabel.
- Alihkan Mode Studio
- Mengaktifkan atau menonaktifkan mode studio.
Pemicu24
Tombol atau alur dapat bereaksi terhadap peristiwa ini.
- Adegan Berubah
- Adegan program (live) berubah. Secara opsional hanya untuk satu adegan.
- Adegan Pratinjau Berubah
- Adegan pratinjau mode studio berubah.
- Rekaman Dimulai
- OBS mulai merekam.
- Rekaman Dihentikan
- OBS berhenti merekam.
- Rekaman Dijeda
- Rekaman dijeda.
- Rekaman Dilanjutkan
- Rekaman dilanjutkan.
- Berkas rekaman berubah
- Rekaman dimulai, berpindah ke berkas baru, atau berhenti, beserta lokasi berkasnya.
- Siaran Dimulai
- OBS mulai menyiarkan.
- Siaran Dihentikan
- OBS berhenti menyiarkan.
- Buffer Putar Ulang Dimulai
- Buffer putar ulang dimulai.
- Buffer Putar Ulang Dihentikan
- Buffer putar ulang dihentikan.
- Buffer Putar Ulang Disimpan
- Klip putar ulang ditulis ke disk, beserta lokasi berkasnya.
- Tangkapan layar disimpan
- OBS menyimpan tangkapan layar ke disk, beserta lokasi berkasnya.
- Kamera Virtual Dimulai
- Kamera virtual dimulai.
- Kamera Virtual Dihentikan
- Kamera virtual dihentikan.
- Mode Studio Berubah
- Mode studio diaktifkan atau dinonaktifkan.
- Bisu Input Berubah
- Input audio dibisukan atau dibunyikan. Secara opsional hanya untuk satu input.
- Input Menjadi Aktif
- Sebuah input mulai dirender di output program, misalnya webcam yang mulai tampil.
- Input Menjadi Nonaktif
- Sebuah input berhenti dirender di output program.
- Input Mulai Ditampilkan
- Sebuah input mulai dirender di output program atau pratinjau.
- Input Berhenti Ditampilkan
- Sebuah input tidak lagi dirender di output program atau pratinjau.
- Peristiwa Kustom
- Skrip atau plugin OBS menyiarkan peristiwa khusus. Secara opsional hanya untuk satu nama peristiwa.
- Terhubung
- Macro Deck terhubung ke OBS dan OBS selesai memuat.
- Terputus
- Koneksi ke OBS terputus.
Variabel14
Tampilkan nilai ini di tombol dan widget, atau gunakan dalam kondisi.
obs_<configuration>_is_connected- Apakah Macro Deck terhubung ke OBS ini.
obs_<configuration>_current_scene- Adegan program yang aktif.
obs_<configuration>_preview_scene- Adegan pratinjau mode studio.
obs_<configuration>_current_profile- Profil yang aktif.
obs_<configuration>_current_scene_collection- Koleksi adegan yang aktif.
obs_<configuration>_is_recording,obs_<configuration>_recording_paused,obs_<configuration>_recording_timecode- Apakah OBS sedang merekam atau dijeda, dan sudah berapa lama rekaman berjalan.
obs_<configuration>_is_streaming,obs_<configuration>_streaming_timecode- Apakah OBS sedang menyiarkan dan sudah berapa lama.
obs_<configuration>_virtual_camera_active,obs_<configuration>_replay_buffer_active,obs_<configuration>_studio_mode_active- Apakah kamera virtual, buffer putar ulang, dan mode studio aktif.
obs_<configuration>_fps,obs_<configuration>_max_fps,obs_<configuration>_cpu_usage- Angka performa yang dilaporkan OBS.
obs_<configuration>_streaming_bitrate,obs_<configuration>_recording_bitrate- Bitrate output saat ini dalam kbps.
obs_<configuration>_dropped_frames,obs_<configuration>_dropped_frames_percent,obs_<configuration>_skipped_frames,obs_<configuration>_skipped_frames_percent- Frame siaran yang hilang dan frame yang dilewati encoder, sebagai jumlah dan dalam persen.
obs_<configuration>_last_recording_file,obs_<configuration>_last_screenshot- Lokasi berkas rekaman dan tangkapan layar terbaru.
obs_<input>_volume,obs_<input>_muted, dan lainnya- Untuk setiap input yang Anda pilih: volume dalam dB (dapat ditulis, sehingga slider dapat mengaturnya), status bisu, aktif, ditampilkan, trek audio (
obs_<input>_track_1hingga_6), jenis monitor, offset sinkronisasi, dan pengaturannya. Pemilih menyarankan nama-nama ini, dan Anda dapat mengubahnya. obs_<scene>_<source>_visible,obs_<source>_<filter>_enabled- Apakah sebuah sumber terlihat dalam adegan dan apakah sebuah filter aktif. Pemilih menyarankan nama-nama ini, dan Anda dapat mengubahnya.
Pertanyaan yang sering diajukan
Apakah berfungsi jika OBS berjalan di komputer lain?
Ya. Masukkan alamat IP komputer yang menjalankan OBS sebagai Host, dan izinkan port tersebut (bawaan 4455) melewati firewall komputer itu. Lokasi di aksi seperti Atur folder rekaman atau Atur pengaturan input adalah lokasi di komputer yang menjalankan OBS.
Bisakah lebih dari satu OBS dikendalikan?
Bisa. Tambahkan satu konfigurasi per instans OBS dengan Tambah konfigurasi. Masing-masing memiliki variabelnya sendiri, dan setiap aksi memiliki kolom Konfigurasi untuk memilih OBS yang dikendalikannya.
Apa yang terjadi saat OBS ditutup atau koneksi terputus?
Macro Deck terus mencoba terhubung kembali di latar belakang dan terhubung lagi begitu OBS kembali. Sampai saat itu, aksi gagal dengan OBS tidak terhubung., dan pemicu Terputus dan Terhubung berjalan sehingga alur dapat bereaksi.
Mengapa sebuah aksi gagal?
Aksi menampilkan alasannya, misalnya adegan atau sumber sudah tidak ada, OBS masih memuat koleksi adegan, atau OBS tidak sedang merekam (untuk Pisahkan berkas rekaman dan Buat bab rekaman). Jika Anda mengganti nama sesuatu di OBS, pilih lagi di aksi.
Di mana kata sandi WebSocket disimpan?
Macro Deck menyimpan kata sandi terenkripsi di komputer yang menjalankan Macro Deck dan hanya menggunakannya untuk terhubung ke OBS.
Lainnya di Streaming
Meld Studio
Disertakan dengan Macro DeckGanti dan siapkan adegan, kendalikan lapisan, efek, dan trek audio, lalu mulai siaran di Meld Studio.
Streamlabs Desktop
Disertakan dengan Macro DeckGanti adegan, kendalikan siaran, rekaman, dan sumber audio di Streamlabs Desktop.
Streamer.bot
Disertakan dengan Macro DeckJalankan aksi Streamer.bot, kirim pesan obrolan, dan bereaksi terhadap setiap peristiwa yang dilaporkan Streamer.bot.
Twitch
Disertakan dengan Macro DeckTampilkan obrolan dan statistik siaran Twitch, moderasi, jalankan jajak pendapat dan iklan, dan bereaksi terhadap follow, sub, dan raid.
YouTube
Disertakan dengan Macro DeckTampilkan live chat dan statistik siaran YouTube, ubah judul dan tag, dan bereaksi terhadap Super Chat dan anggota.