• How to filter audio-only rendition in Apple HLS auto-generated multi-bitrate playlist (ModuleCupertinoAutoMultibitrateFilter)

    When you configure a live application in Wowza Streaming Engine to create streams that are compliant with the Apple App Store, one of the requirements is to create an audio-only rendition of the stream for delivery to Apple iOS devices. A special multi-bitrate playlist is created that includes an audio-only rendition but this playlist may cause playback problems with other players that support Apple HLS playback. Use this module to filter player connections based on a player's User Agent string in order to turn off the audio-only stream for players that have trouble playing the stream correctly.

    • This module requires Wowza Streaming Engine™ 4.2 or later.

    • This module will only work with live applications that are configured to create streams that are compliant with Apple App Store 3G rules. For more information on how to configure live applications to meet these requirements, see How to create Apple App Store compliant streams.
    A compiled version of this module is included in the Wowza Module Collection.


    To enable this module, add the following module definition to your application. See Configure modules for details.

    Fully Qualified Class Name
    ModuleCupertinoAutoMultibitrateFilter Filter players for App Store compliant streams com.wowza.wms.plugin.collection.module.ModuleCupertinoAutoMultibitrateFilter


    After enabling the module, you can adjust the default settings by adding the following properties to your application. See Configure properties for details.

    Root/Application cupertinoAutoMultibitrateFilterUserAgents String Macintosh;|iPhone;|iPad;|iPod;|AppleTV A list of User Agent strings to match. The strings are separated by the pipe (|) character. Set this property only if you need change the default values (default: Macintosh;|iPhone;|iPad;|iPod;|AppleTV).
    Root/Application cupertinoAutoMultibitrateFilterDebugLog Boolean true Enables logging of the filter setting and User Agent for each connection (default: false).

    Wowza media server software and all components, including modules, source code, and other related items offered on this page, are copyrighted (c) 2006-2015 by Wowza Media Systems, LLC, all rights reserved, and are licensed pursuant to the Wowza Media Software End User License Agreement.
    Originally Published: For Wowza Streaming Engine 4.2 on 06-16-2015.

    If you're having problems or want to discuss this article, post in our forum.