stremio addon sdk
1.0.0
Der ? Stremio Addon SDK? wurde vom Stremio-Team entwickelt, um die Erstellung von Node.js-Add-ons für unsere Streaming-Plattform erheblich zu vereinfachen.
Stremio unterstützt derzeit Windows, macOS, Linux, Android und iOS.
Wichtig: Wir empfehlen dringend, Add-ons auf den BeamUp-Servern bereitzustellen
Dieses willkürliche Beispiel erstellt ein Add-on, das einen Stream für Big Buck Bunny bereitstellt und eine HTTP-Adresse ausgibt, unter der Sie darauf zugreifen können.
const { addonBuilder, ServeHTTP, PublishToCentral } = require('stremio-addon-sdk')const builder = new addonBuilder({id: 'org.myexampleaddon',version: '1.0.0',name: 'simple example',/ / Eigenschaften, die bestimmen, wann Stremio dieses Add-on auswählt// das bedeutet, dass Ihr Add-on für Streams vom Typ Moviecatalogs verwendet wird: [],resources: ['stream'],types: ['movie'],idPrefixes: ['tt']})// nimmt function(args)builder.defineStreamHandler(function(args) {if (args.type = == 'movie' && args.id === 'tt1254207') {// einen Stream für viel Geld bereitstellen bunnyconst stream = { url: 'http://distribution.bbb3d.renderfarming.net/video/mp4/bbb_sunflower_1080p_30fps_normal.mp4' }return Promise.resolve({ streams: [stream] })} else {// sonst return no streamsreturn Promise.resolve({ streams : [] })}})serveHTTP(builder.getInterface(), { port: process.env.PORT ||. 7000 })//publishToCentral("https://your-domain/manifest.json") // <- rufen Sie dies auf, wenn Sie Ihr Add-on veröffentlichen möchten und es öffentlich auf „your-domain“ zugänglich ist " Speichern Sie dies als addon.js und führen Sie Folgendes aus:
npm installiere stremio-addon-sdk Knoten ./addon.js
Es wird eine URL ausgegeben, mit der Sie das Add-on in Stremio installieren können
Bitte beachten Sie: Add-on-URLs in Stremio müssen mit HTTPS geladen werden (außer 127.0.0.1 ) und CORS unterstützen! Die CORS-Unterstützung wird automatisch vom SDK übernommen. Wenn Sie jedoch versuchen, Ihr Add-on remote zu laden (nicht von 127.0.0.1 ), müssen Sie HTTPS unterstützen.
Um ein neues Stremio-Add-on zu erstellen, haben wir ein Tool namens addon-bootstrap erstellt.
Sie können es auf folgende Weise verwenden:
npm install -g stremio-addon-sdk # sudo verwenden, wenn auf Linuxaddon-bootstrap Hallo-Welt
Sie werden gefragt, welche Ressourcen und Typen Sie unterstützen möchten. Anschließend wird das Add-on im hello-world -Verzeichnis erstellt und Sie können es ausführen:
CD Hallo Welt npm installieren npm start -- --launch
Wenn Sie das Add-on in der Desktop-Version von Stremio installieren möchten (die Sie hier herunterladen können), sollten Sie npm start -- --install verwenden
Unsere gesamte Dokumentation finden Sie hier auf GitHub. Schauen Sie sich unsere Beispielliste an, um allgemeine Informationen zu erhalten, oder tauchen Sie direkt in unsere SDK-Dokumentation ein, um unsere Code-Referenzdokumente zu erhalten.
Wir haben auch ein Beispiel-Add-on, das Sie als Leitfaden zum Erstellen Ihres eigenen Add-ons verwenden können.
Wir haben zwei Schritt-für-Schritt-Anleitungen erstellt: eine für dieses SDK und eine für jede Programmiersprache, die Sie hier lesen können.
Wenn Sie Node.js nicht verwenden möchten (und daher auch dieses SDK nicht verwenden möchten), können Sie Add-ons in jeder Programmiersprache erstellen. Weitere Informationen finden Sie in der Add-on-Protokollspezifikation.
Es ist auch möglich, ein Add-on ohne Programmiersprache zu erstellen, siehe unser statisches Add-on-Beispiel basierend auf der Protokollspezifikation.
Zu den SDK-Funktionen gehören:
Veröffentlichen eines Add-ons über HTTP(s)
Veröffentlichen Sie Ihren Add-on-Link in der öffentlichen Add-on-Sammlung mit „publishToCentral“.
Erstellen Sie eine Homepage für Ihr Add-on, die eine Schaltfläche „Add-on installieren“ enthält
Für Entwickler, die nach einer schnellen Möglichkeit suchen, ihre neuen Add-ons zu testen, haben Sie folgende Möglichkeiten:
Testen Sie mit Stremio
Testen Sie mit unserer Webversion
Damit Ihr Add-on von anderen genutzt werden kann, muss es online bereitgestellt werden.
Sie können unsere Liste der empfohlenen Hosting-Anbieter für Node.js einsehen oder es alternativ lokal mit localtunnel hosten.
Nachdem Sie es öffentlich bereitgestellt haben, müssen Sie „publishToCentral“ verwenden oder manuell über die Benutzeroberfläche veröffentlichen, damit Ihr Add-on in Stremio angezeigt wird (über die öffentliche Add-on-Sammlung).
Schauen Sie sich unsere ständig wachsende Liste mit Beispielen und Demo-Add-ons an. Diese Liste enthält auch Beispiele und Tutorials zur Entwicklung von Stremio-Add-ons in PHP, Python, Ruby, C#, Rust, Java und Go. Es enthält auch eine Liste mit Video-Tutorials.
Es gibt hier eine Rust-Version dieses SDK eines Drittanbieters, die auf dem von Sleeyax entwickelten Stremio-Core basiert.
Es gibt hier eine Go-Version dieses SDK eines Drittanbieters, die von doingodswork entwickelt wurde.
Lesen Sie unseren Leitfaden für fortgeschrittene Benutzer, um die vielen Einsatzmöglichkeiten von Add-ons zu verstehen.
Wenn Sie Probleme mit dem Stremio Addon SDK haben, können Sie diese gerne hier melden.
Um von v0.x zu migrieren, müssen Sie Folgendes tun:
Ändern Sie new addonSDK in new addonBuilder , das Sie über const addonBuilder = require('stremio-addon-sdk').addonBuilder importieren können
Ändern Sie addon.run(opts) in serveHTTP(addon.getInterface(), opts) , das Sie über const serveHTTP = require('stremio-addon-sdk').serveHTTP
Alle Handler müssen ein Promise zurückgeben (anstatt ein cb anzunehmen)
Die Verwendung dieses SDK ist für die Erstellung von Stremio-Addons nicht zwingend erforderlich. Sie können jede Programmiersprache verwenden, die die Erstellung eines HTTP-Servers unterstützt, um Stremio-Add-ons zu erstellen. Einzelheiten und Beispiele finden Sie in unserer Protokollspezifikation.
Ein nützliches Szenario für die Nichtverwendung des SDK besteht darin, dass Sie benutzerspezifische Daten für Ihr Add-on benötigen (z. B. ein API-Authentifizierungstoken). Ein Beispiel für die Übergabe benutzerspezifischer Daten in der Add-on-URL finden Sie hier. In diesem Beispiel werden Node.js und Express verwendet, um benutzerspezifische Daten abzurufen. (Update: Das Addon SDK unterstützt jetzt Benutzereinstellungen)
Mit Liebe und ernsthaften Programmierkenntnissen vom Stremio-Team erstellt
