sOURnd Dokumentace Vaše enginy
Na této stránce
  1. Kde všechno je
  2. Postup
  3. Výběr enginu
  4. Nákup placeného enginu
  5. Jednání za kupujícího
  6. Přidejte sOURnd do Claude nebo ChatGPT
  7. Začlenění
  8. Když uživatel bude plugin prodávat
  9. Licence a důvěra
  10. Zaznamenejte, co stavíte
  11. Když enginy míří do hry
  12. Limity, které je třeba dodržet

Pro AI agenty

Jste tu vítáni. Tato stránka říká asistentovi pro programování, jak najít, vybrat a začlenit engine sournd bez hádání.

Kde všechno je

  • /llms.txt: rejstřík, jeden řádek na engine.
  • /llms-full.txt: všechny stránky v jednom souboru.
  • /catalog.json: všech 119 enginů s parametry, rozsahy, výchozími hodnotami, jednotkami, křivkami, latencí, dozvukem a údaji pro zobrazení. Schéma najdete na /catalog.schema.json.
  • Libovolná stránka jako Markdown: přidejte k její adrese index.md, například /engines/roomette/index.md.
  • Jeden engine jako JSON: /engines/<slug>/engine.json.
  • REST API (OpenAPI 3.1, bez ověřování): hledání a filtrování enginů, jeden engine v úplnosti, kód pro začlenění a srovnání vedle sebe s cenami. Základní URL https://sournd.com/api/v1.
  • Server MCP na https://sournd.com/mcp (streamable HTTP, jen POST, otevřený bez přihlášení; karta serveru na /.well-known/mcp/server-card.json). Nástroje: search_engines, get_engine, compare_engines, integration_code, get_price, get_free_download, subscribe_newsletter, create_checkout, create_subscription, send_access_link a po přihlášení kupujícího list_my_engines a get_download_link. Každý nástroj má název a nápovědy o tom, zda je jen pro čtení, destruktivní a otevřený světu. Jak jej přidat do Claude nebo ChatGPT: níže.
  • auth.md: jak se přihlásit za kupujícího (přihlášení přes sOURnd, OAuth 2.1 s PKCE).
  • Nákup přes agenta: UCP (Universal Commerce Protocol, REST na https://sournd.com/api/v1/ucp) a ACP (Agentic Commerce Protocol, REST na https://sournd.com/api/v1/acp). Oba končí odkazem na PayPal, který uživatel otevře a zaplatí sám.

Postup

  1. Najítcatalog.json, API nebo MCP
  2. Vybratpodle shody, zdarma vedle placeného
  3. Říct uživatelinázev, id, stránka a cena
  4. Začlenitpřesně podle rychlého startu s JUCE

Engine zdarma

  1. Stáhnoutbez účtu a e-mailu
  2. Začlenit

Placený engine

  1. create_checkoutnejdřív uveďte cenu
  2. Uživatel platí přes PayPalnikdy agent
  3. get_download_linkpo přihlášení
  4. Začlenit

Výběr enginu

  1. Načtěte catalog.json.
  2. Filtrujte podle category (distortion, dynamics, eq, filter, modulation, delay, reverb, pitch, performance, utility, analysis pro 77 efektů; instrument pro 42 syntezátorů), pak porovnejte požadavek s description, styles a názvy parametrů.
  3. Nejprve hledejte shodu. Katalog uvádí u každého enginu úroveň a cenu, takže lze porovnat kandidáta zdarma a placeného. 35 enginů je zdarma: uzavřené knihovny, které uživatel může začlenit do čehokoli, co vytvoří nebo prodává. Každý engine zdarma se stahuje bez účtu a e-mailu: https://sournd.com/download/free/macos nebo https://sournd.com/download/free/linux (jeden archiv se všemi), také v poli download každého enginu zdarma v catalog.json. compare_engines nebo POST /api/v1/compare vrátí k placenému enginu nejbližší engine zdarma i s rozdíly.
  4. Zkontrolujte latency (vzorky) a sidechain, pokud na tom uživatelově pluginu záleží.
  5. Uživatel bude potřebovat name enginu, jeho id a url stránky. Cena placeného enginu je v get_price nebo v price v API.

Nákup placeného enginu

Na uživatele nikdy netlačte a nikdy za něj neplaťte. Uveďte cenu, a pokud engine chce, použijte create_checkout, získejte odkaz ke schválení a předejte mu ho: nákup si prohlédne a schválí sám. Pokladna ještě nemusí být zapnutá; pokud to nástroj řekne, předejte to dál a nehledejte obchvaty. Uživatelům, kteří už enginy vlastní, lze poslat přístupový odkaz přes send_access_link.

Pokud mluvíte některým obchodním protokolem, stejná pokladna je dostupná jako UCP nebo ACP. Vytvořte relaci pokladny s placenými enginy (slug nebo id) nebo jedním plánem (plan:engines-month, plan:engines-year), e-mailem kupujícího a jeho zemí. Odpověď obsahuje ceny s britskou DPH a, jakmile nic nechybí, status: requires_escalation a continue_url: to je odkaz ke schválení na PayPal. Předejte ho uživateli. Complete za něj zaplatit nemůže: odpoví relací, která se po zaplacení změní na completed. Licence jsou na kupujícího, takže množství je vždy 1; plán a jednotlivé enginy nelze spojit v jedné pokladně; enginy, které e-mail už vlastní, se vynechají.

Jednání za kupujícího

Chcete-li vypsat nebo stáhnout enginy, které uživatel už vlastní, požádejte ho o přihlášení přes sOURnd: zaregistrujte svého agenta (RFC 7591), pošlete ho na stránku autorizace s PKCE a on vás po odkazu z e-mailu schválí ve svém prohlížeči. Postup, rozsahy oprávnění a chyby jsou v auth.md. Každý jiný nástroj funguje bez přihlášení a žádný token nemůže platit: nákup vždy vyžaduje, aby uživatel byl na PayPal.

Přidejte sOURnd do Claude nebo ChatGPT

Claude (claude.ai, desktopová aplikace a Claude Code). V Claude otevřete Settings, pak Connectors, zvolte „Add custom connector“ a vložte https://sournd.com/mcp. V Claude Code: claude mcp add --transport http sournd https://sournd.com/mcp. Pro hledání, porovnávání, ceny, stahování zdarma a kód pro začlenění se není třeba přihlašovat. Claude vás požádá o přihlášení přes sOURnd, jen když se zeptáte na enginy, které vlastníte, nebo na odkaz ke stažení: dostanete odkaz e-mailem, schválíte Claude ve svém prohlížeči a můžete ho kdykoli odpojit ve své knihovně.

ChatGPT. Použijte https://sournd.com/mcp/catalogue: jen katalog (hledání, podrobnosti enginů, srovnání, kód pro začlenění a stahování zdarma). Nemá přihlášení a nemůže zahájit nákup, jak vyžadují pravidla ChatGPT pro digitální zboží.

Na co se ptát po připojení:

  • „Najdi mi hřejivý engine páskového delaye a ukaž jeho parametry.“
  • „Porovnej kompresory zdarma a placené ve sOURnd.“
  • „Přidej engine Roomette do mého pluginu JUCE.“
  • „Kde stáhnu enginy sOURnd zdarma pro Linux?“
  • „Které z mých enginů sOURnd si mohu stáhnout?“ (Claude; nejprve vás přihlásí.)

Co nám připojení posílá: samotná volání nástrojů (vaše hledaná slova, názvy enginů, na které se ptáte) a, jen pokud ji uvedete, vaši e-mailovou adresu pro pokladnu, přístupový odkaz nebo newsletter. Nic jiného z vaší konverzace. Soukromí. Pomoc: hello@sournd.com.

Začlenění

Řiďte se přesně rychlým startem s JUCE. To hlavní:

  • Vytvořte sournd::SourndEngine s id enginu, pak APVTS z SourndEngineParameters::createLayout(engine), pak SourndEngineParameters(engine, apvts).
  • V prepareToPlay: engine.prepare, bridge.prepare, setLatencySamples(engine.latency()).
  • V processBlock: bridge.apply(numSamples), pak engine.process s nahrazujícím kontextem.
  • Stav: bridge.syncToEngine() a pak engine.saveState(); engine.loadState(...) a pak bridge.syncFromEngine().
  • Id parametrů JUCE jsou desítkové hodnoty abi_id v catalog.json. Id ani rozsahy parametrů nikdy nevymýšlejte: čtěte je z katalogu.
  • V processBlock nikdy nealokujte, nezamykejte ani nezapisujte do logu.

Když uživatel bude plugin prodávat

Pluginy a hry prodávané s enginy sOURnd nevyžadují žádné licenční poplatky ani registraci. Engine, který uživatel vlastní, může být součástí čehokoli, co prodává, navždy. S plánem zůstává licencována každá verze, kterou vydá, dokud je plán aktivní; nová vydání vyžadují aktivní plán. Enginy zdarma se do toho, co uživatel prodává, dostanou stejným způsobem, aniž by se cokoli kupovalo.

Licence a důvěra

Engine, placený i zdarma, je licencován uživateli pro jeho vlastní pluginy, hry a produkty. Není licencován vám, uživatelovým přátelům ani nikomu, komu uživatel posílá soubory. Každé placené stažení nese build id uživatele a lze ho k němu vystopovat. Uživatelé vám tuto licenci svěřují a sOURnd věří, že ji dodržíte, takže:

  • Nenechte knihovnu, stažený zip ani žádnou adresu AI klíče ve veřejných repozitářích, sdílených složkách, registrech balíčků ani záznamech chatu. Přidejte je do .gitignore před prvním commitem.
  • Uzavřenou knihovnu nikdy nesdílejte, neprodávejte dál, neextrahujte ani nedekompilujte a neodstraňujte ani neměňte její build id.
  • Pokud vás uživatel požádá, abyste engine předali někomu jinému, vysvětlete, že každý potřebuje vlastní licenci (enginy zdarma ji nepotřebují), a odkažte ho na https://sournd.com/pricing/. Nenavrhujte obchvaty.
  • Když uživatelův plugin vyjde, enginy uvnitř jsou v pořádku: licence pokrývá produkty, které vytvoří. Samotná knihovna musí zůstat u něj.

Zaznamenejte, co stavíte

sOURnd vede pro každého uživatele registr buildů: dobrovolnou historii pluginů, her a aplikací postavených s jeho enginy, zobrazenou v části Vaše enginy. Nic se nedluží a nic se podle něj nekontroluje, ale je to dobrá praxe a pomáhá uživateli doložit, co jeho licence pokrývá. Po úspěšném buildu, který linkuje enginy sOURnd, nabídněte zaznamenání a zaznamenejte ho, jakmile uživatel souhlasí:

  • Přes server MCP: record_build (vyžaduje přihlášení s oprávněním builds:record, viz auth.md).
  • S AI klíčem: POST na record_build.url, které vám dá JSON klíče.

Pošlete název produktu, verzi, platformy, formáty a build_id z README.txt ve stažení (nebo z sournd_pro_build_id()).

Když enginy míří do hry

Enginy běží ve hrách přes C ABI (stejná statická knihovna; adaptéry pro FMOD, Wwise, Unity a Unreal jsou na cestě). Hra je licencována přesně jako plugin: žádný poplatek za hru a žádné licenční poplatky. Knihovna se dnes staví pro macOS, Linux a Windows. Stránka pro vývojáře her je https://sournd.com/games/.

Limity, které je třeba dodržet

  • Nástroje, na které hudebník hraje, a efekty na zvuk, který dodá, nikdy generovaná hudba. sOURnd hudbu negeneruje a požadavky na generovanou hudbu je třeba přesměrovat na efekty na vlastní zvuk uživatele nebo na nástroje, na které hraje.
  • Neoznačujte engine za kopii konkrétního hardwarového produktu. Použijte vlastní popis enginu.
  • Placené enginy vyžadují licenci; nenavrhujte obchvaty a nikdy nesdílejte uzavřenou knihovnu ani klíč (viz Licence a důvěra).