Developer Console

Test Cases for Linear Apps

Here are some common test cases for your linear app. Please utilize these test cases when developing to ensure you are meeting the certification bar.

Entitlement

Live TV sources list

Test steps

  1. Using your Fire TV remote, go to Settings > Live TV > Sync Sources. On select Fire TV remotes, you can press the guide button

Expected results

  • Your app is listed in the Channel Guide

Clicking on the source name from Sync sources

Test steps

  1. Go to Settings > Live TV > Sync Sources
  2. Click on your app name
  3. Compare with expected results

Expected results

  • The user is taken to sync screen(is the best practice) or there is a toast message saying “channel sync started”(if there is limitation on implementing the sync screen), which should start a channel sync

Your app channels are listed in Channel Guide

Test steps

  1. Go to the Channel Guide using any of the methods listed below (some devices have other methods as well):
    • Hover over any live program > click the three lines menu button > select Channel Guide
    • Go to the options row in Live Tab
    • Go to Home Tab > On Now row > first item on the left
    • Go to Live tab > Guide & Your Recents > first item on the left

Expected results

  • The channel logos are correct as well as the channel name
  • Your app name and channels are listed as per the requirement in Channel Guide

Accessing the channel in entitled state

Test steps

  1. Make sure the user account is in entitled state

  2. Go to Settings > Live TV > Manage Channels

Expected results

  • Your app is displayed in live sources list
    • Clicking on your app displays a list of channels
  • Your app row shows up with channels in it
  • Channels for your app are displayed in On Now row

Installation

Downloading and installing app populates in the On Now row

Test steps

If the app has entitlement model:

  1. Install your app
  2. Go to Settings > Applications > Manage Installed Applications > select your app > launch app
  3. Log in with valid credentials
  4. Press Home button
  5. Go to Home tab > On Now row
  6. Compare with Expected results

If your app has an auto-entitlement model (channels are free):

  1. Install your app
  2. Press Home button
  3. Go to Home tab > On Now row
  4. Compare with Expected results

Expected results

Entitlement model:

  • All entitled channels from your app are instantly populated in the On Now row. User does not have to sync sources to get the channels after logging in

Auto-entitlement model:

  • All the channels from your app are instantly populated in the row. User does not have to open the app or sync sources to get the channels

Downloading and installing app populates your row in Live tab without syncing

Test steps

Entitlement model:

  1. Install your app
  2. Go to Settings > Applications > Manage Installed Applications > select your app > select launch app
  3. Log in with valid credentials
  4. Press Home button
  5. Go to Live tab
  6. Compare with Expected results

Auto-entitlement model:

  1. Install your app
  2. Press Home button
  3. Go to Live tab > Your app row
  4. Compare with Expected results

Expected results

Entitlement model:

  • A dedicated app row appears instantly in Live tab with all the channels populated in the row after logging in. User does not have to sync sources for the row to appear

Auto-entitlement model:

  • A dedicated app row appears instantly in Live tab with all the channels populated in the row after installing. User does not have to sync sources for the row to appear

No gray tiles are shown in your app’s row

Test steps

  1. Go to Live Tab > Your app’s row

Expected results

  • No blank tiles are seen in your app’s row

All channels are removed once user uninstalls the application

Test steps

  1. Go to Settings > Applications > Manage Installed Applications
  2. Select your app > Click on Uninstall
  3. Compare with Expected results

Expected results

Your app has been removed from the following places:

  1. Go to Settings > Live TV > Manage Channels
  2. Go to Settings > Live TV > Sync Sources
  3. Go to Live tab > your app’s row
  4. Go to Home tab > On Now row
  5. Go to Channel Guide
  6. Search results

Playback

Channel playback from Home tab in your app player or the native Fire TV player

Test steps

  1. Install your app
  2. Go to Home tab > On Now row
  3. Click on the program tile

Expected results

If using native Fire TV player:

  • Channel deep links play without crashes in native player

If using your own player:

  • Content start playing in your app player without entering your app's UI

Event playback from Live tab in your app player or native Fire TV player

Test steps

  1. Go to Live tab > Scroll down to your app’s row > Click on any of the event tile from your app’s row

Expected results

If using native Fire TV player:

  • Content start playing in the native player without entering your app's UI

If using your own player:

  • Content start playing in your Player without showing app home page

Live preview under focus state

Test steps

  1. Install your app
  2. Ensure PCON (Parental Controls) is OFF
  3. Go to any of the following and focus on your channel: Home tab > On Now row, Live tab > Your app row, Channel Guide, Home tab > Recently Watched, Manage Channels

Expected results

  • Channel live preview of channel content plays in the top right corner, rather than a static image

Test steps

  1. Go to the Channel Guide using any of the methods listed below (some devices have other methods as well):
    • Hover over any live program > click the three lines menu button > select Channel Guide
    • Go to the options row in Live Tab
    • Go to Home Tab > On Now row > first item on the left
    • Go to Live tab > Guide & Your Recents > first item on the left
  2. Click any of the channel items from the list

Expected results

If using native Fire TV player:

  • Content start playing in the native player without crashes

If using your own player: Content start playing in your app player without entering your app's UI

Parental controls

PCON (Parental Controls) PIN prompt appears when clicking on Live channel

Test steps

  1. Make sure PCON is enabled: settings > preferences > parental controls. Turn ON the parental controls

Expected results

If using native Fire TV player:

  • A PCON PIN prompt appears inside the native player

If using your own player:

  • A PCON PIN prompt appears when clicking on Live channel in On Now row, Live tab, search, and Channel Guide (does not depend on your content rating)

Live preview does not start when PCON is on

Test steps

  1. Make sure PCON is enabled: settings > preferences > parental controls. Turn ON parental controls
  2. Focus on channel tile in the following places:
    • Go to Home tab > On Now row
    • Go to Home tab > Recently Watched row
    • Go to Live tab > Recent Channels row
    • Go to Live tab > your app’s row
    • Go to Live tab > Genre row (Breaking News/Live Sports)

Expected results

  • Live preview does not start when PCON is ON in any of the above locations

Metadata

Verify metadata, mini preview, and progress bar on On Now row

Test steps

  1. Go to Home tab > On Now row
  2. Focus on any tile
  3. Compare with expected results

Expected results

The mini details are shown in the top left corner of the screen with the following metadata:

  • Program name
  • Start and end time
  • Content rating (if available)
  • Closed captions (if available)
  • Video quality (if available)
  • Up Next
  • Short description
  • Progress bar on the channel tiles are based on program timings

If mini preview is available

  • Mini preview (video) is displayed in the top right corner of the page, if given by provider

If Mini preview is not available

  • If mini video is not given by provider, static Program/Channel image is displayed in the top right corner of the page with the provider logo
  • Progress bar on the channel tiles is displayed based on the program timings

Verify program metadata, mini preview and progress bar in Channel Guide

Test steps

  1. Go to Channel Guide > any provider section > Focus on any program (currently airing or future)
  2. Compare with expected results

Expected results

  1. Progress for current program will be displayed
  2. The mini details are shown in the top left corner of the screen with the following metadata:
    • Program name
    • Start and end time
    • Content rating (if available)
    • Closed captions (if available)
    • Video quality (if available)
    • Up Next
    • Airing name & description

If mini preview is available

  • Mini preview (video) is displayed in the top right corner of the page, if given by provider

If Mini preview is not available

  • Static Program/Channel image is displayed in the top right corner of the page with the provider logo

Verify the mini details for future airing program from the Channel Guide

Test steps

  1. Go to the Channel Guide > any provider section > Select a program airing in the future

Expected results

  • Program name
  • Start and end time
  • Content rating (if available)
  • Closed captions (if available)
  • Video quality (if available)
  • Up Next
  • Short description

Last updated: Apr 12, 2022