CaptureBegan and CaptureEnded from CaptureService not firing

[N00bIs0ffline (KhelyataMan)]

You can write your topic however you want, but you need to answer these questions:

1. What do you want to achieve?

I want my CaptureBegan and CaptureEnded from CaptureService to fire.

2. What is the issue? Include screenshots / videos if possible!

It did not fire

3. What solutions have you tried so far? I tried looking into the documentation and it did not help, I did not found any post talking about these 2 features.

After that, you should include more details if you have any. Try to make your topic as descriptive as possible, so that it’s easier for people to help you!

local cooldown = 3

local equiping = false

local tool = script.Parent
local camera = game.Workspace.CurrentCamera
local capserv = game:GetService("CaptureService")
local uis = game:GetService("UserInputService")

local StarterGui = game:GetService("StarterGui")
local player = game.Players.LocalPlayer

capserv.CaptureBegan:Connect(function()
	print("OK IM CHANGINGGGG 🐺🐺") -- didnt print
	game.Lighting.GlobalShadows = false
	game.Lighting.Brightness = 1000000
end)

capserv.CaptureEnded:Connect(function()
	print("ok im back to normal 🐺-▶👨") -- this also did not print
	game.Lighting.GlobalShadows = true
	game.Lighting.Brightness = 0
end)

local function OnCaptureReady(contentid)
	script.Parent.Handle.Screen.SurfaceGui.ImageLabel.Image = contentid
	camera.CameraType = Enum.CameraType.Custom
end

tool.Equipped:Connect(function()
	equiping = true
	while equiping do
			capserv:CaptureScreenshot()
		task.wait(cooldown)
	end
end)


tool.Unequipped:Connect(function()
	equiping = false
end)

I have a feeling its because i misunderstood how it suppose to work?

[Spooce]

I ran into this issue as well. According to a staff post, these events unfortunately only fire for user-initiated captures.

@merlin_codes

@StitchedDev

It seems like CaptureBegan and CaptureEnded aren’t fired when we use :CaptureScreenshot(). Is this intentional or will it be resolved in the future? Are there any workarounds?

This is intentional. CaptureBegan and CaptureEnded are for user-initiated captures. CaptureScreenshot is for developers to initiate screenshots in the experience, so developers would be in control of when the capture being taken. You can pass an onCaptureReady callback into the method to determine when the capture has ended.

You can use the callback to signal the end, but you’ll have to configure the scene before capturing.

[N00bIs0ffline (KhelyataMan)]

Do you have any work around? Especially for the Begin function?

[Spooce]

I would just enable your lighting effects right before :CaptureScreenshot(), then disable them in the callback. That seems to be the implied flow with the current API.

[MRX_perte (Programmer)]

The reason your CaptureBegan and CaptureEnded events arent firing is because those signals are only meant for user-initiated captures (like when a player presses a system screenshot keybind). When you use :CaptureScreenshot() in code, the developer is in full control of the timing… so Roblox dosent fire those events. Thats why your prints never showed.

CaptureService | Documentation - Roblox Creator Hub

---

1. Configure your scene right before calling CaptureScreenshot()
2. Use the onCaptureReady callback to know when the capture has completed and then restore your settings

That means youll need to treat your own function call as the “CaptureBegan” and the callback as your “CaptureEnded”

CaptureService | Documentation - Roblox Creator Hub

---

local cooldown = 3
local equipping = false

local tool = script.Parent
local capserv = game:GetService("CaptureService")
local camera = workspace.CurrentCamera

-- custom functions to mimic Begin/End
local function onCaptureBegan()
	print("Custom CaptureBegan")
	-- apply lighting or any other effects here
	game.Lighting.GlobalShadows = false
	game.Lighting.Brightness = 1000000
end

local function onCaptureEnded(contentId)
	print("Custom CaptureEnded")
	-- restore lighting after capture
	game.Lighting.GlobalShadows = true
	game.Lighting.Brightness = 0

	tool.Handle.Screen.SurfaceGui.ImageLabel.Image = contentId

	-- reset camera if needed
	camera.CameraType = Enum.CameraType.Custom
end

tool.Equipped:Connect(function()
	equipping = true
	while equipping do
		onCaptureBegan() -- trigger effects before capture
		capserv:CaptureScreenshot(onCaptureEnded) -- pass callback
		task.wait(cooldown)
	end
end)

tool.Unequipped:Connect(function()
	equipping = false
end)

CaptureService | Documentation - Roblox Creator Hub

So the “workaround” is just to manage those states manually. That way you still get the same behavior, even though the built-in events dont apply to developer-initiated screenshots.

I hope this helps anyhow!!!