获取观看限制配置信息--企业直播-火山引擎

文档中心

立即注册

导航

获取观看限制配置信息

最近更新时间：2024.10.29 18:12:27首次发布时间：2024.09.06 11:05:52

您可通过此接口获取指定直播间的以下观看限制配置信息：公开、密码、白名单、自定义、手机号。

注意事项

请求频率：单用户请求频率限制为 10 次/秒。

请求说明

请求方式：GET
请求地址：https://livesaas.volcengineapi.com/?Action=GetViewingRestrictionInfo&Version=2023-08-01

请求参数

下表仅列出该接口特有的请求参数和部分公共参数。更多信息详见公共参数。

Query

参数	类型	是否必选	示例值	描述
Action	String	是	`GetViewingRestrictionInfo`	接口名称。当前 API 的名称为 `GetViewingRestrictionInfo`。
Version	String	是	`2023-08-01`	接口版本。当前 API 的版本为 `2023-08-01`。
ActivityId	Long	是	`1770****81234`	直播间 ID。您可通过调用 ListActivityAPI 接口获取 ID。
ViewingRestrictionType	Integer	是	`1`	主次观看限制类型。取值如下： `1`：主观看限制和次观看限制 `2`：主观看限制 `3`：次观看限制

返回参数

参数	类型	示例值	描述
ActivityId	Long	`1770****81234`	直播间 ID。
ViewingRestriction	Object of ViewingRestriction	`-`	主观看限制的配置信息。说明仅当 `ViewingRestrictionType` 取值为 `1` 或 `2` 时，该参数生效。
SubViewingRestriction	Object of ViewingRestriction	`-`	次观看限制的配置信息。说明仅当 `ViewingRestrictionType` 取值为 `1` 或 `3` 时，该参数生效。

ViewingRestriction

参数	类型	示例值	描述
ViewingAccountType	Integer	`1`	观看限制。取值如下： `1`：公开 `2`：密码 `3`：白名单 `4`：自定义 `5`：手机号
ViewingRestrictionButtonTitle	String	`公开观看`	观看按钮文案。说明仅当开启次观看限制时，该参数生效。您可调用 UpdateViewingRestriction 接口并将 `IsSubViewingRestrictionEnable` 取值设为 `true`，开启次观看限制。
CommentRestriction	Object of CommentRestriction	`-`	评论限制配置信息。说明仅当 `ViewingAccountType` 取值为 `1` 或 `2` 时，该参数生效。
PasswordViewingRestriction	Object of PasswordViewingRestriction	`-`	密码观看限制配置信息。说明仅当 `ViewingAccountType` 取值为 `2` 时，该参数生效。
WhiteListViewingRestriction	Object of WhiteListViewingRestriction	`-`	白名单观看限制配置信息。说明仅当 `ViewingAccountType` 取值为 `3` 时，该参数生效，您可通过调用 InsertWhitelist 接口添加观众白名单。
CustomViewingRestriction	Object of CustomViewingRestriction	`-`	自定义观看限制配置信息。说明仅当 `ViewingAccountType` 取值为 `4` 时或 `IsAllowCustom` 取值为 `true` 时，该参数生效。
PhoneViewingRestriction	Object of PhoneViewingRestriction	`-`	手机号观看限制配置信息。说明仅当 `ViewingAccountType` 取值为 `5` 时，该参数生效。

CommentRestriction

参数类型示例值描述

参数	类型	示例值	描述
IsAllowPublic	Boolean	`true`	评论限制是否为公开。取值如下： `true`：公开 `false`：非公开说明该参数取值为 `true` 时， `IsAllowCustom` 的取值必为 `false`。
IsAllowWechat	Boolean	`true`	评论限制是否为微信。取值如下： `true`：微信 `false`：非微信
IsAllowCustom	Boolean	`false`	评论限制是否为自定义。取值如下： `true`：自定义 `false`：非自定义说明该参数取值为 `true` 时， `IsAllowPublic` 的取值必为 `false`。

IsAllowPublic

Boolean

true

评论限制是否为公开。取值如下：

true：公开
false：非公开

说明

该参数取值为 true 时， IsAllowCustom 的取值必为 false。

IsAllowWechat

Boolean

true

评论限制是否为微信。取值如下：

true：微信
false：非微信

IsAllowCustom

Boolean

false

评论限制是否为自定义。取值如下：

true：自定义
false：非自定义

说明

该参数取值为 true 时， IsAllowPublic 的取值必为 false。

PasswordViewingRestriction

参数	类型	示例值	描述
Password	String	`123456`	观看密码。
Prompt	String	`欢迎观看本场直播`	提示文案。

WhiteListViewingRestriction

参数	类型	示例值	描述
WelcomeTitle	String	`欢迎观看本场直播`	欢迎标题。
InputPrompt	String	`请输入校验信息`	输入提示。
EnableTrial	Boolean	`true`	是否开启试看功能。取值如下： `true`：开启 `false`：未开启
TrialTime	Integer	`1`	试看时间。单位为分钟。说明当 `EnableTrial` 取值为 `false` 时，该参数取值为 `0`。

CustomViewingRestriction

参数	类型	示例值	描述
CustomApp	String	`App A`	登录账号 App，即您自有账号系统的名称。
CustomUrl	String	`http://myDomain/auth`	登录链接，即您的自有账号系统登录页面的链接。链接包含协议头。
ErrorRedirectUrl	String	`http://myDomain/auth?error=1`	错误重定向地址，即自定义鉴权校验失败后，进入的鉴权校验失败页面的地址。链接包含协议头。
SecretKey	String	`/u/hii/:na`	Secret Key，用于计算校验签名（`Sign`值），计算方法详见回调参数。

PhoneViewingRestriction

参数	类型	示例值	描述
Prompt	String	`欢迎观看本场直播`	提示文案。
IsPhoneListMode	Boolean	`true`	是否开启白名单模式功能。取值如下： `true`：开启 `false`：未开启说明该参数取值为 `true` 时，可调用 InsertPhoneList 接口添加白名单手机号。
EnableTrial	Boolean	`true`	是否开启试看功能。取值如下： `true`：开启 `false`：未开启
TrialTime	Integer	`1`	试看时间。单位为分钟。说明当 `EnableTrial` 取值为 `false` 时，该参数取值为 `0`。
EnableSMS	Boolean	`true`	是否开启短信提醒功能。取值如下： `true`：开启 `false`：未开启

请求示例

GET https://livesaas.volcengineapi.com/?Action=GetViewingRestrictionInfo&Version=2023-08-01&ActivityId=1770****81234&ViewingRestrictionType=1

返回示例

{
    "ResponseMetadata": {
        "Action": "GetViewingRestrictionInfo",
        "Region": "cn-north-1",
        "RequestId": "20230604110420****100232280022D31",
        "Service": "livesaas",
        "Version": "2023-08-01",
        "SystemTime": 1685969459
    },
    "Result": {
        "ActivityId": 1770****81234,
        "ViewingRestriction": {
            "ViewingAccountType": 1,
            "ViewingRestrictionButtonTitle": "公开观看",
            "CommentRestriction": {
                "IsAllowPublic": true,
                "IsAllowWechat": true,
                "IsAllowCustom": false
            },
            "PasswordViewingRestriction": {
                "Password": "",
                "Prompt": ""
            },
            "WhitelistViewingRestriction": {
                "WelcomeTitle": "",
                "InputPrompt": "",
                "EnableTrial": false,
                "TrialTime": 0
            },
            "CustomViewingRestriction": {
                "CustomApp": "",
                "CustomUrl": "",
                "ErrorRedirectUrl": "",
                "SecretKey": ""
            },
            "PhoneViewingRestriction": {
                "Prompt": "",
                "EnableTrial": false,
                "TrialTime": 0,
                "EnableSMS": false,
                "IsPhoneListMode": false
            }
        },
        "SubViewingRestriction": {
            "ViewingAccountType": 2,
            "ViewingRestrictionButtonTitle": "密码观看",
            "CommentRestriction": {
                "IsAllowPublic": false,
                "IsAllowWechat": true,
                "IsAllowCustom": true
            },
            "PasswordViewingRestriction": {
                "Password": "123456",
                "Prompt": "欢迎观看本场直播"
            },
            "WhitelistViewingRestriction": {
                "WelcomeTitle": "",
                "InputPrompt": "",
                "EnableTrial": false,
                "TrialTime": 0
            },
            "CustomViewingRestriction": {
                "CustomApp": "App A",
                "CustomUrl": "http://myDomain/auth",
                "ErrorRedirectUrl": "http://myDomain/auth?error=1",
                "SecretKey": "/u/hii/:na"
            },
            "PhoneViewingRestriction": {
                "Prompt": "",
                "EnableTrial": false,
                "TrialTime": 0,
                "EnableSMS": false,
                "IsPhoneListMode": false
            }
        }
    }
}

错误码

访问公共错误码和错误码获取详细信息。