tencent cloud

To use the porn detection capability of CSS, you need to enable screencapturing. You can use the porn detection feature either by configuring it in the CSS console or by using APIs. This document shows you how to use porn detection APIs.

Must-Knows

If your COS bucket allows public read access and has politically sensitive, pornographic, or other inappropriate content, to avoid the bucket being blocked, please delete the content first.

Enabling Porn Detection

Because the porn detection feature is based on screencapturing, you need to enable screencapturing first.

1. Create a screencapturing template with porn detection enabled

Call CreateLiveSnapshotTemplate, setting PornFlag to 1 to create a screencapturing template with porn detection enabled.

2. Create a screencapturing rule

Call CreateLiveSnapshotRule, setting TemplateId to the ID of the screencapturing template created in step 1 to associate the template with the target AppId, DomainName, AppName, and StreamName.

3. Start live streaming

After you create a screencapturing rule with porn detection enabled, the porn detection feature will be automatically enabled for new streams. If you want to enable porn detection for an ongoing stream, you need to stop and restart the stream.

Getting the Porn Detection Result

After porn detection is enabled, you can configure a registered domain name in the porn detection callback template to receive callbacks of porn detection results.

Note：

By default, callbacks are sent only if suspicious content is detected.

1. Create a porn detection callback template

Call CreateLiveCallbackTemplate, setting PornCensorshipNotifyUrl to your domain name to create a porn detection callback template.

2. Create a porn detection callback rule

Call CreateLiveCallbackRule, setting TemplateId to the ID of the callback template created in step 1 to associate the template with the target AppId, DomainName, and AppName.

3. Get the porn detection result

The CSS backend will send porn detection results to your domain in the form of HTTP POST requests. You can find the results in JSON format in the request body. The type field indicates whether a live stream contains pornographic content.

Note：

The system cannot achieve 100% accuracy. There may be false positives or false negatives. We recommend you review the images suspected of being pornographic using the type field.

The parameters are as follows:

LabelResult

The label hit result generated by the category model.

LabelDetailItem

The sub-label hit details.

ObjectResult

The object detection result.

ObjectDetail

The object detection details. If the scene identified is object, advertising logo, or QR code, this parameter returns the label name, label value, label score, and location information.

Location

The location information of the suspicious content.

OcrResult

The OCR result.

OcrTextDetail

The OCR details.

LibResult

The result generated by the block/allowlist library.

LibDetail

The custom library or block/allowlist library detection details.

Sample callback

{
        "ocrMsg": "",
        "type": [1],
        "socre": 99,
        "screenshotTime": 1610640000,
        "level": 0,
        "img": "http://1.1.1.1/download/porn/test.jpg",
        "abductionRisk": [],
        "faceDetails": [],
        "sendTime": 1615859827,
        "suggestion": "Block",
        "label": "Porn",
        "subLabel": "PornHigh",
        "labelResults": [{
                "HitFlag": 0,
                "Scene": "Illegal",
                "Suggestion": "Pass",
                "Label": "Normal",
                "SubLabel": "",
                "Score": 0,
                "Details": []
        }, {
                "HitFlag": 1,
                "Scene": "Porn",
                "Suggestion": "Block",
                "Label": "Porn",
                "SubLabel": "PornHigh",
                "Score": 99,
                "Details": [{
                        "Id": 0,
                        "Name": "PornHigh",
                        "Score": 99
                }, {
                        "Id": 1,
                        "Name": "WomenChest",
                        "Score": 99
                }]
        }, {
                "HitFlag": 0,
                "Scene": "Sexy",
                "Suggestion": "Pass",
                "Label": "Normal",
                "SubLabel": "",
                "Score": 0,
                "Details": []
        }, {
                "HitFlag": 0,
                "Scene": "Terror",
                "Suggestion": "Pass",
                "Label": "Normal",
                "SubLabel": "",
                "Score": 0,
                "Details": []
        }],
        "objectResults": [{
                "HitFlag": 0,
                "Scene": "QrCode",
                "Suggestion": "Pass",
                "Label": "Normal",
                "SubLabel": "",
                "Score": 0,
                "Names": [],
                "Details": []
        }, {
                "HitFlag": 0,
                "Scene": "MapRecognition",
                "Suggestion": "Pass",
                "Label": "Normal",
                "SubLabel": "",
                "Score": 0,
                "Names": [],
                "Details": []
        }, {
                "HitFlag": 0,
                "Scene": "PolityFace",
                "Suggestion": "Pass",
                "Label": "Normal",
                "SubLabel": "",
                "Score": 0,
                "Names": [],
                "Details": []
        }],
        "ocrResults": [{
                "HitFlag": 0,
                "Scene": "OCR",
                "Suggestion": "Pass",
                "Label": "Normal",
                "SubLabel": "",
                "Score": 0,
                "Text": "",
                "Details": []
        }],
        "streamId": "teststream",
        "channelId": "teststream",
        "stream_param": "txSecret=40f38f69f574fd51126c421a3d96c374&txTime=5DEBEC80",
        "app": "5000.myqcloud.com",
        "appname": "live",
        "appid": 10000,
        "event_type": 317,
        "sign": "ac920c3e66**********78cf1b5de2c63",
        "t": 1615860427
}

Disabling Porn Detection

You can disable porn detection by deleting the screencapturing rule or modifying the screencapturing template. The change only takes effect for new streams. If you want to disable porn detection for an ongoing stream, you need to stop and restart the stream.

1. Delete the screencapturing rule

Call DeleteLiveSnapshotRule, passing in the DomainName, AppName, and StreamName bound to the screencapturing template ID to delete the screencapturing rule.

2. Modify the screencapturing template

Call ModifyLiveSnapshotTemplate, setting PornFlag to 0.