本文档提供了使用 C++SDK 的操作步骤及代码示例，通过本文您可以快速了解如何使用 SDK 提供的功能。您也可以通过 Demo 中的示例进行了解和自有业务开发。
SDK 名词含义及功能说明
参见 plv-player-def.h
SDK 全局函数
- 设置日志，日志过滤项。
- 设置观众信息（用于后台数据追踪）。
- 设置相关参数（硬解开关，网络请求类型等）。
- 初始化（userid, key, readtokan）。
- 退出析构。
std::count << "the sdk version:" << PLVGetSdkVersion() << std::endl;
// 路径须使用utf8
std::string logFile = "C:\log\sdk.log"
int ret = PLVSetSdkLogFile(logFile.c_str());
std::count << "the log file result:" << ret << std::endl;
// 设置先 https 请求网络数据
PLVSetSdkHttpRequest(ONLY_HTTPS_REQUEST);
// 设置结束播放之后保留最后的画面
PLVSetSdkKeepLastFrame(true);
// 设置 viewer 信息，用于定位播放质量问题，在线播放下可以通过后台来查看，建议调用此接口设置信息
// 最新 vrm12 下必须设置，否则播放会报错
std::string viewerId = "业务id";// 唯一值
std::string viewerName = "业务nick";
std::string viewerAvatar= "业务Avatar";
PLVSetSdkViewerInfo(viewerId.c_str(), viewerName.c_str(), viewerAvatar.c_str());
// 请填入你的项目 User ID
std::string userID = "xxxxxxxx";
// 请填入你的项目 Secret Key
std::string secretKey = "xxxxxxxxxxxxxxxxxxxxxx";
// 请填入你的项目 Read Token
std::string readToken= "xxxxxxxxxxxxxxxxxxx";
ret = PLVInitSdkLibrary(userID.c_str(), secretKey.c_str(), readToken.c_str());
std::cout << "init sdk result:" << ret << std::endl;
// 获取错误描述
auto desc = PLVGetSdkErrorDescription(ret);
std::cout<< "the error info: << desc << std::endl;
// 退出使用
PLVReleaseSdkLibrary();
SDK 防录制功能
防录制功能的说明，必须 SDK 初始化之后才能使用，操作步骤及功能示例如下：
// 注意通知回调都是子线程，如果更新 ui 及操作 api 都需要 post 到主线程
class Record{
public:
Record(void){
// 软件破解注入通知
PLVSetPluginInjectHandler(true, []{
// 有插件注入通知，可能有软件在录制你的播放界面，可以在业务上做处理
// PostMessage
}, userdata);
// HDMI 变动通知
PLVSetHDMIDeviceChangedHandler(true, [](HDMI_DEVICE_TYPE type, const char* device, void* data){
// HDMI 设备有变动，请根据 type 类型判断，可能是 HDMI 设备在录制你的屏幕
// PostMessage
}, userdata);
}
// 软件防录制
int SetPreventRecord(void* window, bool enable){
PLVGetPreventRecord(window, enable);
}
};
SDK 下载器
视频下载的操作步骤及功能示例如下：
// 注意通知回调都是子线程，如果更新 ui 及操作 api 都需要 post 到主线程
class Download{
private:
PLVDownloadPtr downolader = nullptr;
public:
Download(void){
// 创建下载器
downolader = PLVDownloadCreate();
// 设置错误回调通知
PLVDownloadSetErrorHandler(downolader, [](const char* vid, int code, void* data) {
// 错误通知 code 为错误码
// PostMessage
}, userdata);
// 设置下载进度回调通知
PLVDownloadSetProgressHandler(downolader, [](const char* vid, long long receivedBytes, long long totalBytes, void* data) {
// 下载进度
// PostMessage
}, userdata);
// 设置下载结果回调通知
PLVDownloadSetResultHandler(downolader, [](const char* vid, int rate, int code, void* data) {
// 下载结果
// PostMessage
}, userdata);
}
~Download(void){
PLVDownloadDestroy(downolader);
downolader = nullptr;
}
// 设置下载信息，操作前必须先调用此接口
int SetVideo(const char* vid, const char* path, int rate){
return PLVDownloadSetVideo(downolader, vid, path, rate);
}
// 开始下载
// autoDownRate 是否自动降清晰度，false 如果没有这个清晰度则返回错误码
int Start(bool autoDownRate){
return PLVDownloadStart(downolader, autoDownRate);
}
// 结束下载，退出线程
int Stop(void){
return PLVDownloadStop(downolader);
}
// 暂停下载，不退出线程，可以快速切换下载状态
int Pause(void){
return PLVDownloadPause(downolader);
}
// 删除下载文件
int Delete(void){
return PLVDownloadDelete(downolader);
}
};
SDK 播放器
视频播放的操作步骤及功能示例如下：
// 注意通知回调都是子线程，如果更新 ui 及操作 api 都需要 post 到主线程
class Player{
private:
PLVPlayer mediaPlayer = nullptr;
public:
Player((void*)window){
// 创建播放器
mediaPlayer = PLVPlayerCreate(window);
// 设置播放器的播放状态通知
PLVPlayerSetStateHandler(mediaPlayer, [](const char* vid, int state, void* data) {
// 播放器的状态，state 参见 PLAYER_MEDIA_STATE
// PostMessage();
}, userdata);
// 设置视频的属性回调通知
PLVPlayerSetPropertyHandler(mediaPlayer, [](const char* vid, int property, int format, const char* value, void* data) {
// 播放器的属性值
// PostMessage();
}, userdata);
// 设置码率清晰度变化通知 （只有输入的码率不存在，自动降值才会触发此通知）
PLVPlayerSetRateChangeHandler(mediaPlayer, [](const char* vid, int inputBitRate, int realBitRate, void* data) {
// 真实的清晰度，比如目标清晰度为超清，但不存在此清晰度，会自动降值为 realBitRate
// PostMessage();
}, userdata);
// 设置播放器播放进度回调通知
PLVPlayerSetProgressHandler(mediaPlayer, [](const char* vid, int millisecond, void* data) {
// 播放位置
// PostMessage();
}, userdata);
// 设置扬声器设备有热插拔的变动通知
PLVPlayerSetAudioDeviceHandler(mediaPlayer, [](const char* vid, int audioDeviceCount, void* data) {
// 扬声器设备变动，此为设备热插拔变动通知，可以 post 到主线程再调用 ReloadAudio();
// PostMessage();
}, userdata);
}
~Player(void){
PLVPlayerDestroy(mediaPlayer);
mediaPlayer = nullptr;
}
// 设置跑马灯
int SetOSD(bool enable, const OSDConfigInfo* config){
return PLVPlayerSetOSDConfig(mediaPlayer, enable, config);
}
int GetOSD(OSDConfigInfo& config){
return PLVPlayerGetOSDConfig(config);
}
// 设置 LOGO text
int SetLogo(bool enable, const LogoTextInfo* config);
int GetLogo(LogoTextInfo& config);
// 设置缓存，可以不设置，播放器会有默认值
int SetCache(bool enable, int maxCacheBytes, int maxCacheSeconds);
int GetCache(int* maxCacheBytes, int* maxCacheSeconds);
// 播放前要先设置 vid
int SetVideo(const char* vid, const char* path, int rate);
// 播放，token 外部获取，seekMillisecond 为要跳转到播放位置，sync 由于会先请求 vid 的信息，会有 http 请求，如果网络好请使用 true 同步，否则可以用 false
int Play(const char* token, int seekMillisecond, bool sync);
// 本地播放
int PlayLocal(int seekMillisecond);
// 本地加载，不播放
int LoadLocal(int seekMillisecond);
int Pause(bool pause);
int Stop(void);
int SetMute(bool mute);
// 跳转，由于视频文件都是经过后台编码过，关键帧会被优化，跳转会不准确。可以对比 mp4 与 m3u8，差别会比较大，mp4 拖动很准，m3u8 跳动很大。
int SetSeek(int millisecond);
// 跳转到结束，由于 m3u8 跳转不准，有需要跳转到尾部的请使用此接口
int SeekToEnd(void);
int SetVolume(int volume);
// 声音增益，最大可到 1000
int SetVolumeMax(int volume);
// 倍数播放
int SetSpeed(double speed);
// 截图，注意使用 utf8
int Screenshot(const char* filename);
// 扬声器热插拔相关
// 对设备不要求精确到某个设备，可以优化为，收到变动通知，post 到其它线程，再调用 ReloadAudio
int GetAudioDeviceCount();
int GetAudioDeviceInfo(int index, char deviceId[PLV_MAX_DEVICE_ID_LENGTH], char deviceName[PLV_MAX_DEVICE_ID_LENGTH]);
int GetCurrentAudioDevice(char deviceId[PLV_MAX_DEVICE_ID_LENGTH]);
int SetCurrentAudioDevice(const char deviceId[PLV_MAX_DEVICE_ID_LENGTH]);
int ReloadAudio();
};
SDK 注意事项
- 所有接口与路径相关，都必须使用 utf8 编码。
- 所有回调通知，都不能在里面更新界面或者调用其它 api，更新界面必须 post 到 ui 线程，调用 api 必须在其它线程操作。
- 指定 cacert.pem 路径。 SDK 会判断库的路径位置，但有可能存在判断错误，最好的解决方案是调用 PLVSetSdkCacertFile 指定路径。
