sOURnd Dokumentaatio Moottorisi
Tällä sivulla
  1. Missä kaikki on
  2. Polku
  3. Moottorin valinta
  4. Maksullisen moottorin osto
  5. Ostajan puolesta toimiminen
  6. Lisää sOURnd Claudeen tai ChatGPT:hen
  7. Integrointi
  8. Kun käyttäjä aikoo myydä pluginin
  9. Lisenssi ja luottamus
  10. Kirjaa, mitä rakennat
  11. Kun moottorit päätyvät peliin
  12. Rajat, joita on kunnioitettava

Tekoälyagenteille

Olet tervetullut. Tämä sivu kertoo koodausavustajalle, miten sournd-moottori löydetään, valitaan ja integroidaan arvaamatta.

Missä kaikki on

  • /llms.txt: hakemisto, yksi rivi moottoria kohden.
  • /llms-full.txt: kaikki sivut yhdessä tiedostossa.
  • /catalog.json: kaikki 119 moottoria parametreineen, arvoalueineen, oletusarvoineen, yksiköineen, käyrineen, viiveineen, häntineen ja näyttöarvoineen. Skeema osoitteessa /catalog.schema.json.
  • Mikä tahansa sivu Markdownina: lisää osoitteen perään index.md, esimerkiksi /engines/roomette/index.md.
  • Yksi moottori JSONina: /engines/<slug>/engine.json.
  • REST API (OpenAPI 3.1, ei todennusta): moottorien haku ja suodatus, yksi moottori kokonaisuudessaan, integrointikoodi ja vertailu rinnakkain hintoineen. Perusosoite https://sournd.com/api/v1.
  • MCP-palvelin osoitteessa https://sournd.com/mcp (streamable HTTP, vain POST, avoin ilman kirjautumista; palvelinkortti osoitteessa /.well-known/mcp/server-card.json). Työkalut: search_engines, get_engine, compare_engines, integration_code, get_price, get_free_download, subscribe_newsletter, create_checkout, create_subscription, send_access_link ja, kun ostaja on kirjautunut, list_my_engines ja get_download_link. Jokaisella työkalulla on otsikko sekä vihjeet vain luku -, tuhoavuus- ja avoin maailma -ominaisuuksista. Näin lisäät sen Claudeen tai ChatGPT:hen: alla.
  • auth.md: miten ostaja kirjautuu sisään (Sign in with sOURnd, OAuth 2.1 ja PKCE).
  • Agentin kassa: UCP (Universal Commerce Protocol, REST osoitteessa https://sournd.com/api/v1/ucp) ja ACP (Agentic Commerce Protocol, REST osoitteessa https://sournd.com/api/v1/acp). Molemmat päättyvät PayPal-linkkiin, jonka käyttäjä avaa ja jolla hän maksaa itse.

Polku

  1. Etsicatalog.json, API tai MCP
  2. Valitsesopivuuden mukaan, ilmainen maksullisen rinnalla
  3. Kerro käyttäjällenimi, tunniste, sivu ja hinta
  4. IntegroiJUCE-pikaopas, täsmälleen

Ilmainen moottori

  1. Lataaei tiliä eikä sähköpostia
  2. Integroi

Maksullinen moottori

  1. create_checkoutkerro hinta ensin
  2. Käyttäjä maksaa PayPalissaei koskaan agentti
  3. get_download_linkkun he ovat kirjautuneet sisään
  4. Integroi

Moottorin valinta

  1. Lataa catalog.json.
  2. Suodata kentällä category (distortion, dynamics, eq, filter, modulation, delay, reverb, pitch, performance, utility, analysis 77 efektille; instrument 42 syntikalle) ja vertaa sitten pyyntöä kenttiin description, styles ja parametrien nimiin.
  3. Valitse ensin sopivuuden mukaan. Katalogi antaa jokaisen moottorin tason ja hinnan, joten ilmaisen ja maksullisen ehdokkaan voi asettaa rinnakkain. 35 moottoria on ilmaista: suljettuja kirjastoja, jotka käyttäjä voi liittää mihin tahansa, mitä hän tekee tai myy. Jokainen ilmainen moottori latautuu ilman tiliä tai sähköpostia: https://sournd.com/download/free/macos tai https://sournd.com/download/free/linux (yksi arkisto, jossa ne kaikki), myös jokaisen ilmaisen moottorin download-kentässä tiedostossa catalog.json. compare_engines tai POST /api/v1/compare palauttaa maksullista moottoria lähimpänä olevan ilmaisen moottorin ja erot.
  4. Tarkista latency (näytteinä) ja sidechain, jos käyttäjän plugin välittää niistä.
  5. Käyttäjä haluaa moottorin name, id ja sivun url. Maksullisen moottorin hinta on kohdassa get_price tai API:ssa kentässä price.

Maksullisen moottorin osto

Älä koskaan painosta käyttäjää äläkä maksa hänen puolestaan. Kerro hinta, ja jos hän haluaa moottorin, hae create_checkout-työkalulla hyväksyntälinkki ja anna se hänelle: hän tarkistaa ja hyväksyy ostoksen itse. Kassa ei välttämättä ole vielä päällä; jos työkalu kertoo niin, välitä tieto eteenpäin äläkä etsi kiertoteitä. Käyttäjille, joilla on jo moottoreita, voi lähettää käyttölinkin työkalulla send_access_link.

Jos puhut kauppaprotokollaa, sama kassa on tarjolla UCP:nä tai ACP:nä. Luo kassaistunto maksullisilla moottoreilla (slug tai id) tai yhdellä tilauksella (plan:engines-month, plan:engines-year), ostajan sähköpostilla ja hänen maallaan. Vastauksessa on hinnat Britannian arvonlisäveroineen ja, kun mitään ei puutu, status: requires_escalation ja continue_url: se on PayPalin hyväksyntälinkki. Anna se käyttäjälle. Complete ei voi maksaa hänen puolestaan: se vastaa istunnolla, joka muuttuu tilaan completed, kun hän on maksanut. Lisenssit ovat ostajakohtaisia, joten määrä on aina 1; tilausta ja yksittäisiä moottoreita ei voi yhdistää samaan kassaan; moottorit, jotka sähköpostiosoitteella jo on, jätetään pois.

Ostajan puolesta toimiminen

Jos haluat listata tai ladata moottorit, jotka käyttäjällä jo on, pyydä häntä kirjautumaan sOURndilla: rekisteröi agenttisi (RFC 7591), ohjaa hänet valtuutussivulle PKCE:llä, ja hän hyväksyy sinut selaimessaan sähköpostilinkin jälkeen. Kulku, oikeudet ja virheet ovat tiedostossa auth.md. Kaikki muut työkalut toimivat ilman kirjautumista, eikä mikään tunniste voi maksaa: ostaminen vaatii aina, että käyttäjä on PayPalissa.

Lisää sOURnd Claudeen tai ChatGPT:hen

Claude (claude.ai, työpöytäsovellus ja Claude Code). Avaa Claudessa Asetukset, sitten Connectors, valitse "Add custom connector" ja liitä https://sournd.com/mcp. Claude Codessa: claude mcp add --transport http sournd https://sournd.com/mcp. Kirjautua ei tarvitse, kun haet, vertailet, katsot hintoja, lataat ilmaisia moottoreita tai haet integrointikoodia. Claude pyytää kirjautumaan sOURndilla vain, kun pyydät omia moottoreitasi tai niiden latauslinkkiä: saat sähköpostilinkin, hyväksyt Clauden selaimessasi ja voit katkaista yhteyden milloin tahansa kirjastostasi.

ChatGPT. Käytä osoitetta https://sournd.com/mcp/catalogue: pelkkä katalogi (haku, moottorin tiedot, vertailu, integrointikoodi ja ilmaiset lataukset). Siinä ei ole kirjautumista, eikä sillä voi aloittaa ostoa, kuten ChatGPT:n digitaalisia tuotteita koskevat säännöt edellyttävät.

Kysyttävää, kun yhteys on valmis:

  • "Etsi minulle lämmin nauhaviive-moottori ja näytä sen parametrit."
  • "Vertaa sOURndin ilmaisia ja maksullisia kompressoreita."
  • "Lisää moottori Roomette JUCE-pluginiini."
  • "Mistä lataan sOURndin ilmaiset moottorit Linuxille?"
  • "Mitkä sOURnd-moottoreistani voin ladata?" (Claude; kirjauttaa sinut ensin sisään.)

Mitä yhteys lähettää meille: itse työkalukutsut (hakusanasi, moottorien nimet, joista kysyt) ja, vain jos annat sen, sähköpostiosoitteesi kassaa, käyttölinkkiä tai uutiskirjettä varten. Ei mitään muuta keskustelustasi. Tietosuoja. Apua: hello@sournd.com.

Integrointi

Noudata JUCE-pikaopasta täsmälleen. Olennaisimmat kohdat:

  • Luo sournd::SourndEngine moottorin tunnisteella, sitten APVTS kutsulla SourndEngineParameters::createLayout(engine) ja sitten SourndEngineParameters(engine, apvts).
  • Funktiossa prepareToPlay: engine.prepare, bridge.prepare, setLatencySamples(engine.latency()).
  • Funktiossa processBlock: bridge.apply(numSamples), sitten engine.process korvaavalla kontekstilla.
  • Tila: bridge.syncToEngine() ja sitten engine.saveState(); engine.loadState(...) ja sitten bridge.syncFromEngine().
  • JUCE-parametrien tunnisteet ovat tiedoston catalog.json desimaaliset abi_id-arvot. Älä koskaan keksi parametrien tunnisteita tai alueita: lue ne katalogista.
  • Älä koskaan varaa muistia, lukitse tai kirjaa funktiossa processBlock.

Kun käyttäjä aikoo myydä pluginin

sOURnd-moottoreilla myydyistä plugineista ja peleistä ei makseta rojalteja, eikä niitä tarvitse rekisteröidä. Moottorin, jonka käyttäjällä on, voi liittää mihin tahansa, mitä hän myy, pysyvästi. Tilauksella jokainen versio, jonka hän julkaisee tilauksen ollessa voimassa, pysyy lisensoituna; uudet julkaisut vaativat voimassa olevan tilauksen. Ilmaiset moottorit menevät käyttäjän myymiin tuotteisiin samalla tavalla, eikä mitään tarvitse ostaa.

Lisenssi ja luottamus

Moottori, maksullinen tai ilmainen, on lisensoitu käyttäjän omiin plugineihin, peleihin ja tuotteisiin. Sitä ei ole lisensoitu sinulle, käyttäjän ystäville eikä kenellekään, jolle käyttäjä lähettää tiedostoja. Jokainen maksullinen lataus sisältää käyttäjän build-tunnisteen ja on jäljitettävissä hänelle. Käyttäjät luottavat sinuun tämän lisenssin kanssa, ja sOURnd luottaa sinuun sen noudattamisessa, joten:

  • Pidä kirjasto, latauksen zip ja kaikki tekoälyavainten URL-osoitteet poissa julkisista repositorioista, jaetuista kansioista, pakettirekistereistä ja keskusteluhistoriasta. Lisää ne tiedostoon .gitignore ennen ensimmäistä commitia.
  • Älä koskaan jaa, myy edelleen, pura tai dekompiloi suljettua kirjastoa äläkä poista tai muuta sen build-tunnistetta.
  • Jos käyttäjä pyytää sinua antamaan moottorin jollekin toiselle, kerro, että jokainen tarvitsee oman lisenssinsä (ilmaiset moottorit eivät tarvitse) ja ohjaa heidät osoitteeseen https://sournd.com/pricing/. Älä ehdota kiertoteitä.
  • Kun käyttäjän plugin julkaistaan, sen sisällä olevat moottorit ovat kunnossa: lisenssi kattaa hänen tekemänsä tuotteet. Vain kirjasto yksinään on pidettävä hänen omanaan.

Kirjaa, mitä rakennat

sOURnd pitää kullekin käyttäjälle build-rekisteriä: vapaaehtoista historiaa pluginsista, peleistä ja sovelluksista, jotka on rakennettu hänen moottoreillaan, ja se näkyy sivulla Moottorisi. Mitään ei ole velvollisuutena eikä mitään tarkisteta sitä vasten, mutta se on hyvä käytäntö ja auttaa käyttäjää osoittamaan, mitä hänen lisenssinsä kattaa. Kun build, joka linkittää sOURnd-moottoreita, on onnistunut, tarjoa sen kirjaamista ja kirjaa se, kun käyttäjä suostuu:

  • MCP-palvelimella: record_build (vaatii kirjautumisen oikeudella builds:record, katso auth.md).
  • Tekoälyavaimella: POST osoitteeseen record_build.url, jonka avaimen JSON antaa.

Lähetä tuotteen nimi, versio, alustat, formaatit ja build_id latauksen README.txt-tiedostosta (tai kutsulla sournd_pro_build_id()).

Kun moottorit päätyvät peliin

Moottorit toimivat peleissä C ABI:n kautta (sama staattinen kirjasto; FMOD-, Wwise-, Unity- ja Unreal-adapterit ovat tulossa). Peli lisensoidaan täsmälleen kuten plugin: ei pelikohtaista maksua eikä rojalteja. Kirjasto käännetään nykyään macOS:lle, Linuxille ja Windowsille. Pelikehittäjien sivu on https://sournd.com/games/.

Rajat, joita on kunnioitettava

  • Soittimia, joita muusikko soittaa, ja efektejä äänelle, jonka hän tuo itse, ei koskaan generoitua musiikkia. sOURnd ei generoi musiikkia, ja generoitua musiikkia koskevat pyynnöt tulee ohjata efekteihin käyttäjän omalle äänelle tai soittimiin, joita hän soittaa.
  • Älä kuvaa moottoria nimetyn laitetuotteen kopiona. Käytä moottorin omaa kuvausta.
  • Maksulliset moottorit vaativat lisenssin; älä ehdota kiertoteitä äläkä koskaan jaa suljettua kirjastoa tai avainta (katso Lisenssi ja luottamus).