MIAGET SDK 1.7

Geliştirici wiki

İlk Miaget’inizi oluşturun, yerel olarak kurun ve güncellemeye hazırlayın.

1. Paket yapısı

Miaget, kökünde manifest.json ve HTML giriş dosyası bulunan bir .miaget arşividir. Küçük harfli reverse-domain kimliği sabit tutun, sürüm için SemVer kullanın. tr-TR ve en-US metinlerini tanımlayın.

my-widget/
  manifest.json
  index.html
  widget.js
  style.css
  assets/logo.png

Logo zorunludur. Store bannerı isteğe bağlıdır ve kullanılırsa 1920 × 720 olmalıdır. TypeScript kullanıyorsanız paketlemeden önce JavaScript’e derleyin.

2. SDK ve izinler

Miaget içinden window.mia kullanın. Ağ, depolama ve medya erişimi için gereken izinleri manifestte bildirin. Node.js, doğrudan dosya erişimi ve uzaktan yüklenen betikler Miaget ortamında kullanılamaz.

const context = await window.mia.widget.getContext()
document.documentElement.lang = context.locale
window.mia.settings.get()
Manifestte tanımlı ayarları okuyun.
window.mia.storage.get(key)
Örneğe özel veriyi okuyun. İzin storage.local
window.mia.network.fetch(url)
HTTPS kaynağı network.origins listesinde olmalıdır. İzin network.fetch
window.mia.media.getState()
Windows medya durumunu okuyun. İzin media.read
window.mia.audio.getOutputs()
Etkin ses çıkışlarını listeleyin. İzin audio.spectrum
window.mia.audio.getSpectrum({bands:32})
Gerçek 6/16/32/64 frekans bandı, peak ve RMS. WASAPI çıkış analizi cihazda yapılır; mikrofon ve ham ses erişimi yoktur. İzin audio.spectrum
window.mia.audio.subscribeSpectrum(listener, options, onError)
Varsayılan 12, en fazla 15 FPS; gizlenince duraklar. Dönen fonksiyonu kapatırken çağırın. İzin veya host hatasında abonelik biter.
window.mia.system.getDisplays() / getBattery() / getUptime()
Ekran/DPI, sistem pili ve Windows çalışma süresi. İzin system.basic
window.mia.system.telemetry()
CPU/RAM, disk ve ağ hızları. İzin system.telemetry

Yeni ses API’leri için sdkVersion alanını >=1.7.0 <2.0.0 yapın ve audio.spectrum iznini bildirin. Analiz seçilen çıkışın tüm sesini kapsar; uygulamaya özel değildir. outputId verilmezse Windows varsayılanı izlenir. Yanıtta bands 0–1 değerleri, frequencyEdges Hz sınırları, supported/silent durumları bulunur.

4. Yayın başvurusu

Hesabınıza giriş yapın ve Yayın başvuruları bölümünden .miaget dosyanızı (en fazla 25 MiB) inceleme notuyla gönderin. Başvurularım bölümünden sonucu takip edin. Başvuru doğrudan yayın değildir; moderasyon ve imzalı yayın hazırlığı tamamlanmalıdır. Güncellemede aynı id ile version artırılır ve yeni başvuru gönderilir.

Yayın başvurularına git

3. Kurulum ve güncelleme

MiaGet kaynak dizininden doğrulayan paketleyiciyi çalıştırın. Üretilen dosyayı MiaGet → Yerel paketler üzerinden seçip izinleri inceleyin.

npm.cmd run pack:widget -- ./my-widget ./my-widget.miaget
npm.cmd run widget:create -- ./my-widget dev.example.my-widget
npm.cmd run widget:check -- ./my-widget

Bir güncellemede ID’yi koruyup sürümü artırın. Kaynaklar, ayarlar, izinler ve ağ olmadığında gösterilen durumları gerçek Miaget ortamında deneyin.