CreativeRoadshow

1.0.0-rc.2 (2015-07-02)

License

For Tremor Video internal use only. Tremor Video 2015

Authors

Leandro Silva

System Requirements

• Mac OS X >= 10.6
• Windows >= 7

Quick Links

• Description
• Documentation
  • Setup
  • Content
  • Menu
• Changelog
• Known Bugs

Description

Developed for the Creative Department, this application has two main features. The first and primary feature provides a presentation layer to help Creative Managers sell our talent when meeting with prospective clients. The second feature, and backbone of the this application, automatically localizes our creative units so that they can be shown without internet access. This application can localized both instream and mobile units and does so by automatically downloading all assets (from multiple locations) and re-writing the data to point to a local server path. Due to the nature of the ads, a local server must be running in order to properly serve localized units.

Automated Instream Process

Upon inputting a CU id, the app automates the following:

1. Create temporary directory.
2. Download Ad Schedule.
   • [Tremor Video demo domain]/creative/cat/demo/CUs/[cu]/adschedule.xml
3. Read CU directory name and CDN path from Ad Schedule.
4. Edit file to localize path.
5. Download Policy file.
   • [Tremor Video demo domain]/creative/cat/demo/CUs/[cu]/policy.xml
6. Edit file to localize path.
7. Get bin directory from CDN.
8. Rename temporary directory to proper CU directory name (read from Ad Schedule)

Automated Mobile Process

Upon inputting an MCS id, the app automates the following:

1. Download MCS unit zip file.
   • [Tremor Video mobile domain]/toolkit/server/creative/_export/[id]/[id].zip
2. Unzip file.
3. Unzip nested creative.zip.
4. Download response JSON.
   • [Tremor Video mobile domain]/toolkit/server/creative/_demo/[id]/response.txt
5. Download lookup file.
   • [Tremor Video mobile domain]/toolkit/server/creative/_demo/[id]/lookup.js
6. Download videos (look in response JSON object for videos to download).
7. Edit file to localize paths.

Documentation

Setup

Upon opening, you will be asked to select a directory to store your app files. This directory should include the following:

• content.json
• slide/
• splash/
• transition/

Upon selecting a storage directory, a new directory (dep/) will be automatically created to store some app dependencies. There is no need to interact with these dependencies.

An example content file looks like this:

{
    "splash": {
        "file": "mystic.png",
        "height": "100%"
    },
    "sections": {
        "section1": {
            "title": "My Section",
            "transitionImg": "trans.jpg",
            "slides": [
                "image.gif",
                {
                    "file": "image2.jpg",
                    "screen": "tv"
                }
            ]
        }
    }
}

An example directory structure that matches the above:

my-directory
    |
    |- content.json
    |
    |- dep (auto created)
    |
    |- slide
    |    |
    |    |- image.gif
    |    |
    |    `- image2.jpg
    |
    |- splash
    |    |
    |    `- mystic.png
    |
    `- transition
        |
        `- trans.jpg

Content

To add a new section, simply add a new object to your content file.

"my-unique-name": {
    "title": "",
    "transitionImg": "",
    "slides": []
}

Notes:

• The current 'screen' options are "iphone6", "laptop", and "tv."
• To perfectly fit your ad on a 'screen,' use the following heights:
  • iphone6 = 70%
  • laptop = 85%
  • tv = 90%
• The 'height' object accepts any value allowed in CSS (i.e. px, %, em).
• The current 'type' options are "mobile," "instream," and "video."
• The supported video types are flv, f4v, mp4, m4v, and mov.

• The "slides" array:

  • Accepts a string if adding an image.

  • If adding any other accepted type, or if you want to customize how the image is displayed, use an object.

      {
          "file": "spr_CU12345",
          "type": "instream", //optional
          "screen": "laptop", //optional
          "height": "500px", //optional
          "desc": "Hello" //optional
      }
    

Menu

On Windows, the cmd key is mapped to the ctrl key.

• File
  • Check for Update…
  • Documentation
  • Set Save Directory…
• Window
  • Toggle Fullscreen (cmd + f)
  • Dev Tools…
    • Opens the developer tools (password protected and for admins only).
• Localize
  • MCS
    • Initiates the mobile localization process.
  • Instream
    • Initiates the instream localization process.
• Navigate
  • Remote controller
    • Allows you to control the presentaion via another device on the same WIFI network (i.e. your phone or another computer).
    • Re-syncs your external device.
  • Next Section (down)
  • Prev Section (up)
  • Next Slide (right)
  • Prev Slide (left)

Additional Shortcuts

• cmd + [Number key] = Takes you to a specific section

Changelog

1.0.0-rc.2 (2015-07-02)

• Add download progress (%) to app download.
• Support password protected app distribution folder.
• Update LDAP server URI.
• Fix issue where down-arrow shortcut and up-arrow shortcut are flipped.
• Update backend menu logic.

1.0.0-rc.1 (2015-04-15)

• Automate adding app to Flash trusted location (for instream ads).
• Fix issue where Windows app crashes on MCS units.
• Localize instream default video.
• Only load Renderer on MCS units.
• Support Windows.
• Change iPhone6 screen background to black.
• Fix issue where an ad plays before the section transition completes.
• For SWFs, remove container background color and support transparency.
• Fix issue where iFrame focus disables app shortcuts.
• Update navigation shortcuts to simply use the arrow keys.

1.0.0-beta.1 (2015-04-07)

• Fix small icon alignment and transparency.
• Prevent pop up windows.
• Fix issue where instream units fail on end user machines.
• Update 'prepare' logic to be fully dynamic.
• Support video slides.
• MCS counter text is improperly styled.
• Replace python script with nwdirectory logic.
• Add version updater.
• Use WebSockets to create remote control.
• Create benchmarks.
• Create 'prepare' shell script.
• Create login logic.
• Create app icon.
• Support LDAP authentication.
• Create DateUtils Class.
• Create RESTCreative Class.
• Remove slide.width option from content json.
• Fully support MCS unit scaling.
• Fix bug where when using a screen background image and giving an ad a percentage width, resizing the app window to a 4:3 ratio causes a misalignment between the ad and the screen image.
• Validate slide.type and slide.screen nodes.
• Auto detect SWF slide.type.

1.0.0-alpha.2 (2015-03-11)

• Write docs and include link in app.
• Add description field to slides.
• Create splash page.
• Add "Active Directory" menu item.
• Add LocalHost close logic for proper app reloading.
• Add proper keyboard support (that is always in focus).
• Create nwjs non global keyboard support.
• Improve native menu support in AppUtils.

1.0.0-alpha.1 (2015-02-27)

• Initial release.

Known Bugs

• Instream takovers may not takeover outside of the ad.