package
7.25.0
Repository: https://github.com/qiniu/go-sdk.git
Documentation: pkg.go.dev

# README

Pili Streaming Cloud Server-Side Library for Go

Features

  • 推拉流URL && 签算方法

    • RTMP 推流地址
    • SRT 推流地址
    • RTMP 播放地址
    • HLS 播放地址
    • HDL(FLV) 播放地址
    • 推流 URL 签算(直播鉴权)
    • 播放 URL 签算(时间戳防盗链)
  • 直播空间管理(Hub)

    • 查询直播空间列表 GET /v2/hubs
    • 查询直播空间信息 GET /v2/hubs/<hub>
    • 修改直播空间推流鉴权配置 POST /v2/hubs/<hub>/security
    • 修改直播空间hls低延迟配置 POST /v2/hubs/<hub>/hlsplus
    • 修改直播空间存储配置 POST /v2/hubs/<hub>/persistence
    • 修改直播空间封面配置 POST /v2/hubs/<hub>/snapshot
  • 域名管理(Domain)

    • 查询域名列表 GET /v2/hubs/<hub>/domains
    • 查询域名信息 GET /v2/hubs/<hub>/domains/<domain>
    • 绑定直播域名 POST /v2/hubs/<hub>/newdomains
    • 解绑直播域名 DELETE /v2/hubs/<hub>/domains/<domain>
    • 配置点播域名 POST /v2/hubs/<hub>/voddomain
    • 修改域名证书配置 POST /v2/hubs/<hub>/domains/<domain>/cert
    • 更新域名改写规则 POST /v2/hubs/<hub>/domains/<domain>/urlrewrite
  • 直播流管理(Stream)

    • 查询直播流列表 GET v2/hubs/<hub>/streams
    • 查询直播流信息 GET v2/hubs/<hub>/streams/<EncodedStreamTitle>
    • 禁用直播流 POST /v2/hubs/<hub>/streams/<EncodedStreamTitle>/disabled
    • 查询在线流信息 GET v2/hubs/<hub>/streams/<EncodedStreamTitle>/live
    • 批量查询在线流信息 POST /v2/hubs/<hub>/livestreams
    • 查询直播流推流记录 GET /v2/hubs/<hub>/streams/<EncodedStreamTitle>/historyactivity
    • 录制直播回放 POST /v2/hubs/<hub>/streams/<EncodedStreamTitle>/saveas
    • 保存直播截图 POST /v2/hubs/<hub>/streams/<EncodedStreamTitle>/snapshot
    • 修改直播流转码配置 POST /v2/hubs/<hub>/streams/<EncodedStreamTitle>/converts
  • 数据统计(Stat)

    • 上行流量 GET /statd/upflow
    • 下行流量 GET /statd/downflow
    • 直播转码使用量 GET /statd/codec
    • 直播鉴黄使用量 GET /statd/nrop
    • 导播台使用量 GET /statd/caster
    • Pub服务使用量 GET /statd/pub

Usage

package main

import (
	// ...
	"github.com/qiniu/go-sdk/v7/pili"
)

var (
	AccessKey = "<QINIU ACCESS KEY>" // 替换成自己 Qiniu 账号的 AccessKey
	SecretKey = "<QINIU SECRET KEY>" // 替换成自己 Qiniu 账号的 SecretKey
)

func main() {
	// ...
	conf := pili.ManagerConfig{AccessKey: AccessKey, SecretKey: SecretKey}
	manager := pili.NewManager(conf)
	// ...
}

# Functions

No description provided by the author
Form 请求参数格式化.
HDLPlayURL 生成 HDL 播放地址.
HLSPlayURL 生成 HLS 播放地址.
NewManager 用于构建一个新的 Manager.
RTMPPlayURL 生成 RTMP 播放地址.
RTMPPublishURL 生成 RTMP 推流地址.
SetAppName 设置App名称 命名规则遵循 [A-Za-z0-9_\ \-\.]*.
SignPlayURL 播放 URL 签算(时间戳防盗链) 支持鉴权规格为 - tsStartMD5: 时间戳防盗链开始时间限制 - tsExpireMD5: 时间戳防盗链结束时间限制.
SignPublishURL 推流 URL 签算(直播鉴权) 支持鉴权规格为 - static: 静态鉴权 - expiry: 限时鉴权 - expiry_sk: 限时鉴权SK - dynamic: 动态鉴权.
SRTPublishURL 生成 SRT 推流地址.

# Constants

APIHost 标准 API 服务器地址.
APIHTTPScheme HTTP 模式.
APIHTTPSScheme HTTPS 模式.
CodecDefaultSelect 转码使用量默认查询字段.
DefaultAppName 默认 AppName 名称.
DomainLiveHDL HDL 播放域名.
DomainLiveHLS HLS 播放域名.
DomainLiveRTMP RTMP 播放域名.
DomainPublishRTMP 推流域名.
FlowDefaultSelect 上下行流量默认查询字段.
IAMAPIHost IAM(权限策略) API 服务器地址.
NropDefaultSelect 鉴黄使用量默认查询字段.
Deprecated: SecurityTypeDynamic 动态鉴权 用于推流 URL 签算(直播鉴权),该鉴权类型即将移除,不建议使用.
SecurityTypeDynamicNoncePart 动态鉴权随机值字段名.
SecurityTypeExpiry 限时鉴权 用于推流 URL 签算(直播鉴权).
SecurityTypeExpirySK 限时鉴权SK 用于推流 URL 签算(直播鉴权).
SecurityTypeExpirySkTsPart 推流限时鉴权sk时间戳字段名.
SecurityTypeExpiryTsPart 推流限时鉴权时间戳字段名.
SecurityTypeNone 关闭鉴权 用于推流 URL 签算(直播鉴权)和播放 URL 签算(时间戳防盗链) 强制关闭鉴权,域名级别鉴权不继承直播空间级别鉴权配置.
SecurityTypeNull 未设置鉴权.
SecurityTypeStatic 静态鉴权 用于推流 URL 签算(直播鉴权).
SecurityTypeStaticKeyPart 静态鉴权密钥字段名.
SecurityTypeTokenPart 鉴权签算字段名 用于 限时鉴权(expiry)、限时鉴权SK(expiry_sk)、动态鉴权(dynamic).
SecurityTypeTsExpireMD5 时间戳防盗链结束时间限制 用于播放 URL 签算(时间戳防盗链) 签算有效时间从当前时间开始,直到 URL 的时间戳为止.
SecurityTypeTsStartMD5 时间戳防盗链开始时间限制 用于播放 URL 签算(时间戳防盗链) 签算有效时间从 URL 的时间戳开始,直到超过有效时间(range)范围.
SRTPort SRT 协议端口 截止目前,SRT 协议没有 IANA 官方约定的端口号 七牛采用 1935/UDP 作为 SRT 协议端口号.
SRTScheme SRT 协议头.
No description provided by the author

# Variables

No description provided by the author
No description provided by the author
No description provided by the author

# Structs

AccessLogOptions 配置.
BatchGetStreamLiveStatusRequest 批量查询直播实时状态请求参数.
BatchGetStreamLiveStatusResponse 批量查询直播实时状态返回值.
BindDomainRequest 绑定域名请求参数.
BindVodDomainRequest 绑定点播域名请求参数.
DefaultDomain 默认域名.
DomainCallbackConfig 域名回调配置.
DomainIPLimit IP 限制.
DomainPlaySecurity 时间戳防盗链配置.
DomainUrlRewrite URL 改写规则配置.
DomainUrlRewriteItem URL 改写规则项.
DomainURLRewriteRule URL 改写规则.
GetDomainInfoRequest 查询域名信息请求参数.
GetDomainInfoResponse 查询域名信息返回值.
GetDomainsListItem 查询域名列表项.
GetDomainsListRequest 查询域名列表请求参数.
GetDomainsListResponse 查询域名列表返回值.
GetHubInfoRequest 查询直播空间信息请求参数.
GetHubInfoResponse 查询直播空间信息返回值.
GetHubListItem 查询直播空间列表项.
GetHubListResponse 查询直播空间列表返回值.
GetStatCasterRequest 获取导播台使用量请求参数.
GetStatCodecRequest 获取直播转码使用量请求参数.
GetStatCommonRequest 统计接口通用请求参数.
GetStatDownflowRequest 获取下行流量请求参数.
GetStatNropRequest 获取直播鉴黄使用量请求参数.
GetStatPubRequest 获取Pub服务使用量请求参数.
GetStatUpflowRequest 获取上行流量请求参数.
GetStreamBaseInfoRequest 查询直播流信息请求参数.
GetStreamBaseInfoResponse 查询直播流信息返回值.
GetStreamHistoryItem 查询直播流推流记录项.
GetStreamHistoryRequest 查询直播流推流记录请求参数.
GetStreamHistoryResponse 查询直播流推流记录返回值.
GetStreamListRequest 查询直播流列表请求参数.
GetStreamLiveStatusRequest 查询直播流实时信息请求参数.
GetStreamLiveStatusResponse 查询直播流实时信息返回值.
GetStreamsListResponse 查询直播流列表返回值.
No description provided by the author
GroupStatCasterRequest 分组获取导播台使用量请求参数.
GroupStatCodecRequest 分组获取直播转码使用量请求参数.
GroupStatDownflowRequest 分组获取下行流量请求参数.
GroupStatNropRequest 分组获取直播鉴黄使用量请求参数.
GroupStatPubRequest 分组获取Pub服务使用量请求参数.
GroupStatUpflowRequest 分组获取上行流量请求参数.
HubDomain 直播空间下的域名简要信息.
HubHlsplusRequest 修改直播空间 hls 低延迟配置请求参数.
HubPersistenceRequest 修改直播空间存储配置请求参数.
HubSecurityRequest 修改直播空间推流鉴权配置请求参数.
HubSnapshotRequest 修改直播空间封面配置请求参数.
Manager 提供了 Qiniu PILI Service API 相关功能.
ManagerConfig 构建Manager的参数配置.
NropArgs 鉴黄配置.
SetDomainCertRequest 修改域名证书配置请求参数.
SetDomainURLRewriteRequest 修改域名改写规则配置请求参数.
SignPlayURLArgs 播放 URL 签算(时间戳防盗链)请求参数.
SignPublishURLArgs 推流 URL 签算(直播鉴权)请求参数.
StatGroupResponse 分组统计返回值.
StatResponse 统计返回值.
StreamConvertsRequest 修改直播流转码配置请求参数.
StreamDisabledRequest 禁用直播流请求参数.
StreamLiveStatus 直播流实时状态.
StreamLiveStatusFPS 流实时帧率.
StreamSaveasRequest 录制直播回放请求参数.
StreamSaveasResponse 录制直播回放返回值.
StreamSnapshotRequest 保存直播截图请求参数.
StreamSnapshotResponse 保存直播截图返回值.
UnbindDomainRequest 解绑域名请求参数.
No description provided by the author