stremio addon sdk
1.0.0
Itu ? Stremio Addon SDK? dikembangkan oleh Tim Stremio sebagai cara untuk menyederhanakan pembuatan add-on Node.js untuk platform streaming kami.
Stremio saat ini mendukung Windows, macOS, Linux, Android dan iOS.
Penting: Kami sangat menyarankan untuk menerapkan add-on ke server BeamUp
Contoh sewenang-wenang ini membuat add-on yang menyediakan aliran untuk Big Buck Bunny dan mengeluarkan alamat HTTP tempat Anda dapat mengaksesnya.
const { addonBuilder, serveHTTP,publishToCentral } = require('stremio-addon-sdk')const builder = new addonBuilder({id: 'org.myexampleaddon',version: '1.0.0',name: 'simple example',/ / Properti yang menentukan kapan Stremio memilih addon ini// ini berarti addon Anda akan digunakan untuk streaming bertipe moviecatalogs: [],sumber daya: ['stream'],tipe: ['movie'],idPrefixes: ['tt']})// mengambil function(args)builder.defineStreamHandler(function(args) {if (args.type = == 'movie' && args.id === 'tt1254207') {// menayangkan satu streaming ke bunnyconst stream = { url: 'http://distribution.bbb3d.renderfarming.net/video/mp4/bbb_sunflower_1080p_30fps_normal.mp4' }return Promise.resolve({ streams: [stream] })} else {// jika tidak, return no streamsreturn Promise.resolve({ streams : [] })}})serveHTTP(builder.getInterface(), { port: proses.env.PORT ||.7000 })//publishToCentral("https://domain-anda/manifest.json") // <- aktifkan ini jika Anda ingin memublikasikan add-on Anda dan dapat diakses secara publik di "domain-Anda" Simpan ini sebagai addon.js dan jalankan:
npm instal stremio-addon-sdk simpul ./addon.js
Ini akan menampilkan URL yang dapat Anda gunakan untuk menginstal addon di Stremio
Harap diperhatikan: URL tambahan di Stremio harus dimuat dengan HTTPS (kecuali 127.0.0.1 ) dan harus mendukung CORS! Dukungan CORS ditangani secara otomatis oleh SDK, tetapi jika Anda mencoba memuat addon Anda dari jarak jauh (bukan dari 127.0.0.1 ), Anda perlu mendukung HTTPS.
Untuk membuat scaffold addon Stremio baru, kami telah membuat alat bernama addon-bootstrap .
Anda dapat menggunakannya dengan cara berikut:
npm install -g stremio-addon-sdk # gunakan sudo if di Linuxaddon-bootstrap hello-world
Anda akan ditanya tentang sumber daya dan tipe apa yang ingin Anda dukung, setelah itu addon akan dibuat di direktori hello-world , dan Anda akan dapat menjalankannya:
cd halo-dunia instalasi npm npm mulai -- --peluncuran
Jika Anda ingin menginstal addon di Stremio versi Desktop (yang dapat Anda unduh di sini), Anda harus menggunakan npm start -- --install
Semua dokumentasi kami ada di sini di GitHub. Lihat daftar contoh kami untuk mengetahui beberapa informasi tingkat tinggi, atau selami langsung dokumentasi SDK kami untuk dokumen referensi kode kami.
Kami juga memiliki contoh addon yang dapat Anda gunakan sebagai panduan untuk membantu Anda membuat addon Anda sendiri.
Kami telah membuat dua panduan langkah demi langkah: satu untuk SDK ini, dan satu lagi untuk bahasa pemrograman apa pun, yang dapat Anda baca di sini.
Jika Anda tidak ingin menggunakan Node.js (dan karena itu juga tidak menggunakan SDK ini), Anda dapat membuat add-on dalam bahasa pemrograman apa pun, lihat spesifikasi protokol add-on untuk informasi lebih lanjut.
Dimungkinkan juga untuk membuat addon tanpa bahasa pemrograman apa pun, lihat contoh addon statis kami berdasarkan spesifikasi protokol.
Fitur SDK Termasuk:
Menerbitkan add-on melalui HTTP
Publikasikan tautan addon Anda ke koleksi Addon publik dengan publikasikanToCentral
Membuat beranda untuk addon Anda yang menyertakan tombol "Instal Addon".
Bagi pengembang yang mencari cara cepat untuk menguji add-on baru mereka, Anda dapat:
Uji dengan Stremio
Uji dengan Versi Web kami
Agar addon Anda dapat digunakan oleh orang lain, addon tersebut harus disebarkan secara online.
Anda dapat memeriksa daftar penyedia hosting yang kami rekomendasikan untuk Node.js atau menghostingnya secara lokal dengan localtunnel.
Setelah Anda menerapkannya secara publik, agar addon Anda ditampilkan di Stremio (melalui koleksi Addon publik), Anda perlu menggunakan publikasikanToCentral atau publikasikan secara manual melalui UI.
Lihat daftar contoh dan tambahan demo kami yang terus bertambah. Daftar ini juga mencakup contoh & tutorial tentang cara mengembangkan add-on Stremio di PHP, Python, Ruby, C#, Rust, Java dan Go. Ini juga mencakup daftar video tutorial.
Ada versi Rust pihak ketiga dari SDK ini yang dibangun di atas stremio-core yang dikembangkan oleh Sleeyax di sini.
Ada versi Go pihak ketiga dari SDK ini yang dikembangkan oleh doingodswork di sini.
Baca panduan kami untuk penggunaan tingkat lanjut guna memahami berbagai cara penggunaan add-on.
Jika Anda memiliki masalah apa pun terkait Stremio Addon SDK, silakan laporkan di sini.
Untuk bermigrasi dari v0.x, Anda perlu:
ubah new addonSDK menjadi new addonBuilder , yang dapat Anda impor melalui const addonBuilder = require('stremio-addon-sdk').addonBuilder
ubah addon.run(opts) menjadi serveHTTP(addon.getInterface(), opts) , yang dapat Anda impor melalui const serveHTTP = require('stremio-addon-sdk').serveHTTP
semua penangan harus mengembalikan Promise (daripada mengambil cb )
Penggunaan SDK ini tidak wajib untuk membuat Stremio Addons. Anda dapat menggunakan bahasa pemrograman apa pun yang mendukung pembuatan server HTTP untuk membuat Stremio Addons. Lihat spesifikasi protokol kami untuk detail dan contoh.
Salah satu skenario berguna jika tidak menggunakan SDK adalah ketika Anda memerlukan data spesifik pengguna untuk addon Anda (misalnya, Token Otentikasi API), Anda dapat melihat contoh meneruskan data spesifik pengguna di URL Addon di sini. Contoh ini menggunakan Node.js dan Express untuk mendapatkan data spesifik pengguna. (Pembaruan: Addon SDK sekarang mendukung pengaturan pengguna)
dibangun dengan cinta dan keterampilan pengkodean yang serius oleh Tim Stremio
