framework_gem 0.1.0

data/lib/User_Lib/screen/roku/roku_home.rb

@@ -0,0 +1,346 @@
+require './lib/screen/roku/roku_screen'
+# DO NOT ADD DSL REQUIRES HERE. Load them in methods that need them. Otherwise syntax completion is slow.
+
+# Defines Roku-specific methods on the Main Menu screen
+
+class RokuHome < RokuScreen
+
+  # Public: Navigates to Home from the Main Menu screen.
+  #
+  # Returns nothing.
+  def navigate_from_main_menu
+    dut.roi.text.exit_app_text.press_key_until_displayed?(key="page_up", :presses => 3, :message => "Press page up till Main Menu displayed")
+    dut.press_key.ARROW_LEFT(:sleep_time => 2.sec) if dut.roi.text.exit_app_text.displayed?
+    dut.press_key('select', :sleep_time => 2.sec) if dut.roi.text.exit_app_text.displayed?
+  end
+
+  # Public: Use to navigate to and launch the Spectrum App. This method will login to a test
+  #         account when launching the app if it is not already logged in.
+  #
+  # environment  - gets the value of environment under test
+  # username     - to enter Login name in username filed.
+  # password     - to enter password in password field
+  #
+  # Examples
+  #
+  #   dut.screens.home.navigate_to_roku_app?(true, '4.0')
+  #   # => true
+  #
+  # Returns a Boolean true if successfully able to launch the TWC App and navigate to
+  # live tv. Else, a Boolean false is returned.
+  def navigate_to_roku_app?(environment, username, password)
+    environment = 'default' if environment.nil?
+    version = dut.software_version
+    2.times{dut.press_key('menu', :sleep_time => 2.sec)}
+    dut.roi.text.home_loaded.wait_until_displayed?(10000)
+    dut.press_key('right_arrow', :sleep_time => 2.sec)
+    return false unless dut.roi.text.home_loaded.wait_until_displayed?(10000)
+    app_slot_roi = test_data.fetch(:roku_app_image_rois, {}).fetch(environment, 'spectrum_app_slot')
+
+    #app_slot_roi = "dev_app_slot" if environment == 'dev'
+    for i in 1..50 do
+      if dut.roi.image.send("#{app_slot_roi}_1").displayed?
+        logger.info("In 1 Row")
+        logger.info("#{app_slot_roi}_1")
+        #if dut.roi.image.dev_app_slot_1.displayed?
+        dut.press_key('select', :sleep_time => 2.sec)
+        break
+      elsif dut.roi.image.send("#{app_slot_roi}_2").displayed?
+        logger.info("In 2 Row")
+        logger.info("#{app_slot_roi}_2")
+        #elsif dut.roi.image.dev_app_slot_2.displayed?
+        dut.press_key('right_arrow', :sleep_time => 2.sec)
+        dut.press_key('select', :sleep_time => 2.sec)
+        break
+      elsif dut.roi.image.send("#{app_slot_roi}_3").displayed?
+        #elsif dut.roi.image.dev_app_slot_3.displayed?
+        2.times{dut.press_key('right_arrow', :sleep_time => 2.sec)}
+        dut.press_key('select', :sleep_time => 2.sec)
+        break
+      end
+      return false if i==20
+      dut.screens.home.wait_till_loading_screen_not_displayed?(8000) if dut.screens.home.is_spectrum_loading_screen_displayed?
+      dut.screens.home.wait_till_launch_screen_not_displayed?(8000) if dut.screens.home.is_spectrum_launch_screen_displayed?
+      if dut.roi.text.welcome_screen_text.wait_until_displayed?(timeout=10000)
+        dut.press_key('select', :sleep_time=>3.sec)
+
+      end
+      if dut.screens.login.is_username_page_displayed?
+        ######## temporary Purpose
+        username_1 = dut.roi.text.user_empty.retrieve
+        loginfo "#{username_1}"
+        if username_1 !=nil?
+          3.times{dut.press_key('down_arrow', :sleep_time => 3.sec)}
+          2.times{dut.press_key('left_arrow', :sleep_time => 3.sec)}
+          21.times{dut.press_key('select', :sleep_time => 3.sec)}
+          2.times{dut.press_key('right_arrow', :sleep_time => 3.sec)}
+          3.times{dut.press_key('up_arrow', :sleep_time => 3.sec)}
+          sleep(delay=6.sec)
+        end
+        ######## temporary Purpose
+        #logger.info(username)
+        dut.screens.login.enter_username_and_ok?(username)
+        dut.screens.login.enter_password_and_ok?(password)
+        return dut.screens.login.nav_to_live_after_app_launch?
+      end
+      sleep(5.sec)
+      return dut.screens.login.nav_to_live_after_app_launch?
+      sleep(5.sec)
+
+      # else
+      #loginfo "Login Page is not displayed"
+      #return false
+    end
+    return dut.screens.login.nav_to_live_after_app_launch?
+
+
+  end
+
+  # Public: Use to navigate to the TWC/Spectrum App but NOT launch the App.
+  #         
+  #
+  # use_sitb     - A Boolean flag to indicate if the sitb App is used (default: false).
+  #
+  # Examples
+  #
+  #   dut.screens.home.navigate_to_twc_app_icon?(true)
+  #   # => true
+  #
+  # Returns a Boolean true if successfully able to navigate to the TWC App.
+  # Else, a Boolean false is returned.
+  #
+  def navigate_to_roku_app_icon?(use_sitb=false)
+  	2.times{dut.press_key('menu', :sleep_time => 2.sec)}
+  	dut.roi.text.home_loaded.wait_until_displayed?(10000)
+  	dut.press_key('right_arrow', :sleep_time => 2.sec)
+  	return false unless dut.roi.text.home_loaded.wait_until_displayed?(10000)
+  	app_slot_roi = "spectrum_app_slot"
+  	app_slot_roi = "twc_sitb_app_slot" if use_sitb
+  	for i in 1..20 do
+  		return true if dut.roi.image.send("#{app_slot_roi}_1").displayed?
+  		if dut.roi.image.send("#{app_slot_roi}_2").displayed?
+  			dut.press_key('right_arrow', :sleep_time => 2.sec)
+  			return true
+  		elsif dut.roi.image.send("#{app_slot_roi}_3").displayed?
+  			2.times{dut.press_key('right_arrow', :sleep_time => 2.sec)}
+  			return true
+  		end
+  		dut.press_key('down_arrow', :sleep_time => 2.sec)
+  	end
+  	return false
+  end
+
+  # Public: Checks if the current screen is displayed.
+  #
+  # timeout - Integer total milliseconds to check before timing out (default: 0.sec).
+  #
+  # Returns a Boolean true if the screen is displayed, otherwise false.
+  def displayed?(args={})
+    timeout = args.fetch(:timeout, 10)
+    return dut.roi.text.home_loaded.displayed?(:timeout=>timeout)
+  end
+  
+  # Public: Use to navigate to and launch the TWC/Spectrum App. This method will login to a test 
+  #         account when launching the app.
+  #
+  # use_sitb     - A Boolean flag to indicate if the sitb App is used  .
+  # roku_version - A String indicating the version of the Roku App being tested against  .
+  #                .
+  #
+  # Examples
+  #
+  #   dut.screens.home.navigate_to_roku_app?(true, '3.1')
+  #   # => true
+  #
+  # Returns a Boolean true if successfully able to launch the TWC App and navigate to
+  # live tv. Else, a Boolean false is returned.
+  def verify_roku_app_welcomepage?(use_sitb, roku_version)
+      version = dut.software_version
+      2.times{dut.press_key('menu', :sleep_time => 2.sec)}
+      dut.roi.text.home_loaded.wait_until_displayed?(10000)
+      dut.press_key('right_arrow', :sleep_time => 2.sec)
+      return false unless dut.roi.text.home_loaded.wait_until_displayed?(10000)
+      app_slot_roi = "spectrum_app_slot"
+      app_slot_roi = "twc_sitb_app_slot" if use_sitb
+      for i in 1..20 do
+        if dut.roi.image.send("#{app_slot_roi}_1").displayed?
+          dut.press_key('select', :sleep_time => 2.sec) 
+          break
+        elsif dut.roi.image.send("#{app_slot_roi}_2").displayed?
+          dut.press_key('right_arrow', :sleep_time => 2.sec)
+          dut.press_key('select', :sleep_time => 2.sec)
+          break
+        elsif dut.roi.image.send("#{app_slot_roi}_3").displayed?
+          2.times{dut.press_key('right_arrow', :sleep_time => 2.sec)}
+          dut.press_key('select', :sleep_time => 2.sec)
+          break
+        end
+        dut.press_key('down_arrow', :sleep_time => 2.sec)
+      end
+      return false if i==20
+      dut.roi.text.app_loading_spectrum_text.wait_until_not_displayed?(timeout=8000) if dut.roi.text.app_loading_spectrum_text.displayed?
+      dut.press_key('page_up', :sleep_time => 2.sec)
+       dut.press_key('select', :sleep_time => 2.sec) if dut.roi.text.welcome_screen_text.displayed?
+      
+  end
+
+  # Public: Use to navigate to and launch the TWC/Spectrum App. This method will login to a test 
+  #         account when launching the app.
+  #
+  # username     - Value of the username              .
+  # password     - value of the password
+  # use_sitb     - A Boolean flag to indicate if the sitb App is used  .
+  # roku_version - A String indicating the version of the Roku App being tested against  .
+  #
+  # Examples
+  #
+  #   dut.screens.home.navigate_to_roku_app?(true, '3.1')
+  #   # => true
+  #
+  # Returns a Boolean true if successfully able to launch the TWC App and navigate to
+  # live tv. Else, a Boolean false is returned.
+  def navigate_to_roku_app_login?(username,password, use_sitb, roku_version)
+      version = dut.software_version
+      2.times{dut.press_key('menu', :sleep_time => 2.sec)}
+      dut.roi.text.home_loaded.wait_until_displayed?(10000)
+      dut.press_key('right_arrow', :sleep_time => 2.sec)
+      return false unless dut.roi.text.home_loaded.wait_until_displayed?(10000)
+      app_slot_roi = "spectrum_app_slot"
+      app_slot_roi = "twc_sitb_app_slot" if use_sitb 
+      for i in 1..20 do
+      if dut.roi.image.send("#{app_slot_roi}_1").displayed?
+           #dut.press_key.SELECT
+           break
+        elsif dut.roi.image.send("#{app_slot_roi}_2").displayed?
+          dut.press_key('right_arrow', :sleep_time => 2.sec)
+          #dut.press_key.SELECT
+          break
+        elsif dut.roi.image.send("#{app_slot_roi}_3").displayed?
+          2.times{dut.press_key('right_arrow', :sleep_time => 2.sec)}
+          #dut.press_key.SELECT
+           break
+        end
+        dut.press_key('down_arrow', :sleep_time => 2.sec)
+     end
+      return false if i==20   
+  return true
+  end
+
+  # Public: Navigates to Home from the Main Menu screen.
+  #
+  # username - recieve values at runtime
+  # password - recieve values at runtime
+  #
+  # Returns nothing.
+  def perform_login_fedid?(username, password)
+     #username='altoona_gold@charter.net'
+     #password='Ctva1000'
+   	 val= dut.roi.text.username_field.retrieve
+       if val!=''
+        4.times{dut.press_key('up_arrow', :sleep_time=>3.sec)}
+        2.times{dut.press_key('left_arrow', :sleep_time=>3.sec)}
+        25.times{dut.press_key('select', :sleep_time=>3.sec)}
+       end
+     
+       4.times{dut.press_key('down_arrow', :sleep_time=>3.sec)}
+       3.times{dut.press_key('right_arrow', :sleep_time=>3.sec)}
+   
+       dut.screens.login.enter_username_and_ok?(username)
+  	 dut.screens.login.enter_password_and_ok?(password)
+  end
+
+  # Public: Checks if the Spectrum launching/loading screen is displayed.
+  #
+  # Returns a Boolean true if the screen is displayed, otherwise false.
+  def is_spectrum_launch_screen_displayed?
+    return dut.roi.text.app_loading_spectrum_text.displayed?
+  end
+
+  # Public: Wait until the Spectrum Launching screen disappears.
+  #
+  # timeout - Integer total milliseconds to check before timing out (default: 10000).
+  #
+  # Returns a Boolean true if the screen disappears, otherwise false.
+  def wait_till_launch_screen_not_displayed?(timeout=10000)
+    return dut.roi.text.app_loading_spectrum_text.wait_until_not_displayed?(timeout)
+  end
+
+  # Public: Checks if the Spectrum loading screen is displayed when the app first launches.
+  #
+  # Returns a Boolean true if the screen is displayed, otherwise false.
+  def is_spectrum_loading_screen_displayed?
+    return dut.roi.text.app_launch_loading_text.displayed?
+  end
+
+  # Public: Wait until the Spectrum Loading screen is not displayed.
+  #
+  # timeout - Integer total milliseconds to check before timing out (default: 10000).
+  #
+  # Returns a Boolean true if the screen disappears, otherwise false.
+  def wait_till_loading_screen_not_displayed?(timeout=10000)
+    return dut.roi.text.app_launch_loading_text.wait_until_not_displayed?(timeout)
+  end
+
+  # Public: Login into an application
+  #
+  # use_sitb     - Selecting STB.
+  # roku_version - Roku version.
+  # username     - Username.
+  # password     - Password.
+  #
+  # Returns Login into STB.
+  def navigate_to_roku_app_sitb_login?(use_sitb,roku_version,username,password)
+      version = dut.software_version
+      2.times{dut.press_key('menu', :sleep_time => 2.sec)}
+      dut.roi.text.home_loaded.wait_until_displayed?(10000)
+      dut.press_key('right_arrow', :sleep_time => 2.sec)
+      return false unless dut.roi.text.home_loaded.wait_until_displayed?(10000)
+      app_slot_roi = "spectrum_app_slot"
+      app_slot_roi = "twc_sitb_app_slot" if use_sitb
+      for i in 1..20 do
+        #if dut.roi.image.send("#{app_slot_roi}_1").displayed?
+  	 if dut.roi.image.twc_app_slot_1.displayed?
+           dut.press_key('select', :sleep_time => 2.sec) 
+          break
+        #elsif dut.roi.image.send("#{app_slot_roi}_2").displayed?
+  	 elsif dut.roi.image.spectrum_app_slot_2.displayed?
+          dut.press_key('right_arrow', :sleep_time => 2.sec)
+          dut.press_key('select', :sleep_time => 2.sec)
+          break
+        #elsif dut.roi.image.send("#{app_slot_roi}_3").displayed?
+  	elsif dut.roi.image.spectrum_app_slot_3.displayed?
+          2.times{dut.press_key('right_arrow', :sleep_time => 2.sec)}
+          dut.press_key('select', :sleep_time => 2.sec)
+          break
+        end
+        dut.press_key('down_arrow', :sleep_time => 2.sec)
+      end
+      return false if i==20
+      dut.screens.home.wait_till_loading_screen_not_displayed?(8000) if dut.screens.home.is_spectrum_loading_screen_displayed?
+      dut.screens.home.wait_till_launch_screen_not_displayed?(8000) if dut.screens.home.is_spectrum_launch_screen_displayed?
+      if dut.roi.text.welcome_screen_text.displayed?
+  	dut.press_key('select', :sleep_time=>3.sec)
+   end
+      if dut.screens.login.is_username_page_displayed?
+        ######## temporary Purpose
+  	 username_1 = dut.roi.text.user_empty.retrieve
+        loginfo "#{username_1}"
+  	if username_1 !=nil?
+  	3.times{dut.press_key('down_arrow', :sleep_time => 3.sec)}
+  	2.times{dut.press_key('left_arrow', :sleep_time => 3.sec)}
+  	21.times{dut.press_key('select', :sleep_time => 3.sec)}
+  	2.times{dut.press_key('right_arrow', :sleep_time => 3.sec)}
+  	3.times{dut.press_key('up_arrow', :sleep_time => 3.sec)}
+  	sleep(delay=5.sec) 
+  end
+  ######## temporary Purpose
+  #logger.info(username)
+  dut.screens.login.enter_username_and_ok?(username)
+  dut.screens.login.enter_password_and_ok?(password) 
+  return dut.screens.login.nav_to_live_after_app_launch?
+       end
+       sleep(10.sec)
+      return dut.screens.login.nav_to_live_after_app_launch?
+   end
+
+end

data/lib/User_Lib/screen/roku/roku_library.rb

@@ -0,0 +1,26 @@
+require './lib/screen/roku/roku_screen'
+
+# Defines Roku-specific methods for the Library screen
+
+class RokuLibrary < RokuScreen
+
+  # Public: Navigates to Library from Main Menu.
+  #
+  # Returns nothing.
+  def navigate_from_main_menu
+    #TODO: make this work!
+    dut.press_key('select', :sleep_time => 2.sec) if dut.roi.color.on_demand_menu_item_highlighted.press_key_until_displayed?(key="down_arrow", :presses => 7, :message => "Press down till On Demand Menu Item highlighted")
+  end
+
+  # Public: Checks if the current screen is displayed.
+  #
+  # timeout - Integer total milliseconds to check before timing out (default: 0.sec).
+  #
+  # Returns a Boolean true if the screen is displayed, otherwise false.
+  def displayed?(args={})
+    #TODO: make this work!
+    timeout = args.fetch(:timeout, 10)
+    dut.roi.text.on_demand_page_title.displayed?(:timeout=>timeout)
+  end
+
+end

data/lib/User_Lib/screen/roku/roku_live_tv.rb

@@ -0,0 +1,210 @@
+require './lib/screen/roku/roku_screen'
+# DO NOT ADD DSL REQUIRES HERE. Load them in methods that need them. Otherwise syntax completion is slow.
+
+# Defines Roku-specific methods on the Live TV screen
+
+class RokuLiveTv < RokuScreen
+
+  # Public: Navigates to Live TV from Main Menu.
+  #
+  # Returns nothing.
+  def navigate_from_main_menu
+    dut.press_key('select', :sleep_time => 2.sec) if dut.roi.color.live_tv_menu_item_highlighted.press_key_until_displayed?(key="down_arrow", :presses => 7, :message => "Press down till Live TV Menu Item highlighted")
+  end
+
+  # Public: Use to check if the filter informational popup dialog is displayed.
+  #
+  # Examples
+  #
+  # 	dut.screens.live_tv.is_filter_popup_displayed?
+  # 	# => true
+  #
+  # Returns a Boolean true if the filter poup is displayed. Else, a Boolean value
+  # of false is returned.
+  # 
+  def is_filter_popup_displayed?
+    #return api_is_text_displayed?(:roku_filter_info_popup, text=nil, similarity=0.7, 
+    #                              log_text="Is text is displayed", verifies=1, 
+    #                              between_verifies_ms=1000, roi_type="OCRROI:default")
+    return dut.roi.text.filter_info_popup.displayed?
+  end
+
+  # Public: Use to wait untill live TV begins playing.
+  #
+  # Examples
+  #
+  #   dut.screens.live_tv.wait_till_live_tv_playing?
+  #   # => true
+  #
+  # Returns a Boolean true if live TV is playing. Else, a Boolean false
+  # is returned.
+  def wait_till_live_tv_playing?
+    return dut.roi.video.live_tv_live_playback.wait_until_displayed?(45000)
+  end
+
+  # Public: Use to check if video is buffering from a channel change or loading a new asset.
+  #
+  # Examples
+  #
+  # 	dut.screens.live_tv.is_buffering?
+  # 	# => true
+  #
+  # Returns a Boolean true if either buffering text or buffering loading bar is 
+  # displayed. Else, a Boolean false is returned.
+  # 
+  def is_buffering?
+    #return true if api_is_text_displayed?(:roku_available_on_demand, text=nil, similarity=0.7, 
+    #                                      log_text="Is text is displayed", verifies=1, 
+    #                                      between_verifies_ms=1000, roi_type="OCRROI:default")
+    return true if dut.roi.text.available_on_demand_buffer_text.displayed?
+    #return true if api_is_color_displayed?(:roku_od_asset_playback_loading_bar_blue, 
+    #                                       log_text="Is buffering bar displayed?", verifies=1, 
+    #                                       between_verifies_ms=1000, roi_type="COLORROI:default")
+    return true if dut.roi.color.od_asset_playback_loading_bar.displayed?
+    #return true if api_is_color_displayed?(:channel_change_buffering, 
+    #                                       log_text="Is buffering bar displayed?", verifies=1, 
+    #                                       between_verifies_ms=1000, roi_type="COLORROI:default")
+    return dut.roi.color.channel_change_buffering.displayed?
+  end
+
+  # Public: Use to wait untill video finishes buffering.
+  #
+  # Examples
+  #
+  # 	dut.screens.live_tv.wait_for_buffering
+  # 	# => true
+  #
+  # Returns a Boolean true if the buffering bar fades. Else, a Boolean
+  # true is returned. 
+  # 
+  def wait_for_buffering
+    #return api_wait_till_color_not_displayed?(:channel_buffering, timeout_ms=15000, 
+    #                                          log_text="Wait until buffering bar blue color disappears", 
+    #                                          verifies=1, between_verifies_ms=1000, 
+    #                                          screen_capture_every_ms=1000, sleep_between_samples=1.sec, 
+    #                                          roi_type="COLORROI:default")
+    return dut.roi.color.channel_buffering.wait_until_not_displayed?(15000)
+  end
+
+  # Public: Use to check if a "Channel Unavailable" alert message is displayed.
+  #
+  # Examples
+  #
+  # 	dut.screens.live_tv.is_channel_unavailable_displayed?
+  # 	# => true
+  #
+  # Returns a Boolean true if a "Channel Unavailable" alert message is displayed.
+  # Else, a Boolean false is returned.
+  #  
+  def is_channel_unavailable_displayed?
+    #return api_is_text_displayed?(:roku_channel_unavailable_ok_button, text=nil, 
+    #                              similarity=0.7, log_text="Is text is displayed", 
+    #                              verifies=1, between_verifies_ms=1000, 
+    #                              roi_type="OCRROI:default")
+    return dut.roi.text.channel_unavailable_ok_button.displayed?
+  end
+
+  # Public: Use to force the full screen overlay with channel info to fade.
+  #
+  # Examples
+  #
+  # 	dut.screens.live_tv.force_overlay_to_fade
+  # 
+  def force_overlay_to_fade
+    dut.press_key('up_arrow', :sleep_time => 2.sec)
+  end
+
+  # Public: Use to check if a "Inactivity" alert message is displayed.
+  #
+  # Examples
+  #
+  # dut.screens.live_tv.is_inactivity_notice_displayed?
+  # # => true
+  #
+  # Returns a Boolean true if a "Inactivity" alert message is displayed.
+  # Else, a Boolean false is returned.
+  #  
+  def is_inactivity_notice_displayed?
+    return (dut.roi.text.inactivity_notice_button.displayed? or dut.roi.text.inactivity_notice_text.displayed?)
+  end
+
+  # Public: Use to check if the "Live TV" text is displayed in the full screen overlay.
+  #
+  # Examples
+  #
+  # 	dut.screens.live_tv.is_live_tv_text_displayed?
+  # 	# => true
+  #
+  # Returns a Boolean true if the "Live TV" text is displayed.
+  # Else, a Boolean false is returned.
+  #  
+  def is_live_tv_text_displayed?
+    return dut.roi.text.full_screen_overlay_live_tv_text.displayed?
+  end
+
+  # Public: Use to check if the "Ch" text is displayed in the full screen overlay.
+  #
+  # Examples
+  #
+  # 	dut.screens.live_tv.is_ch_overlay_displayed?
+  # 	# => true
+  #
+  # Returns a Boolean true if the "Ch" text is displayed.
+  # Else, a Boolean false is returned.
+  #  
+  def is_ch_overlay_displayed?
+    return dut.roi.text.full_screen_overlay_ch_text.retrieve.to_s.include?('Ch')
+  end
+
+  # Public: Use to check if the time is displayed in the full screen overlay.
+  #
+  # Examples
+  #
+  # 	dut.screens.live_tv.is_time_displayed?
+  # 	# => true
+  #
+  # Returns a Boolean true if the time is displayed.
+  # Else, a Boolean false is returned.
+  #  
+  def is_time_displayed?
+    time = dut.roi.text.current_time_header_text.retrieve.to_s
+    return (time.include?("AM") or time.include?("PM"))
+  end
+
+  # Public: Use to check if the "VIEW DETAILS" text is displayed in the full screen overlay.
+  #
+  # Examples
+  #
+  #   dut.screens.live_tv.is_ch_overlay_view_details_displayed?
+  #   # => true
+  #
+  # Returns a Boolean true if the "VIEW DETAILS" text is displayed.
+  # Else, a Boolean false is returned.
+  def is_ch_overlay_view_details_displayed?
+    return dut.roi.text.info_overlay_view_details_text.displayed?
+  end
+
+  # Public: Use to check if live TV is playing.
+  #
+  # Examples
+  #
+  #   dut.screens.live_tv.is_live_tv_playing?
+  #   # => true
+  #
+  # Returns a Boolean true if live TV is playing. Else, a Boolean false
+  # is returned.
+  def is_live_tv_playing?
+    return dut.roi.video.live_tv_live_playback.displayed?
+  end
+
+  # Public: Checks if the current screen is displayed.
+  #
+  # timeout - Integer total milliseconds to check before timing out (default: 0.sec).
+  #
+  # Returns a Boolean true if the screen is displayed, otherwise false.
+  def displayed?(args={})
+    timeout = args.fetch(:timeout, 10)
+    return dut.roi.video.live_tv_live_playback.displayed?(:timeout=>timeout)
+  end
+
+end