How To Add Pugpig Sounds

Note: Currently available on iOS, Android (Pugpig for Magazines or Continuous Publishing iOS v1.2+ applications) and Web (Pugpig for Magazines v1.2+).

Pugpig Sounds is a feature of Pugpig Products. Use our built-in sounds interface and player to provide embedded audio files along with your content whether it's podcasts or music. We can also provide a standalone Sounds module if you wish to use it in your Pugpig SDK application. 

Important! Background Audio Mode needs to be explicitly set on iOS, please see more information below.

Purpose

Our Sounds feature has been built to support the following use cases:

• When audio is relevant to the copy on a particular page of an edition 
• When audio is relevant to the entire edition

We currently do not support a sounds player interface in the edition selector however sound can continue to play if the app is in the background on device. Embedded audio only, streamed audio is not supported at the moment. 

Display

When one or more pages in your edition includes a sound file, an icon will appear in the page toolbar to indicate the presence of audio. The icon set supports the following three states:

1.  Sounds: audio is present in the edition user is in
2.  Sounds On: audio is present in the page user is on
3.  Sounds Playing: audio is currently playing

All tracks in the edition will appear in a listed panel (full width and height on mobile, overlay on tablet), you can display an optional icon per track. Tracks associated to the page user is on are highlighted in the list. We display an animated equaliser icon next to the track being played.  

Enable in app

To enable Sounds in a Pugpig Products application requires configuration on the server side. You need to add audio files to your templates and atom feed. There is no Sounds app feature to switch on in the Config.plist file however you should make use of Background Audio Mode explained below.

Background Audio Mode

Important!

Background audio mode should also be turned on in the target's capabilities, so that users may continue to listen to sounds with the app in the background. To enable Background audio mode:

1. Make sure the project (the top most item) is selected in the file inspector on the left of your Xcode window
2. Select the relevant target under the “Targets” heading
3. Select the capabilities option in the middle of the window slightly beneath the top
4. Turn on the “Background Modes” option
5. Tick the “Audio and Airplay” option which should have appeared

Note: if you enable background audio it is imperative that you have sounds in your app content when you submit for Apple approval. We advise adding to the Apple tester notes some detail as to why you have chosen to use Background Mode and the benefits to your users app experience. Additionally note that you cannot use placeholder content at submission time as this is against the App Store review guidelines.