- RTMPPublishURL()         #生成带授权凭证的 RTMP 推流地址
- RTMPPlayURL()            #生成 RTMP 播放地址
- HLSPlayURL()             #生成 HLS 播放地址
- HDLPlayURL()             #生成 HDL(HTTP-FLV) 播放地址
- SnapshotPlayURL()        #生成直播封面地址
- hub.Create()             #创建流
- hub.Stream()             #获得流
- hub.List()               #查询流列表
- hub.ListLive()           #查询直播列表
- stream.Info()            #查询流信息
- stream.Disable()         #禁播流（秒级禁推/禁播）
- stream.Enable()          #启用流
- stream.LiveStatus()      #查询直播实时信息
- stream.Save()            #保存直播回放
- stream.HistoryActivity() #查询直播历史记录

// SDK 下载地址：https://github.com/pili-engineering/pili-sdk-go
import "github.com/pili-engineering/pili"

// 配置企业开发者密钥
// 密钥使用七牛账号登录 https://portal.qiniu.com/user/key 获取
mac := &pili.MAC{
    AccessKey: "Your_Qiniu_AccessKey",
    SecretKey: "Your_Qiniu_SecretKey",
}

// 直播空间名称
// 直播空间必须事先存在，可以在 portal.qiniu.com 上创建
hubName := "Your_Hub_Name"

// 生成 RTMP 推流地址
// publishDomain: 与直播空间绑定的 RTMP 推流域名，可以在 portal.qiniu.com 上绑定
// streamKey: 流名，流不需要事先存在，推流会自动创建流
// mac: 授权信息
// expireAfterSeconds: 生成的推流地址的有效时间
publishURL := pili.RTMPPublishURL(publishDomain, hub, streamKey, mac, expireAfterSeconds)
/*
rtmp://publish-rtmp.test.com/PiliSDKTest/streamkey?e=1463023142&token=7O7hf7Ld1RrC_fpZdFvU8aCgOPuhw2K4eapYOdII:-5IVlpFNNGJHwv-2qKwVIakC0ME=
*/

// 生成 RTMP 播放地址
// rtmpDomain: 直播空间绑定的 RTMP 直播域名，可以在 portal.qiniu.com 上绑定
rtmpURL := pili.RTMPPlayURL(rtmpDomain, hubName, streamKey)
/*
rtmp://live-rtmp.test.com/PiliSDKTest/streamkey
*/

// 生成 HLS 播放地址
// hlsDomain: 直播空间绑定的 HLS 直播域名，可以在 portal.qiniu.com 上绑定
hlsURL := pili.HLSPlayURL(hlsDomain, hubName, streamKey)
/*
http://live-hls.test.com/PiliSDKTest/streamkey.m3u8
*/

// 生成 HDL 播放地址
// hdlDomain: 直播空间绑定的 HDL 直播域名，可以在 portal.qiniu.com 上绑定
hdlURL := pili.HDLPlayURL(hdlDomain, hubName, streamKey)
/*
http://live-hdl.test.com/PiliSDKTest/streamkey.flv
*/

// 生成直播封面地址
// snapshotDomain: 直播空间绑定的直播封面域名，可以在 portal.qiniu.com 上绑定
snapshotURL := pili.SnapshotPlayURL(snapshotDomain, hubName, streamKey)
/*
http://live-snapshot.test.com/PiliSDKTest/streamkey.jpg
*/

// 初始化授权客户
client := pili.New(mac, nil)

// 初始化直播空间
hub := client.Hub(hubName)

// 初始化流对象
stream := client.Stream(streamKey)

// 流立即禁推、禁播
stream.Disable()

// 恢复可以推流、播流
stream.Enable()

// 禁用该流一段时间
// stream.DisableTill(10) 表示禁用 10 分钟
stream.DisableTill(time.Now().Add(time.Minute).Unix())

// 永久禁用
stream.DisableTill(-1)

// start、end 指定查询的时间范围，指定为 0 值表示查询所有时间段的直播历史记录
records, _ := stream.HistoryActivity(0, 0)
/*
[{1463382401 1463382441}]
*/

// start、end 指定要保存的直播的时间范围，start: Unix 时间戳, 起始时间, 0 值表示不指定, 则不限制起始时间，end: Unix 时间戳, 结束时间, 0 值表示当前时间.都传 0 表示获取这路流所有的直播回看
// 直播数据保存在所绑定的 Qiniu 存储空间中，文件名由系统生成
// 文件可以通过存储空间所绑定的下载域名进行访问，形如 http://<DomainOfStorageBucket>/<Fname>
fname, _ := stream.Save(0, 0)
/*
recordings/z1.PiliSDKTest.streamkey/1463382401_1463382441.m3u8
*/