# Copyright 2013 The Chromium Authors. All rights reserved. # Use of this source code is governed by a BSD-style license that can be # found in the LICENSE file. import logging import os import tempfile import time from pylib import cmd_helper from pylib import device_signal from pylib.device import device_errors # TODO(jbudorick) Remove once telemetry gets switched over. import pylib.android_commands import pylib.device.device_utils class VideoRecorder(object): """Records a screen capture video from an Android Device (KitKat or newer). Args: device: DeviceUtils instance. host_file: Path to the video file to store on the host. megabits_per_second: Video bitrate in megabits per second. Allowed range from 0.1 to 100 mbps. size: Video frame size tuple (width, height) or None to use the device default. rotate: If True, the video will be rotated 90 degrees. """ def __init__(self, device, megabits_per_second=4, size=None, rotate=False): # TODO(jbudorick) Remove once telemetry gets switched over. if isinstance(device, pylib.android_commands.AndroidCommands): device = pylib.device.device_utils.DeviceUtils(device) self._device = device self._device_file = ( '%s/screen-recording.mp4' % device.GetExternalStoragePath()) self._recorder = None self._recorder_stdout = None self._is_started = False self._args = ['adb'] if str(self._device): self._args += ['-s', str(self._device)] self._args += ['shell', 'screenrecord', '--verbose'] self._args += ['--bit-rate', str(megabits_per_second * 1000 * 1000)] if size: self._args += ['--size', '%dx%d' % size] if rotate: self._args += ['--rotate'] self._args += [self._device_file] def Start(self): """Start recording video.""" self._recorder_stdout = tempfile.mkstemp()[1] self._recorder = cmd_helper.Popen( self._args, stdout=open(self._recorder_stdout, 'w')) if not self._device.GetPids('screenrecord'): raise RuntimeError('Recording failed. Is your device running Android ' 'KitKat or later?') def IsStarted(self): if not self._is_started: for line in open(self._recorder_stdout): self._is_started = line.startswith('Content area is ') if self._is_started: break return self._is_started def Stop(self): """Stop recording video.""" os.remove(self._recorder_stdout) self._is_started = False if not self._recorder: return if not self._device.KillAll('screenrecord', signum=device_signal.SIGINT, quiet=True): logging.warning('Nothing to kill: screenrecord was not running') self._recorder.wait() def Pull(self, host_file=None): """Pull resulting video file from the device. Args: host_file: Path to the video file to store on the host. Returns: Output video file name on the host. """ # TODO(jbudorick): Merge filename generation with the logic for doing so in # DeviceUtils. host_file_name = ( host_file or 'screen-recording-%s.mp4' % time.strftime('%Y%m%dT%H%M%S', time.localtime())) host_file_name = os.path.abspath(host_file_name) self._device.PullFile(self._device_file, host_file_name) self._device.RunShellCommand('rm -f "%s"' % self._device_file) return host_file_name