Allow HTML5 video autoplay inside AgentWeb (closes #339)

[jim-daf]

Let HTML5 video autoplay inside AgentWeb

Closes #339

What changed

agentweb-core/src/main/java/com/just/agentweb/AbsAgentWebSettings.java

Call WebSettings.setMediaPlaybackRequiresUserGesture(false) from the default settings pipeline. Without this, every video.play() triggered by JavaScript on the loaded page was rejected by Chromium with the well-known message "play() can only be initiated by a user gesture", which is exactly what the reporter saw on the douyin reflow page.

The existing call to setMixedContentMode(MIXED_CONTENT_ALWAYS_ALLOW) already handles the "Mixed Content" half of the same trace. With both flags in place the same page now plays back normally.

Key snippet

mWebSettings.setJavaScriptCanOpenWindowsAutomatically(true);
mWebSettings.setMediaPlaybackRequiresUserGesture(false);

Notes

The flag is documented as having no effect for Web Audio in some Chromium versions. That is acceptable here because the issue is about HTML5 <video> playback. Apps that want to keep the Chromium default can override AgentWebSettingsImpl.toSetting and re-enable the gesture requirement.

[Copilot]

Pull request overview

Enables HTML5 video autoplay in AgentWeb by updating the default WebSettings configuration, addressing issue #339 where video.play() was blocked due to missing gesture exemptions.

Changes:

• Adds WebSettings.setMediaPlaybackRequiresUserGesture(false) to the default settings pipeline.
• Documents the motivation and context for the autoplay setting change inline.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

WebSettings#setMediaPlaybackRequiresUserGesture was added in API 17. Since this module’s minSdkVersion is 14, calling it unconditionally can crash on API 14–16 with NoSuchMethodError. Please guard this call with a Build.VERSION.SDK_INT >= Build.VERSION_CODES.JELLY_BEAN_MR1 check (or equivalent) so older devices skip it safely.

Suggested change

	mWebSettings.setMediaPlaybackRequiresUserGesture(false);
	if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.JELLY_BEAN_MR1) {
	mWebSettings.setMediaPlaybackRequiresUserGesture(false);
	}