Detect Software/Hardware Recording Api

Typedefs
typedef void(*	OnDetectSoftwareRecordingHandler) (SOFTWARE_RECORDING_NOTIFY_TYPE type, const char *softwares, void *data)
	for detect softward recording callback.
typedef void(*	OnDetectHardwareRecordingHandler) (DEVICE_CHANGED_TYPE type, const char *device, void *data)
	for detect device recording callback.

Functions
PLAYERSDK_API int PLAYERSDK_CALL	PLVSetPreventSoftwareRecording (void *window, bool enable)
	for prevent screen recording or screenshot.
PLAYERSDK_API int PLAYERSDK_CALL	PLVGetPreventSoftwareRecording (void *window, bool *enable)
	for prevent screen recording or screenshot.
PLAYERSDK_API int PLAYERSDK_CALL	PLVSetDetectSoftwareRecordingHandler (bool enable, OnDetectSoftwareRecordingHandler handler, void *data)
	for detect software recording your screen or window.
PLAYERSDK_API int PLAYERSDK_CALL	PLVSetDetectHardwareRecordingHandler (bool enable, OnDetectHardwareRecordingHandler handler, void *data)
	for detect device changed callback.

Detailed Description

Typedef Documentation

OnDetectHardwareRecordingHandler

typedef void(* OnDetectHardwareRecordingHandler) (DEVICE_CHANGED_TYPE type, const char *device, void *data)

for detect device recording callback.

Parameters

[out]	type	for device changed type.
[out]	device	for device info.
[out]	data	user context data.

Note

• type for DEVICE_CHANGED_NONE, device be null.

Definition at line 330 of file plv-player-core.h.

OnDetectSoftwareRecordingHandler

typedef void(* OnDetectSoftwareRecordingHandler) (SOFTWARE_RECORDING_NOTIFY_TYPE type, const char *softwares, void *data)

for detect softward recording callback.

Parameters

[out]	type	for software recording notify type.
[out]	software	for software names, eg: QQ,TeamViewer.
[out]	data	user context.

Definition at line 303 of file plv-player-core.h.

Function Documentation

PLVGetPreventSoftwareRecording()

PLAYERSDK_API int PLAYERSDK_CALL PLVGetPreventSoftwareRecording	(	void *	window,
		bool *	enable )

for prevent screen recording or screenshot.

Parameters

	window	window handle.
[out]	enable	to prevent or not.

Returns

• 0: Success.
• > 0: Failure.

Attention

in winOS,

• window must be top-level, eg: win WS_EX_APPWINDOW.

PLVSetDetectHardwareRecordingHandler()

PLAYERSDK_API int PLAYERSDK_CALL PLVSetDetectHardwareRecordingHandler	(	bool	enable,
		OnDetectHardwareRecordingHandler	handler,
		void *	data )

for detect device changed callback.

Parameters

enable	for check to callback or not.
handler	callback function.
data	user context data.

Returns

• 0: Success.
• > 0: Failure.

PLVSetDetectSoftwareRecordingHandler()

PLAYERSDK_API int PLAYERSDK_CALL PLVSetDetectSoftwareRecordingHandler	(	bool	enable,
		OnDetectSoftwareRecordingHandler	handler,
		void *	data )

for detect software recording your screen or window.

Parameters

enable	for check to callback or not.
handler	callback function.
data	user context data.

Returns

• 0: Success.
• > 0: Failure.

Note

in winOS,Set this interface. When an injection program attempts to modify the system's recording function, the SDK will call back to the upper layer, which will decide whether to continue playing. in macOS,Set this interface. If a third-party recording software is started, the SDK will recall the software name to the upper layer, which will decide whether to continue playing.

Attention

in macOS, need permissions "AllFiles".

PLVSetPreventSoftwareRecording()

PLAYERSDK_API int PLAYERSDK_CALL PLVSetPreventSoftwareRecording	(	void *	window,
		bool	enable )

for prevent screen recording or screenshot.

Parameters

window	window handle.
enable	switch prevent screen recording.

Returns

• 0: Success.
• > 0: Failure.

Note

detect software recording, there are differences between winOS and macOS: in winOS: invoke this api, all recording software cannot capture the set window screen. in macOS: invoke this api, only the system's built-in recording software cannot capture the window image, other third-party software can capture the image and needs to be used with @PLVSetDetectSoftwareRecordingHandler.

Attention

in winOS, @window must be top-level, eg: win WS_EX_APPWINDOW.