Test video injection

Inject video files to test video-based scenarios with App Automate capability.

App Automate’s video injection feature lets you upload video files to BrowserStack devices to test video-based features. Video injection simulates the camera video function and uses the uploaded video as an input to mimic the camera video function.

Supported OS versions

BrowserStack supports video injection in the following OS versions:

Upload video

Upload your desired video to BrowserStack using the following cURL command.

curl -u "YOUR_USERNAME:YOUR_ACCESS_KEY" \
    -X POST "https://api-cloud.browserstack.com/app-automate/upload-media" \
    -F "file=@/path/to/media/file/<your_video>.mp4" \
    -F "custom_id=SampleMedia"

Here is a sample response that includes the media ID to be set in the videoUrl used later in the test script.

{"media_url":"media://02b3466cd0b5b4825d925eb1c69f7d901890b136","custom_id":"SampleMedia","shareable_id”:”<username>/SampleMedia"}

Enable video injection

To use this feature in your Appium session, set the enableCameraVideoInjection capability at the start of your test session.

enableCameraVideoInjection: true

DesiredCapabilities capabilities = new DesiredCapabilities();
HashMap<String, Object> browserstackOptions = new HashMap<String, Object>();
browserstackOptions.put("cameraVideoInjection", "true");
browserstackOptions.put("videoUrl", "media://575927ad18ae787c065e680dc3ee864725cd809e");
capabilities.setCapability("bstack:options", browserstackOptions);

var capabilities = {
	'bstack:options' : { 
			"cameraVideoInjection" : "true"
			"videoUrl" : "media://575927ad18ae787c065e680dc3ee864725cd809e"
		}
}

desired_cap = {
	'bstack:options' : {
		"cameraVideoInjection" : "true",
		"videoUrl" : "media://575927ad18ae787c065e680dc3ee864725cd809e",
	},
}

capabilities = {
	'bstack:options' => {
		"cameraVideoInjection" => "true",
		"videoUrl" => "media://575927ad18ae787c065e680dc3ee864725cd809e",
	},
}

Dictionary<string, object> browserstackOptions = new Dictionary<string, object>();
browserstackOptions.Add("cameraVideoInjection", "true");
browserstackOptions.Add("videoUrl", "media://575927ad18ae787c065e680dc3ee864725cd809e");
capabilities.AddAdditionalOption("bstack:options", browserstackOptions);

DesiredCapabilities desiredCapabilities = new DesiredCapabilities();
desiredCapabilities.setCapability("browserstack.cameraVideoInjection","true");
desiredCapabilities.setCapability("browserstack.videoUrl", "media://575927ad18ae787c065e680dc3ee864725cd809e");

var capabilities = {
	"browserstack.cameraVideoInjection" : "true"
	"browserstack.videoUrl" : "media://575927ad18ae787c065e680dc3ee864725cd809e"
}

desired_cap = {
	"browserstack.cameraVideoInjection" = "true",
	"browserstack.videoUrl" : "media://575927ad18ae787c065e680dc3ee864725cd809e",
}

caps = Selenium::WebDriver::Remote::Capabilities.new
caps["browserstack.cameraVideoInjection"] = "true"
caps["browserstack.videoUrl"] = "media://575927ad18ae787c065e680dc3ee864725cd809e"

ChromeOptions capability = new ChromeOptions();
capability.AddAdditionalCapability("browserstack.cameraVideoInjection", "true");
capability.AddAdditionalCapability("browserstack.videoUrl", "media://575927ad18ae787c065e680dc3ee864725cd809e");

Inject the uploaded video

Inject the uploaded video using BrowserStack’s custom executor with the action cameraVideoInjection as shown in the following code snippets. Ensure the video is injected before the camera is triggered in the app as the camera only captures the last injected video.

JavascriptExecutor jse = (JavascriptExecutor)driver;
jse.executeScript("browserstack_executor: {\"action\":\"cameraVideoInjection\", \"arguments\": {\"videoUrl\" : \"media://<id>\"}}")

await driver.execute("browserstack_executor: {\"action\":\"cameraVideoInjection\", \"arguments\": {
  \"videoUrl\" : \"media://<id>\"
}}”)

driver.execute_script("browserstack_executor: {\"action\":\"cameraVideoInjection\", \"arguments\": {
    \"videoUrl\" : \"media://<id>\"
}}”)

@driver.execute_script("browserstack_executor: {\"action\":\"cameraVideoInjection\", \"arguments\": {
    \"videoUrl\" : \"media://<id>\"
}}”)

((IJavaScriptExecutor)driver).ExecuteScript("browserstack_executor: {\"action\":\"cameraVideoInjection\", \"arguments\": { \"videoUrl\" : \"media://<id>\"}}");

Trigger camera in the app & take a video

Add the logic to click the camera button in the mobile app after the logic to inject the uploaded video is added in the script. The video captured from the camera is the last injected video.