腾讯云互动白板接入流程-教育服务解决方案
文档转码接入有两种方式：注册回调方式 （适用在互动白板控制台已经 注册回调 的场景，推荐使用该方式，可以更及时收到转码进度和结果的推送）主动轮询方式（适用于没有在互动白板控制台注册回调的场景）此文档主要介绍注册回调方式发起文档转码的基本流程。
准备工作
存储桶配置 （文档转码后的资源文件存储依赖对象存储 COS，使用文档转码功能前，请先进行 存储桶配置）。注意 如果没有进行存储桶配置，转码后的文件存储在互动白板的公共存储桶里，存储有效时间是7天。7天后，公共存储桶里的转码文件自动删除，URL的文件就会失效。建议您进行存储桶配置，将转码文件存储到您自己的存储桶里。注册转码回调（为了让转码服务器，可以将转码结果实时推送给您，您需要注册回调地址；具体方法请参考 控制台回调设置）。注意 由于文档转码存在转码耗时和排队耗时，建议使用服务端 API 提前转码，客户端直接使用转码结果。不建议直接在客户端调用互动白板 SDK 的转码接口applyFileTranscode，避免长时间的等待，影响产品体验。交互流程（注册回调方式）
1. 上传文档(上传到 腾讯云 COS 为例)
为了能让腾讯云转码服务器获取到您待转的课件，您需要提供可以供转码服务器下载课件的 URL 地址。说明：1. 推荐使用腾讯云的 COS 服务来提供下载地址，当然也可以上传到其他存储服务器 或者 其他方式上传。2. 此处以上传到腾讯云 COS GOLANG 语言为例，更多语言实现，请参考 腾讯云 COS。示例代码：
package main
import ( "context" "fmt" "log" "net/http" "net/url" "github.com/tencentyun/cos-go-sdk-v5" "os")
func main() { // 初始化cos 资源 TODO：将 examplebucket-1250000000 和 COS_REGION 修改为真实的信息 domain := "https://examplebucket-1250000000.cos.COS_REGION.myqcloud.com" u, _ := url.Parse(domain) b := &cos.BaseURL{BucketURL: u} cosClient := cos.NewClient(b, &http.Client{ Transport: &cos.AuthorizationTransport{ // TODO：COS_SECRETID 需要替换成用户真实的 SECRETID， COS_SECRETKEY 需要替换成用户真实的 SECRETKEY SecretID: "COS_SECRETID", SecretKey: "COS_SECRETKEY", }, }) // TODO：上传到 cos 的对象键 名称 keyName := "test/objectPut.go" // 本地文件路径 localFilePath := "test/objectPut.go" // 获取文件大小 file_info, err := os.Stat(localFilePath) if err != nil { panic(err) }
opt := &cos.ObjectPutOptions{} opt.ObjectPutHeaderOptions = &cos.ObjectPutHeaderOptions{} opt.ObjectPutHeaderOptions.ContentLength = int(file_info.Size())
// 对象键（Key）是对象在存储桶中的唯一标识。 // 例如，在对象的访问域名 `examplebucket-1250000000.cos.COS_REGION.myqcloud.com/test/objectPut.go` 中，对象键为 test/objectPut.go // 开始上传 _, err = cosClient.Object.PutFromFile(context.Background(), keyName, localFilePath, nil) if err != nil { // 上传失败 panic(err) } // 上传成功，组装 resultUrl resultUrl := fmt.Sprintf("%s/%s", domain, keyName) log.Printf("upload successful! resultUrl[]%s", resultUrl)}
2. 发起转码
由于动态转码存在转码耗时和排队耗时，建议使用服务端 API 提前转码，客户端直接使用转码结果。不建议直接在客户端调用转码接口applyFileTranscode，避免长时间的等待，影响产品体验。说明：1. 接口说明，请参考 文档转码相关接口。 回调事件请参考 文档转码回调事件。 2. SecretId 和 SecretKey 请在 API 密钥管理中获取。3. 其他开发语言 或 转码接口的示例，请参考 示例代码生成。示例代码（GOLANG 为例）：
package main
import ( "fmt"
"github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/common" "github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/common/errors" "github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/common/profile" tiw "github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/tiw/v20190919")
func main() { // "SECRETID" 和 "SECRETKEY" 需要从控制台的 API 密钥管理 中获取 credential := common.NewCredential( "SECRETID", "SECRETKEY", ) cpf := profile.NewClientProfile() cpf.HttpProfile.Endpoint = "tiw.tencentcloudapi.com" client, _ := tiw.NewClient(credential, "ap-guangzhou", cpf)
request := tiw.NewCreateTranscodeRequest() // SdkAppId 为用户自己的互动白板应用 ID Url 为上传文档后，得到的下载地址 params := "{\"SdkAppId\":xxxxxxxxx,\"Url\":\"https://board-sdk-1259648581.file.myqcloud.com/TIC/1590997573551/欢迎新同学.pptx\"}" err := request.FromJsonString(params) if err != nil { panic(err) } response, err := client.CreateTranscode(request) if _, ok := err.(*errors.TencentCloudSDKError); ok { fmt.Printf("An API error has returned: %s", err) return } if err != nil { panic(err) } fmt.Printf("%s", response.ToJsonString())}
3. 处理转码回调
必须要确保在控制台或 API 成功注册了回调，并且回调地址是公网可访问，才能正常收到转码数据回调；如果还没有配置回调，请参考 控制台回调设置。示例代码（GOLANG 为例）：
import ( "encoding/json" "log" "testing")
const ( // 转码进度改变 TranscodeProgressChanged = "TranscodeProgressChanged" // 转码结束 TranscodeFinished = "TranscodeFinished")
// 转码错误type commonError struct { Code string `json:"Code"` Message string `json:"Message"`}
// 转码的事件数据type EventData struct { Error *commonError `json:"Error"` // 错误信息；为空则没有错误 TaskId string `json:"TaskId"` // 文档转码任务 id Progress int `json:"Progress"` // 任务进度 Resolution string `json:"Resolution"` // 文档分辨率 Title string `json:"Title"` // 文档标题 Pages int `json:"Pages"` // 文档总页数 ResultUrl string `json:"ResultUrl"` // 文档转码结果 ThumbnailUrl string `json:"ThumbnailUrl"` // 缩略图 Url ThumbnailResolution string `json:"ThumbnailResolution"` // 缩略图分辨率 CompressFileUrl string `json:"CompressFileUrl"` // 转码结果打包压缩文件的下载 Url}
// 转码回调结果type TranscodeResult struct { EventType string `json:"EventType"` // 事件类型 ExpireTime int `json:"ExpireTime"` // 签名过期时间 SdkAppId int `json:"SdkAppId"` // 互动白板应用 SdkAppId Sign string `json:"Sign"` // 回调签名 Timestamp int `json:"Timestamp"` // 事件生成的 Unix 时间戳，单位秒 EventData EventData `json:"EventData"` // 事件具体信息}
// 通过控制台 或 api 注册到 腾讯文档转码后台 的 转码事件回调接口func TrascoderEventCallback(resultStr []byte) { transcodeResult := TranscodeResult{}
err := json.Unmarshal(resultStr, &transcodeResult) if nil != err { panic(err) } // 处理转码结果 if TranscodeProgressChanged == transcodeResult.EventType { // 转码进度改变 log.Printf("transcode progress [%d]", transcodeResult.EventData.Progress) } else if TranscodeFinished == transcodeResult.EventType { // 转码结束 if nil != transcodeResult.EventData.Error { // 转码失败 log.Printf("transcode failed!err[%v]", transcodeResult.EventData.Error) return } // 转码成功 log.Printf("transcode successful! EventData[%v]", transcodeResult.EventData) }}
4. 使用转码结果
客户端将转码结果，设置到互动白板 ，即可实现文档的上/下一步、上/下一页等功能。白板接口请参考 白板接口说明。代码示例（JS 为例）
// 客户端 根据 文档转码 返回的结果，组装参数let config = { url: eventData.resultUrl, title: eventData.title, pages: eventData.pages, resolution: eventData.resolution}// 将 文档转码 的结果，加入到白板this.teduBoard.addTranscodeFile(config);
效果展示：
腾讯云官网1折活动，限时活动，即将结束，速速收藏
同尘科技为腾讯云授权服务中心。
购买腾讯云产品享受折上折，更有现金返利。同意关联立享优惠
发表评论