PackageTrack
Sign in Get early access

admel_sdk

AdMel SDK for Flutter - Audio advertisement plugin with banner display, VAST support, mute detection, and auto-refresh.

1.1.2 admel-tech/admel-flutter

What this package is like to depend on

Last release 1 months ago

16 Jul 2026

Ships fairly regularly

a new release about every 4 weeks

Most releases are documented

notes for 31 of 36 stable releases

Nothing withdrawn

no release was ever pulled

5 months old

36 releases · first in 2026

36 releases in the last 12 months

see the full history below

Release timeline

36 releases · Mar 2026 to Jul 2026
Release Pre-release

Releases

latest 36
  1. 1.1.2 16 Jul 2026
    Release notes
    • Feature: 広告ロード失敗（no-fill/エラー）を Dart に通知。setAdEventListeners に onAdFailedToLoad(String reason) を追加。VAST 取得/パース失敗や広告無し（reason: 'load_failed'）、 音声/画像欠落（'invalid_creative'）の際に発火する。
      • これまで showAd() はロード失敗でも常に成功で解決していたため、広告が実際に表示されたか アプリ側で判別できなかった問題を解消。API 追加のみで既存挙動は不変。
    • Docs: パッケージ README を現行 API（1.1.x）に全面刷新。
    Open source →
  2. 1.1.1 15 Jul 2026
    Release notes
    • Feature: スキップ可能広告に対応。VAST の <Linear skipoffset="HH:MM:SS"> を解析し、 再生位置がオフセットに達するとバナー右上に「✕」スキップボタンを表示する。
      • スキップ時: <Tracking event="skip"> を発火（{progress} マクロ対応）→ 広告を終了 （complete は発火しない）→ onAdStopped → 次の自動リフレッシュは通常どおり。
      • skipoffset の無い広告（従来の広告）は挙動変更なし。Dart API の変更なし （スキップ UI・挙動はネイティブ内で完結）。
    Open source →
  3. 1.1.0 14 Jul 2026
    Release notes
    • 構造変更: ネイティブ SDK をプラグインに同梱（機能・API の変更なし）。
      • iOS: AdMel-SDK pod（バイナリ配布）への依存を廃止し、ネイティブコアのソースを ios/Classes/Core/ に同梱。CocoaPods trunk / CDN 伝播待ちが不要に。
      • Android: jp.admel:admel-sdk（Maven Central）への依存を廃止し、Kotlin ソースを android/src/main/kotlin/jp/admel/sdk/ に同梱。
      • ネイティブコアは Flutter 非依存を維持（CI の境界チェックで担保）。Unity 等ネイティブ利用者向けの単独ビルドは tools/native-core/ で可能。
      • 旧 admel-native-sdk リポジトリは v1.0.19 で凍結。
    Open source →
  4. 1.0.38 09 Jul 2026
    Release notes
    • Improve: animation: 'scale' 指定時、広告バナーの退出時もスケールアウト（縮小＋フェード）で消えるように統一。以前は出現がスケール、退出がスライドアウトで不揃いだった。
      • iOS: transform を等倍→0.01 に縮小＋alpha 0（0.3s）。Android: scaleX/scaleY 1→0＋alpha 0（0.3s）。'slide'（デフォルト）は従来どおりスライドアウト。
      • ネイティブ SDK 依存を iOS AdMel-SDK ~> 1.0.19 / Android jp.admel:admel-sdk:1.0.19 に更新。
    Open source →
  5. 1.0.37 09 Jul 2026
    Release notes
    • Feature: showAd(..., animation: 'slide' | 'scale') — 広告バナーの出現アニメーションを選択可能に。'slide'（デフォルト、従来どおり画面端からスライドイン）に加え、'scale' で出現位置からバネで弾むスケールアップ表示ができる。
      • iOS: usingSpringWithDamping によるスプリングアニメーション（damping 0.6）。Android: OvershootInterpolator で 0→等倍にスケール。
      • ネイティブ SDK 依存を iOS AdMel-SDK ~> 1.0.18 / Android jp.admel:admel-sdk:1.0.18 に更新（バナーマネージャーに bannerAnimationStyle を追加）。
    Open source →
  6. 1.0.36 23 May 2026
    Release notes
    • Feature: enableBgmDucking(onDuck, onRestore) API — ホストアプリの BGM 音量を広告再生中に自動制御する仕組みを追加。アプリは音量変更のコールバックを1回登録するだけで、広告開始/終了のタイミング判定・ポーリングは SDK が管理する。setAdEventListeners とは独立して動作し、共存可能。
      • iOS / Android 共に、OS レベルのオーディオダッキング（duckOthers / AUDIOFOCUS_GAIN_TRANSIENT_MAY_DUCK）は同一アプリ内の音声には効かないため、Dart レイヤーで明示的に制御する方式に変更。
    • Feature: disableBgmDucking() — ダッキングを無効化。現在ダッキング中の場合は onRestore を呼んでから解除。
    Open source →
  7. 1.0.35 22 May 2026
    Release notes
    • Fix (Android): Add setAllowedCapturePolicy(ALLOW_CAPTURE_BY_ALL) to AudioAttributes on MediaPlayer so that ad audio is captured by Android screen recording. Without this explicit policy, screen recorders on Android 10+ may silently exclude the audio track. Raise Android native SDK dependency to jp.admel:admel-sdk:1.0.17.
    Open source →
  8. 1.0.34 22 May 2026
    Release notes
    • Fix (Android): Set AudioAttributes (USAGE_MEDIA / CONTENT_TYPE_MUSIC) on MediaPlayer to ensure audio ads are captured by Android screen recording when the host app enables allowAudioPlaybackCapture. Raise Android native SDK dependency to jp.admel:admel-sdk:1.0.16.
    Open source →
  9. 1.0.33 11 May 2026
    Release notes
    • Fix (iOS): VAST parser now correctly detects audio and image URLs that have no file extension. Previously, MediaFile URLs were matched by extension (.mp3, .wav, .m4a) only, causing production creative URLs to fail with "Missing audio or image URL in VAST". The parser now checks the type attribute (audio/mpeg etc.) first, falling back to extension matching. Same fix applied to StaticResource image detection via creativeType attribute. Raise iOS native SDK dependency to AdMel-SDK ~> 1.0.16.
    Open source →
  10. 1.0.32 10 May 2026
    Release notes
    • Fix: onAdStarted / onAdStopped callbacks now reliably fire on Android during gameplay. Added Dart-side polling (500ms interval via isPlaying()) to supplement native→Dart invokeMethod callbacks, which can be dropped on Android when the Flutter engine is busy rendering. Native callbacks remain active as a fast-path on iOS.
    Open source →
  11. 1.0.31 08 May 2026
    Release notes
    • Fix: onMuteStateChanged callback now reliably fires on Android during gameplay. Added Dart-side polling (2-second interval via isMuted()) to supplement native→Dart invokeMethod callbacks, which can be dropped on Android when the Flutter engine is busy rendering. Native callbacks remain active as a fast-path on iOS.
    Open source →
  12. 1.0.30 06 May 2026
    Release notes
    • Feature: showAd() now supports custom-center positioning via relativeX / relativeY. When these parameters are provided, the ad banner is centered at the specified screen coordinate (expressed as a 0.0–1.0 ratio of screen width/height) instead of being placed from its top-left corner. This eliminates off-center placement caused by banner size differences between iPhone and iPad.
    • Raise minimum native SDK dependency to 1.0.15 (iOS: AdMel-SDK ~> 1.0.15, Android: admel-sdk:1.0.15).
    Open source →
  13. 1.0.27 29 Apr 2026
    Release notes
    • Revert: restore standard CocoaPods (iOS) and Maven Central (Android) dependencies for native SDK distribution. Removes experimental binary bundling approach (1.0.21–1.0.26).
    Open source →
  14. 1.0.26 29 Apr 2026

    Nothing published for this version

  15. 1.0.25 29 Apr 2026

    Nothing published for this version

  16. 1.0.24 29 Apr 2026

    Nothing published for this version

  17. 1.0.22 29 Apr 2026

    Nothing published for this version

  18. 1.0.21 29 Apr 2026

    Nothing published for this version

  19. 1.0.20 29 Apr 2026
    Release notes
    • Fix: ad playback now pauses (instead of stops) when device volume drops below the mute threshold during playback. Raising the volume resumes the ad from where it left off.
    • Raise minimum native SDK dependency to 1.0.13 (iOS: AdMel-SDK ~> 1.0.13).
    Open source →
  20. 1.0.19 28 Apr 2026
    Release notes
    • Fix: startDucking is now called on onAdStarted (when ad audio actually begins) instead of showAd (when the ad is requested). Previously, ducking was activated immediately at showAd time, causing host app BGM/SE to be unnecessarily ducked during the initialRefreshInterval wait period before the first ad plays.
    • Change: mute detection threshold lowered from 30% to 20%.
    • Raise minimum native SDK dependency to 1.0.12 (iOS: AdMel-SDK ~> 1.0.12).
    Open source →
  21. 1.0.18 28 Apr 2026
    Release notes
    • Raise minimum native SDK dependency to 1.0.11 (iOS: AdMel-SDK ~> 1.0.11).
    Open source →
  22. 1.0.17 28 Apr 2026
    Release notes
    • Fix: stopDucking now reactivates the AVAudioSession with Playback + MixWithOthers after sending NotifyOthersOnDeactivation. On iPadOS, leaving the session inactive caused outputVolume to return 0.0, making isMuted() always report muted and permanently showing the volume warning overlay. This also prevents host app BGM/SE (audioplayers) from failing to resume after ad playback.
    • Fix: volume change detection now uses KVO on AVAudioSession.outputVolume (public API) instead of the private AVSystemController_SystemVolumeDidChangeNotification, which stopped firing reliably on iOS 16+. This ensures onMuteStateChanged(false) is delivered promptly when the user raises the device volume.
    • Raise minimum native SDK dependency to 1.0.10 (iOS: AdMel-SDK ~> 1.0.10).
    Open source →
  23. 1.0.16 24 Apr 2026
    Release notes
    • Fix: infinite recursion crash in setMuteBannerEnabled: (iOS). The method was calling self.muteBannerEnabled = enabled which in Objective-C invokes the setter itself. Fixed by assigning directly to the instance variable _muteBannerEnabled.
    • Raise minimum native SDK dependency to 1.0.9 (iOS: AdMel-SDK ~> 1.0.9).
    Open source →
  24. 1.0.15 24 Apr 2026
    Release notes
    • Fix: crash on app startup caused by startMonitoring firing checkMuteStatus synchronously during the initialize method channel handler. The initial check now runs on the next run loop iteration via dispatch_async (iOS), avoiding reentrant invokeMethod calls.
    • Raise minimum native SDK dependency to 1.0.8 (iOS: AdMel-SDK ~> 1.0.8).
    Open source →
  25. 1.0.14 24 Apr 2026
    Release notes
    • Fix: onMuteStateChanged callback now fires even when muteBannerEnabled is false or SDK is paused. Previously, the callback was blocked by early returns in the banner control logic, causing apps that disabled the mute banner to never receive mute state change notifications.
    • Raise minimum native SDK dependency to 1.0.7.
    Open source →
  26. 1.0.13 24 Apr 2026
    Release notes
    • Fix: mute monitoring now starts at initialize() instead of showAd(), so onMuteStateChanged fires and isMuted() returns accurate results before the first ad plays.
    • Fix: isMuted() reads the current device volume directly instead of returning a cached value, eliminating false negatives before monitoring starts.
    • Raise minimum native SDK dependency to 1.0.6 (iOS: AdMel-SDK ~> 1.0.6, Android: admel-sdk:1.0.6).
    Open source →
  27. 1.0.12 24 Apr 2026
    Release notes
    • Fix: raise minimum native SDK dependency to 1.0.5 (iOS: AdMel-SDK ~> 1.0.5, Android: admel-sdk:1.0.5) to prevent build errors when using new APIs added in 1.0.11.
    Open source →
  28. 1.0.11 24 Apr 2026
    Release notes
    • Feature: setMuteBannerEnabled(bool) — ミュートバナーの表示/非表示をアプリ側から制御可能に。false に設定すると既存のミュートバナーも即時非表示。デフォルト true。
    • Feature: isMuted() — デバイスの現在のミュート状態（音量 30% 以下）を非同期で取得。
    • Feature: onMuteStateChanged コールバック — デバイスがミュート閾値を超えた/下回ったときにアプリへ通知。setAdEventListeners で登録可能。
    • Fix: SDK が pause 中はミュートバナーを表示しないよう修正（iOS・Android 共通）。
    • Update native SDK dependency to 1.0.5 (Android: admel-sdk 1.0.5, iOS: AdMel-SDK 1.0.5).
    Open source →
  29. 1.0.10 22 Apr 2026
    Release notes
    • Feature: initial refresh interval before the first ad plays. The SDK now waits initialRefreshInterval seconds (default 30s, dev: 5s) after showAd() is called before fetching and playing the very first ad. The value is overridden by the server's /v1/init response (initialRefreshInterval / refreshInterval fields), matching the Unity plugin behavior.
      • Android: AdMelSDK.isFirstPlay flag + Handler.postDelayed
      • iOS: AdMelSDK.isFirstPlay flag + dispatch_after
    Open source →
  30. 1.0.9 21 Apr 2026
    Release notes
    • Update native SDK dependency to 1.0.3 (Android: admel-sdk 1.0.3, iOS: AdMel-SDK 1.0.3).
    Open source →
  31. 1.0.6 10 Mar 2026
    Release notes
    • Fix: iOS linker error - add static_framework and -ObjC linker flag for static library xcframework
    Open source →
  32. 1.0.5 10 Mar 2026
    Release notes
    • Fix: iOS use @import AdMelSDK module import for static library xcframework
    Open source →
  33. 1.0.4 10 Mar 2026
    Release notes
    • Full API update: AdMelSdk, AdMelEnvironment, showAd(), setMediaId(), setUserId()
    • Ad lifecycle events (onAdStarted, onAdStopped, onAdCompleted)
    • Coin reward animation support
    • Environment-based initialization (development/production)
    • Native plugin sync for both iOS and Android
    Open source →
  34. 1.0.3 10 Mar 2026
    Release notes
    • Fix: iOS import for AdMelSDK framework header
    Open source →
  35. 1.0.2 10 Mar 2026
    Release notes
    • Fix: Android Kotlin import for renamed AdMelSDK native class
    Open source →
  36. 1.0.1 10 Mar 2026
    Release notes
    • Initial public release
    • Audio ad playback with VAST protocol support
    • Banner ad display with customizable appearance
    • Mute detection and visual banner fallback
    • Auto-refresh for continuous ad rotation
    • Playback controls (pause, resume, stop)
    • Volume control
    • iOS support via AdMel-SDK (CocoaPods)
    • Android support via jp.admel:admel-sdk (Maven Central)
    Open source →

Every package, every release, already written down.

The archive is open and free. Watching your own project is what we are building next.

Browse the archive