Yahoo Connected TV Release Notes

This document contains confidential, proprietary information of Yahoo! Inc. Unauthorized copying, reproduction or disclosure of any portion of the contents of these materials by any means—including printed or duplicated materials, on-screen publication or Web documentation—is expressly forbidden.

INFORMATION IN THIS DOCUMENT IS PROVIDED IN CONNECTION WITH YAHOO! INC. PRODUCTS. NO LICENSE, EXPRESS OR IMPLIED, BY ESTOPPEL OR OTHERWISE, TO ANY INTELLECTUAL PROPERTY RIGHTS IS GRANTED BY THIS DOCUMENT. YAHOO! INC. ASSUMES NO LIABILITY WHATSOEVER, AND YAHOO! INC. DISCLAIMS ANY EXPRESS OR IMPLIED WARRANTY, RELATING TO SALE AND/OR USE OF YAHOO! INC. PRODUCTS INCLUDING LIABILITY OR WARRANTIES RELATING TO FITNESS FOR A PARTICULAR PURPOSE, MERCHANTABILITY, OR INFRINGEMENT OF ANY PATENT, COPYRIGHT OR OTHER INTELLECTUAL PROPERTY RIGHT. UNLESS OTHERWISE AGREED IN WRITING BY YAHOO! INC. THE PRODUCTS ARE NOT DESIGNED NOR INTENDED FOR ANY APPLICATION IN WHICH THE FAILURE OF THE PRODUCT COULD CREATE A SITUATION WHERE PERSONAL INJURY OR DEATH MAY OCCUR.

Yahoo may make changes to specifications and product descriptions at any time, without notice. Designers must not rely on the absence or characteristics of any features or instructions marked “reserved” or “undefined.” Yahoo reserves these for future definition and shall have no responsibility whatsoever for conflicts or incompatibilities arising from future changes to them. The information here is subject to change without notice.

Yahoo and the Yahoo logo are trademarks of Yahoo! Inc.

Third party trademarks and images shown are the property of their respective owners. The KONtx API Reference is neither affiliated with nor endorsed by the owners of the third party images, names and logos displayed herein.

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

Abstract

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 https://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