Yahoo! Connected TV Release Notes

Abstract

Use of this document is subject to the Yahoo! Connected TV Developer Terms of Use license.

This document provides the release notes for the latest version of the Yahoo! Connected TV App Development Kit (ADK). For the latest information on Yahoo! Connected TV, see the Yahoo! Connected TV Forums.

For more information please review the documentation available on the Yahoo! Developer Network.

YCTV-ADK v1.3

Release Date: May 2012

Release Notes for YCTV-ADK v1.3

  1. This ADK comes with its own Ubuntu Virtual Machine (VM), with support for both VMware and VirtualBox on PCs and Macs. This VM will help prevent many of the compatibility issues experienced by some developers with the previous version. Detailed installation instructions are on the YDN site located at http://developer.yahoo.com/connectedtv/installguide/index.html, including links to download both the Ubuntu VM and the YCTV-ADK package.
  2. Once you have installed VMware or VirtualBox, perform all system updates/upgrades before running the Ubuntu 10.04 VM provided by Yahoo!. After opening and running the provided VM, do not attempt to update/upgrade VMware or VirtualBox again as it may change ADK dependencies. Yahoo! has optimized and tested the ADK to run in this specific configuration and does not guarantee compatibility if any software updates are made to the VM, Ubuntu, or if other versions are used. This ADK is designed to run on top of a stripped-down version of Ubuntu 10.04 LTS VM which has been extensively tested by Yahoo! on the following versions of VMware and VirtualBox:
    • Mac OS 10.6.4
      • VMware Fusion 3.1
      • Virtual Box 3.2.8
    • Windows 7
      • VMware Player 3.1.1
      • VMware Workstation 7.1
      • Virtual Box 3.2.8

    You should not attempt to update the development environment. System updates for this VM have been disabled to prevent support issues with Ubuntu 10.04 configurations that have not been tested by Yahoo! Connected TV.

  3. If you are using VirtualBox you should browse to and open the ubuntu_10.04_ctv.vmdk file directly. If you are using VirtualBox and have previously installed VMware Fusion, you need to right-click on the package folder and select Show Package Contents and then move the .vmdk file to a new location before use.
  4. The following connection modes are supported:
    • Connect in Bridged Mode: Make sure that the VM has connectivity by browsing any web page. Launch the Applications→Yahoo! CTV-ADK→Device Communication Simulator. Launch the Android Connected TV app from Google Play and let it auto-discover the Simulator in the list of available devices on the same local network.
    • Connect in NAT Mode: Follow the same steps as for the Bridged Mode above, except that Network Settings must be configured to forward port 8099 to the VM, otherwise the Android Connected TV app will not be able to connect to the Device Communication Simulator on the local network. Auto-discovery is not supported when connected in NAT mode due to security issues.
  5. The Simulator will fail to initialize over slow networks. Your Internet connection download speed must be at least 1.5Mbps.
  6. Intermittently, the Simulator fails to bind to the Device Communication port. Restart the Simulator to resolve this error. To verify this state, check the log for an "Unable to Bind to Port" error message. Go to the Profile app→System Settings→System Status menu and verify that the Device Communication status is inactive.
  7. The unique Application Key provided in the ADK sample code does not work in the production environment. You must create your own developer Application Key through YDN.
  8. The /clear command is not working in the Simulator Console.

Table of Contents