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 git3. 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.