Note that this Wiki is a work in progress, items may not be updated or may disappear entirely as the pages are updated.

PlayerSDK HTMLView Tutorial1

From SpacialAudio

Jump to: navigation, search

The method described in this is by far the quickest way to get up and running with HTMLView support for your ASX files. This method shows your original HTMLView page, but as soon as an in-stream advertisement plays ... a new HTMLView page will be displayed that only shows the synchronized banner and text content (and video in case of 1-to-1 targeted video ads).

This method has advantages and disadvantages:

  • Advantages
    • You can literally implement this in minutes.
    • You do not have to change anything on your existing HTMLView pages and can also edit them freely in the future without the fear of breaking anything.
    • Because viewers are presented with an isolated view of the ads, it should improve response providing more value to advertisers.
  • Disadvantages
    • The ads interrupt the visitor's experience on your HTMLView pages. If you have highly interactive items like chat on your HTMLView pages it might be annoying to your users to be temporarily unable to use it.
    • You do not take advantage of the full power of the Player SDK like being able to show what's playing currently in real-time.

We recommend this as a "quick fix" solution to get your HTMLView instantly compatible with StreamAds synchronized content and allow for client-side 1-to-1 targeted audio and video ads. Longer term though we recommend spending the time updating your HTMLView page to allow for direct integration with the Player SDK. (Please refer to later tutorials that covers this in detail)


Live example

Click here to see a live example implementation.


How it's done

Say for example your original HTMLView page is located at http://www.myradio.com/minipage.html.

Create a a file called fsHTMLView.html

  1. [html]
  2. <head>
  3. <title>Slo Radio Player</title>
  4. </head>
  5. 	<frameset id="idFrameSet" rows=*,0>
  6.         <frame src="http://www.myradio.com/minipage.html" name="frmMain" id="frmMain" noresize frameborder="0">
  7.         <frame src="http://media.streamads.com/playersdk/v2/widgets/htmlview/frameset/syncframe.html?sid=41404&pid=12997" name="frmTop" id="frmTop" noresize frameborder="0" scrolling="no">
  8. 	</frameset>
  9. [/html]

Note: Replace the brackets in [html] and [/html] with < > - for some reason we are unable to submit code to the wiki if it contains the html tags.

At the first frame, make sure to set the source to the original location of your HTMLView page. On the second frame make sure to set your pid to your StreamAds publisherID. The sid is optional (and is your AudioRealm stationID)

Now upload this file to your webserver and change your ASX to point to this new file instead of your original HTMLView page.

Example:

  1. <ASX version="3.0">
  2.   <PARAM name="HTMLView" value="http://www.myradio.com/fsHTMLView.html"/>
  3.   <entry><ref href="mms://wm7.spacialnet.com/myradio"/></entry>
  4. </ASX>

Related links

Personal tools