--- title: "Otwarta kontrola dźwięku (OSC) - DMXDesktop" lang: en source: /pl/open-sound-control --- # Otwarte Sterowanie Dźwiękiem (OSC) Wysyłaj polecenia do DMXDesktop i odbieraj transmisje stanu za pomocą OSC ## Czym jest OSC? Open Sound Control (OSC) to protokół do sieciowania syntezatorów dźwięku, komputerów i innych urządzeń multimedialnych w celach takich jak występy muzyczne czy kontrola pokazów. DMXDesktop implementuje OSC do komunikacji dwukierunkowej - odbieraj polecenia z zewnętrznych kontrolerów i transmituj zmiany stanu do innych aplikacji. ## Jak to działa DMXDesktop obsługuje zarówno wejście, jak i wyjście OSC. Serwer **OSC Input** nasłuchuje przychodzących wiadomości, aby kontrolować różne aspekty oprogramowania. **OSC Output** transmituje zmiany stanu i zdarzenia do zewnętrznych aplikacji, umożliwiając synchronizację w czasie rzeczywistym z oprogramowaniem wideo, wizualizatorami i niestandardowymi integracjami. Oba wspierają protokół UDP dla komunikacji o niskim opóźnieniu. ## Rozpoczęcie 1. Otwórz DMXDesktop i przejdź do **Ustawienia → Ogólne** 2. W sekcji OSC znajdziesz: - Przełącznik Włącz/wyłącz OSC Input - Wybór interfejsu sieciowego - Numer portu wejściowego (domyślnie: 8000) - Wybór protokołu (UDP/TCP) - Przełącznik Włącz/wyłącz OSC Output - Host i port wyjścia (domyślnie: 127.0.0.1:9000) 3. Usługa odkrywania działa na porcie 9000 i pozwala kompatybilnym aplikacjom automatycznie znaleźć DMXDesktop w sieci ## Łączenie z TouchOSC TouchOSC to popularne narzędzie do kontrolowania wielu różnych typów aplikacji i może być używane do kontrolowania DMXDesktop za pomocą protokołu OSC. *Proszę pamiętać: TouchOSC to płatne oprogramowanie, proszę zapoznać się z oficjalną stroną w celu uzyskania szczegółów.* 1. Pobierz i zainstaluj TouchOSC na swoim urządzeniu: - iOS: App Store - Android: [Google Play](https://play.google.com/store/apps/details?id=net.hexler.lex&hl=en) - Desktop: Desktop 2. Otwórz TouchOSC i utwórz nowe połączenie: - Protokół: OSC - Host: Adres IP twojego komputera (pokazany w ustawieniach DMXDesktop) - Port wysyłania: 8000 (domyślnie) - Port odbierania: 9000 (dla usługi odkrywania) 3. Użyj funkcji odkrywania w TouchOSC, aby automatycznie znaleźć DMXDesktop w swojej sieci 4. Utwórz swój układ używając ścieżek OSC wymienionych w tabeli poniżej ## Porady dotyczące sieci - Upewnij się, że twoje urządzenie i komputer są w tej samej sieci - Jeśli używasz zapory, zezwól na przychodzące połączenia na portach 8000 i 9000 - Dla optymalnej wydajności używaj dedykowanej sieci lub połączenia WiFi 5GHz - Dla OSC Output skonfiguruj adres IP i port docelowego hosta w Ustawieniach ## Dodatkowe zasoby - Oficjalna strona OSC - Dowiedz się więcej o protokole OSC - Dokumentacja TouchOSC - Szczegółowy przewodnik po TouchOSC - Specyfikacja protokołu OSC - Szczegóły techniczne protokołu OSC ## Polecenia OSC Input Wyślij te polecenia do DMXDesktop, aby kontrolować swoje oświetlenie. Wszystkie ścieżki są wrażliwe na wielkość liter. | Ścieżka OSC | Parametry | Opis | | --- | --- | --- | | KONTROLA MASTER | | | | /master/dimmer | float (0-1) | Kontroluje intensywność ściemniacza master | | EFEKTY NA ŻYWO | | | | /live/strobe/{on|off|pulse} | brak | Kontroluje stan stroboskopu | | /live/blackout/{on|off|pulse} | brak | Kontroluje stan blackout | | /live/blinder/{on|off|pulse} | brak | Kontroluje stan blinder | | /live/freeze/{on|off|pulse} | brak | Kontroluje stan freeze | | /live/fog/{on|off|pulse} | brak | Kontroluje stan maszyny do dymu | | EFEKTY SPECJALNE | | | | /effects/{effect}/start | brak | Uruchamia określony efekt (fala, paparazzi, kolorowy przesuw, grzmot, puls, iskra, losowy) | | /effects/{effect}/stop | brak | Zatrzymuje określony efekt specjalny | | /effects/stop | brak | Zatrzymuje wszystkie aktualnie działające efekty specjalne | | /effects/bpm | float (0-1) | Ustawia BPM dla synchronizacji efektów specjalnych (mapuje 0-1 na 60-200 BPM) | | EDYTY NA ŻYWO | | | | /live/edit/{action}/{name} | action: enable|disable|toggle | Kontroluje stan edycji na żywo według nazwy | | /live/edit/group/{action}/{name} | action: enable|disable|toggle | Kontroluje stan grupy edycji na żywo według nazwy | | /live/edit/disable-all | brak | Wyłącza wszystkie edycje na żywo | | KONTROLA CUE | | | | /cue/effect/play/{name} | string | Odtwarza konkretny cue efektu według nazwy | | /cue/effect/{action} | play|stop|next|prev | Kontroluje nawigację odtwarzania cue efektu | | KONTROLA DJ | | | | /dj/app/{app} | musicplayer|virtualdj|traktor | Przełącza konkretną aplikację DJ | | /dj/deck{1|2}/{action} | play|stop|eject | Kontrole transportu decku | | /dj/deck{1|2}/volume | float (0-1) | Kontroluje głośność decku | | /dj/crossfader | float (0-1) | Kontroluje pozycję crossfadera | | BEZPOŚREDNIA KONTROLA DMX | | | | /dmx/{universe}/{channel} | float (0-1) | Ustawia wartość kanału DMX (mapuje 0-1 na 0-255) | | /dmx/{universe}/{channel}/clear | brak | Czyści nadpisanie kanału DMX | | /dmx/clear | brak | Czyści WSZYSTKIE nadpisania kanałów DMX | | KONTROLA STOSU | | | | /stack/{id}/go | brak | Uruchamia następny cue w określonym stosie | | /stack/{id}/back | brak | Krok wstecz do poprzedniego cue | | /stack/{id}/halt | brak | Zatrzymuje aktualne przejście w trakcie | | /stack/{id}/stop | brak | Zatrzymuje odtwarzanie w określonym stosie | | /stack/{id}/level | float (0-1) | Ustawia poziom master stosu | | WYKONAJ SIATKĘ | | | | /execute/{row}/{col} | brak | Aktywuje przycisk siatki wykonania w określonej pozycji | ## Wiadomości OSC Output DMXDesktop transmituje stan i zdarzenia do zewnętrznych aplikacji za pomocą OSC. Skonfiguruj docelowego hosta i port w Ustawieniach. *Dostępne od v1.0.46* ### Kontrole na żywo `/dmxdesktop/v1/master` float 0-1 (0-100%) `/dmxdesktop/v1/blackout` int 0|1 `/dmxdesktop/v1/strobe` int 0|1 `/dmxdesktop/v1/blinder` int 0|1 `/dmxdesktop/v1/freeze` int 0|1 `/dmxdesktop/v1/fog` int 0|1 `/dmxdesktop/v1/effect` int 0|1 `/dmxdesktop/v1/specialeffect/{name}` int 0|1 (fala, grzmot, itd.) ### Audio i BPM `/dmxdesktop/v1/bpm` float (wartość BPM) `/dmxdesktop/v1/beat` float, int, int, float (bpm, ts_high, ts_low, pewność) `/dmxdesktop/v1/audio/level` float 0-1 (poziom RMS) `/dmxdesktop/v1/audio/energy` float 0-1 (poziom energii) ### Cues efektów `/dmxdesktop/v1/cue/active` string (nazwa cue lub "") `/dmxdesktop/v1/cue/name` string (aktualny cue) `/dmxdesktop/v1/cue/action` string (play|stop) `/dmxdesktop/v1/cue/lifecycle` string (fadeIn/OutStarted/Finished) `/dmxdesktop/v1/cue/lifecycle/duration` int (ms) `/dmxdesktop/v1/cue/lifecycle/newCue` string (nazwa następnego cue) ### Stosy Cue `/dmxdesktop/v1/stack/{id}/step` int (indeks kroku) `/dmxdesktop/v1/stack/{id}/fading` int 0|1 `/dmxdesktop/v1/stack/{id}/paused` int 0|1 ### Edycje na żywo i nadpisania `/dmxdesktop/v1/liveedit/{id}` int 0|1 `/dmxdesktop/v1/liveedit/group/{id}` int 0|1 `/dmxdesktop/v1/override/color` string (ID palety lub "") `/dmxdesktop/v1/override/position` string (preset lub "") ### DJ Mode `/dmxdesktop/v1/dj/enabled` int 0|1 `/dmxdesktop/v1/dj/app` string (nazwa aplikacji lub "") `/dmxdesktop/v1/dj/master` int 1-4 (deck główny) `/dmxdesktop/v1/dj/crossfader` float 0-1 `/dmxdesktop/v1/dj/deck{1-4}/playing` int 0|1 `/dmxdesktop/v1/dj/deck{1-4}/paused` int 0|1 `/dmxdesktop/v1/dj/deck{1-4}/track` string (Artysta - Tytuł) `/dmxdesktop/v1/dj/deck{1-4}/loaded` int 0|1 (utwór załadowany) `/dmxdesktop/v1/dj/deck{1-4}/loading` int 0|1 (analizowanie) `/dmxdesktop/v1/dj/deck{1-4}/showready` int 0|1 (DMX show gotowe) `/dmxdesktop/v1/dj/deck{1-4}/vu` float (poziom miernika VU) ### QuickShow - Efekty wiązki `/dmxdesktop/v1/quickshow/beam` string (nazwa efektu lub "") `/dmxdesktop/v1/quickshow/beam/speed` int (surowa wartość suwaka) `/dmxdesktop/v1/quickshow/beam/phase` int (surowa wartość suwaka) `/dmxdesktop/v1/quickshow/beam/background` int (surowa wartość suwaka) `/dmxdesktop/v1/quickshow/beam/spread` int (surowa wartość suwaka) `/dmxdesktop/v1/quickshow/beam/intensity` int (surowa wartość suwaka) ### QuickShow - Efekty ruchu `/dmxdesktop/v1/quickshow/move` string (nazwa efektu lub "") `/dmxdesktop/v1/quickshow/move/speed` int (surowa wartość suwaka) `/dmxdesktop/v1/quickshow/move/size` int (surowa wartość suwaka) `/dmxdesktop/v1/quickshow/move/phase` int (surowa wartość suwaka) `/dmxdesktop/v1/quickshow/move/fanning` int (surowa wartość suwaka) `/dmxdesktop/v1/quickshow/move/direction` int -1|0|1 ### QuickShow - Ogólne `/dmxdesktop/v1/quickshow/theme` int (ID motywu) `/dmxdesktop/v1/quickshow/themecount` int (8|16|24|32) `/dmxdesktop/v1/quickshow/preset` string (ID preset lub "") `/dmxdesktop/v1/quickshow/groups` string (tablica JSON) `/dmxdesktop/v1/quickshow/groups/move` string (tablica JSON) `/dmxdesktop/v1/quickshow/stopall` int 1 (zdarzenie pulsacyjne) ### QuickShow - Enkodery `/dmxdesktop/v1/quickshow/encoder/beam/{id}` int 0-255 (wartość DMX) `/dmxdesktop/v1/quickshow/encoder/move/{id}` int 0-255 (wartość DMX) Identyfikatory enkoderów mają format: beam_aux_{groupId}_{channelKey} lub move_aux_{groupId}_{channelKey} **Uwaga:** OSC Output wymaga płatnej subskrypcji i musi być włączony w Ustawieniach. Domyślny port to 9000. Znaczniki czasu bitów są dzielone na dwa 32-bitowe całkowite liczby (ts_high, ts_low), ponieważ OSC nie obsługuje wartości 64-bitowych. ## Gotowy do zdalnego sterowania swoimi światłami? Pobierz DMXDesktop