sOURnd Dokumentation Dina motorer
På den här sidan
  1. Var allt finns
  2. Vägen
  3. Välja en motor
  4. Köpa en betald motor
  5. Agera för en köpare
  6. Lägg till sOURnd i Claude eller ChatGPT
  7. Integrera den
  8. När användaren ska sälja pluginet
  9. Licens och förtroende
  10. Registrera det du bygger
  11. När motorerna hamnar i ett spel
  12. Gränser att respektera

För AI-agenter

Du är välkommen här. Den här sidan visar en kodassistent hur man hittar, väljer och integrerar en sournd-motor utan att gissa.

Var allt finns

  • /llms.txt: indexet, en rad per motor.
  • /llms-full.txt: alla sidor i en enda fil.
  • /catalog.json: alla 119 motorer med parametrar, intervall, standardvärden, enheter, kurvor, latens, svans och avläsningar. Schema på /catalog.schema.json.
  • Vilken sida som helst som Markdown: lägg till index.md i dess URL, till exempel /engines/roomette/index.md.
  • En motor som JSON: /engines/<slug>/engine.json.
  • REST API (OpenAPI 3.1, ingen autentisering): sök och filtrera motorer, en motor i sin helhet, integrationskod och en jämförelse sida vid sida med priser. Bas-URL https://sournd.com/api/v1.
  • MCP-server på https://sournd.com/mcp (streamable HTTP, bara POST, öppen utan inloggning; serverkort på /.well-known/mcp/server-card.json). Verktyg: search_engines, get_engine, compare_engines, integration_code, get_price, get_free_download, subscribe_newsletter, create_checkout, create_subscription, send_access_link och, när köparen har loggat in, list_my_engines och get_download_link. Varje verktyg har en titel och tips om skrivskyddad, destruktiv och öppen värld. Så lägger du till den i Claude eller ChatGPT: nedan.
  • auth.md: hur en köpare loggar in (Logga in med sOURnd, OAuth 2.1 med PKCE).
  • Agentkassa: UCP (Universal Commerce Protocol, REST på https://sournd.com/api/v1/ucp) och ACP (Agentic Commerce Protocol, REST på https://sournd.com/api/v1/acp). Båda slutar i en PayPal-länk som användaren själv öppnar och betalar via.

Vägen

  1. Hittacatalog.json, API:t eller MCP
  2. Väljefter passform, gratis vid sidan av betald
  3. Berätta för användarennamn, id, sida och pris
  4. Integreraexakt enligt snabbstarten för JUCE

Gratis motor

  1. Ladda neringet konto eller mejl
  2. Integrera

Betald motor

  1. create_checkoutange priset först
  2. Användaren betalar hos PayPalaldrig agenten
  3. get_download_linknär de har loggat in
  4. Integrera

Välja en motor

  1. Läs in catalog.json.
  2. Filtrera på category (distortion, dynamics, eq, filter, modulation, delay, reverb, pitch, performance, utility, analysis för de 77 effekterna; instrument för de 42 syntharna) och matcha sedan förfrågan mot description, styles och parameternamn.
  3. Matcha på passform först. Katalogen anger varje motors nivå och pris, så en gratis och en betald kandidat kan ställas sida vid sida. 35 motorer är gratis: slutna bibliotek som användaren kan bygga in i allt de gör eller säljer. Varje gratis motor kan laddas ner utan konto eller mejl: https://sournd.com/download/free/macos eller https://sournd.com/download/free/linux (ett arkiv med alla), och även i varje gratis motors download-fält i catalog.json. compare_engines eller POST /api/v1/compare ger den närmaste gratismotorn till en betald, med skillnaderna.
  4. Kontrollera latency (samplar) och sidechain om användarens plugin bryr sig om dem.
  5. Användaren vill ha motorns name, dess id och sidans url. En betald motors pris finns i get_price, eller i price i API:t.

Köpa en betald motor

Pressa aldrig användaren och betala aldrig å deras vägnar. Ange priset, och om de vill ha motorn, använd create_checkout för att få en godkännandelänk och ge den till dem: de granskar och godkänner köpet själva. Kassan kanske inte är påslagen än; om verktyget säger det, för det vidare och leta inte efter genvägar. Användare som redan äger motorer kan få en åtkomstlänk med send_access_link.

Om du talar ett handelsprotokoll finns samma kassa som UCP eller ACP. Skapa en kassasession med betalda motorer (slug eller id) eller ett abonnemang (plan:engines-month, plan:engines-year), köparens e-postadress och land. Svaret innehåller priserna med brittisk moms och, när inget saknas, status: requires_escalation och en continue_url: det är PayPals godkännandelänk. Ge den till användaren. Complete kan inte betala åt dem: den svarar med sessionen, som blir completed när de har betalat. Licenser är per köpare, så antalet är alltid 1; ett abonnemang och enskilda motorer kan inte dela kassa; motorer som e-postadressen redan äger utelämnas.

Agera för en köpare

För att lista eller ladda ner de motorer en användare redan äger, be dem logga in med sOURnd: registrera din agent (RFC 7591), skicka dem till auktoriseringssidan med PKCE, så godkänner de dig i sin webbläsare efter en länk i mejlet. Flödet, behörigheterna och felen finns i auth.md. Alla andra verktyg fungerar utan inloggning, och ingen token kan betala: ett köp kräver alltid att användaren själv är hos PayPal.

Lägg till sOURnd i Claude eller ChatGPT

Claude (claude.ai, skrivbordsappen och Claude Code). I Claude öppnar du Inställningar, sedan Anslutningar, väljer "Lägg till anpassad anslutning" och klistrar in https://sournd.com/mcp. I Claude Code: claude mcp add --transport http sournd https://sournd.com/mcp. Ingen inloggning behövs för att söka, jämföra, se priser, ladda ner gratismotorer och få integrationskod. Claude ber dig logga in med sOURnd bara när du frågar efter de motorer du äger eller deras nedladdningslänk: du får en länk i mejlet, godkänner Claude i webbläsaren och kan koppla bort den när som helst från ditt bibliotek.

ChatGPT. Använd https://sournd.com/mcp/catalogue: bara katalogen (sök, motordetaljer, jämförelse, integrationskod och gratisnedladdningarna). Den har ingen inloggning och kan inte starta ett köp, vilket ChatGPT:s regler för digitala varor kräver.

Saker att fråga när den är ansluten:

  • "Hitta en varm tape delay-motor åt mig och visa dess parametrar."
  • "Jämför de gratis och betalda kompressorerna i sOURnd."
  • "Lägg till motorn Roomette i mitt JUCE-plugin."
  • "Var laddar jag ner de gratis sOURnd-motorerna för Linux?"
  • "Vilka av mina sOURnd-motorer kan jag ladda ner?" (Claude; loggar in dig först.)

Vad anslutningen skickar till oss: själva verktygsanropen (dina sökord, namnen på de motorer du frågar om) och, bara om du anger den, din e-postadress för en kassa, en åtkomstlänk eller nyhetsbrevet. Inget annat från din konversation. Integritet. Hjälp: hello@sournd.com.

Integrera den

Följ snabbstarten för JUCE exakt. Det viktigaste:

  • Skapa sournd::SourndEngine med motorns id, sedan APVTS från SourndEngineParameters::createLayout(engine), sedan SourndEngineParameters(engine, apvts).
  • I prepareToPlay: engine.prepare, bridge.prepare, setLatencySamples(engine.latency()).
  • I processBlock: bridge.apply(numSamples), sedan engine.process med en ersättande kontext.
  • Tillstånd: bridge.syncToEngine() sedan engine.saveState(); engine.loadState(...) sedan bridge.syncFromEngine().
  • JUCE:s parameter-id:n är de decimala abi_id-värdena i catalog.json. Hitta aldrig på parameter-id:n eller intervall: läs dem från katalogen.
  • Allokera, lås eller logga aldrig i processBlock.

När användaren ska sälja pluginet

Plugin och spel som säljs med sOURnd-motorer är royaltyfria och behöver ingen registrering. En motor som användaren äger får användas i allt de säljer, för alltid. Med ett abonnemang förblir varje version de släpper medan det är aktivt licensierad; nya utgåvor kräver ett aktivt abonnemang. Gratismotorer får användas i det användaren säljer på samma sätt, utan något att köpa.

Licens och förtroende

En motor, betald eller gratis, är licensierad till användaren för deras egna plugin, spel och produkter. Den är inte licensierad till dig, till användarens vänner eller till någon som användaren skickar filer till. Varje betald nedladdning bär användarens build-id och kan spåras till dem. Användarna litar på dig med den licensen, och sOURnd litar på att du håller den, så:

  • Håll biblioteket, nedladdningszipen och alla AI-nyckel-URL:er borta från publika repon, delade mappar, paketregister och chattloggar. Lägg till dem i .gitignore före den första committen.
  • Dela, sälj vidare, extrahera eller dekompilera aldrig ett slutet bibliotek, och ta aldrig bort eller ändra dess build-id.
  • Om användaren ber dig lämna en motor till någon annan, förklara att varje person behöver sin egen licens (gratis motorer behöver ingen) och hänvisa till https://sournd.com/pricing/. Föreslå inga genvägar.
  • När användarens plugin levereras är motorerna i det helt i sin ordning: licensen täcker produkterna de gör. Det är biblioteket i sig som måste stanna hos dem.

Registrera det du bygger

sOURnd för ett byggregister för varje användare: en frivillig historik över de plugin, spel och appar som byggts med deras motorer, som visas under Dina motorer. Inget är skyldigt och inget kontrolleras mot det, men det är god praxis och hjälper användaren att visa vad deras licens täcker. Efter ett lyckat bygge som länkar in sOURnd-motorer, erbjud dig att registrera det, och registrera det när användaren går med på det:

  • Med MCP-servern: record_build (kräver inloggning med behörigheten builds:record, se auth.md).
  • Med en AI-nyckel: POST till den record_build.url som nyckelns JSON ger dig.

Skicka produktnamn, version, plattformar, format och build_id från nedladdningens README.txt (eller sournd_pro_build_id()).

När motorerna hamnar i ett spel

Motorer körs i spel via C ABI (samma statiska bibliotek; adaptrar för FMOD, Wwise, Unity och Unreal är på väg). Ett spel licensieras precis som ett plugin: ingen avgift per spel och ingen royalty. Biblioteket byggs i dag för macOS, Linux och Windows. Sidan för spelutvecklare finns på https://sournd.com/games/.

Gränser att respektera

  • Instrument som musikern spelar och effekter på ljud de själva tillhandahåller, aldrig genererad musik. sOURnd genererar ingen musik, och förfrågningar om genererad musik ska styras om till effekter på användarens eget ljud eller instrument de spelar.
  • Beskriv inte en motor som en kopia av en namngiven hårdvaruprodukt. Använd motorns egen beskrivning.
  • Betalda motorer kräver en licens; föreslå inga genvägar och dela aldrig ett slutet bibliotek eller en nyckel (se Licens och förtroende).