Merge pull request #94 from volcengine/release_v2.9.3

v2.9.3

Author: zyBaosu

CHANGELOG.md

@@ -1,4 +1,7 @@
 # ChangeLog of TOS SDK for Go
+## 版本号 v2.9.3 日期：2026-04-23
+- VideoDataProcess 增加 PCM 处理
+
 ## 版本号 v2.9.2 日期：2026-04-08
 - SemanticQuery 增加 Caption、Description
 

tos/consts.go

@@ -7,7 +7,7 @@ import (
 
 const (
 	// Version tos-go-sdk version
-	Version = "v2.9.2"
+	Version = "v2.9.3"
 )
 
 const TempFileSuffix = ".temp"

tos/dns_cache.go

@@ -129,7 +129,11 @@ func (c *cache) Get(key string) ([]string, bool) {
 	if !data.keepAlive && data.expireAt.Before(time.Now()) {
 		return nil, false
 	}
-	return data.ipList, true
+	// 返回拷贝，避免调用方对 cache 内部切片做原地修改（例如 rand.Shuffle）
+	// 造成多 goroutine 间的 data race。
+	ipList := make([]string, len(data.ipList))
+	copy(ipList, data.ipList)
+	return ipList, true
 }
 
 func (c *cache) cleanCache() {

tos/enum/enum.go

@@ -327,7 +327,7 @@ type DistanceMetricType string
 
 const (
 	DistanceMetricEuclidean DistanceMetricType = "euclidean"
-	DistanceMetricCosine   DistanceMetricType = "cosine"
+	DistanceMetricCosine    DistanceMetricType = "cosine"
 )
 
 type AuthProtocolType string

tos/object.go

@@ -1595,11 +1595,10 @@ func (cli *ClientV2) VideoDataProcess(ctx context.Context, input *VideoDataProce
 
 	process := input.Process
 
-	if !strings.HasPrefix(process, "x-tos-post-process=video/snapshots,") {
+	if !strings.HasPrefix(process, "x-tos-post-process=") {
 		process = "x-tos-post-process=video/snapshots," + process
 	}
 
-
 	res, err := cli.newBuilder(input.Bucket, input.Key).
 		SetGeneric(input.GenericInput).
 		WithQuery("x-tos-post-process", "").

tos/transport.go

@@ -312,7 +312,7 @@ func (d *TimeoutDialer) DialContext(ctx context.Context, network, address string
 			return nil, err
 		}
 
-		// 随机打乱 IP List
+		// 随机打乱 IP List（cache.Get 已返回拷贝，可安全原地打乱）
 		rand.Shuffle(len(ipList), func(i, j int) {
 			ipList[i], ipList[j] = ipList[j], ipList[i]
 		})

tos/type.go

@@ -2672,7 +2672,7 @@ type ObjectSetQuotaRule struct {
 }
 
 type PutObjectSetQuotaByTagInput struct {
-	GenericInput `json:"-"`                      // v2.8.0
+	GenericInput `json:"-"`           // v2.8.0
 	Bucket       string               `json:"-"` // required
 	Rules        []ObjectSetQuotaRule `json:"Rules"`
 }
@@ -2682,8 +2682,8 @@ type PutObjectSetQuotaByTagOutput struct {
 }
 
 type GetObjectSetQuotaByTagInput struct {
-	GenericInput `json:"-"`        // v2.8.0
-	Bucket       string `json:"-"` // required
+	GenericInput `json:"-"` // v2.8.0
+	Bucket       string     `json:"-"` // required
 }
 
 type GetObjectSetQuotaByTagOutput struct {
@@ -2692,29 +2692,29 @@ type GetObjectSetQuotaByTagOutput struct {
 }
 
 type DeleteObjectSetQuotaByTagInput struct {
-	GenericInput `json:"-"`        // v2.8.0
-	Bucket       string `json:"-"` // required
+	GenericInput `json:"-"` // v2.8.0
+	Bucket       string     `json:"-"` // required
 }
 
 type DeleteObjectSetQuotaByTagOutput struct {
 	RequestInfo
 }
 
 type PutObjectSetQuotaInput struct {
-	GenericInput  `json:"-"`        // v2.8.0
-	Bucket        string `json:"-"` // required
-	ObjectSetName string `location:"query" locationName:"ObjectSetName" json:"-"`
-	StorageQuota  string `json:"StorageQuota"`
+	GenericInput  `json:"-"` // v2.8.0
+	Bucket        string     `json:"-"` // required
+	ObjectSetName string     `location:"query" locationName:"ObjectSetName" json:"-"`
+	StorageQuota  string     `json:"StorageQuota"`
 }
 
 type PutObjectSetQuotaOutput struct {
 	RequestInfo
 }
 
 type GetObjectSetQuotaInput struct {
-	GenericInput  `json:"-"`        // v2.8.0
-	Bucket        string `json:"-"` // required
-	ObjectSetName string `location:"query" locationName:"ObjectSetName" json:"-"`
+	GenericInput  `json:"-"` // v2.8.0
+	Bucket        string     `json:"-"` // required
+	ObjectSetName string     `location:"query" locationName:"ObjectSetName" json:"-"`
 }
 
 type GetObjectSetQuotaOutput struct {
@@ -2723,9 +2723,9 @@ type GetObjectSetQuotaOutput struct {
 }
 
 type GetObjectSetStorageInput struct {
-	GenericInput  `json:"-"`        // v2.8.0
-	Bucket        string `json:"-"` // required
-	ObjectSetName string `location:"query" locationName:"ObjectSetName" json:"-"`
+	GenericInput  `json:"-"` // v2.8.0
+	Bucket        string     `json:"-"` // required
+	ObjectSetName string     `location:"query" locationName:"ObjectSetName" json:"-"`
 }
 
 type StorageStat struct {
@@ -3441,6 +3441,12 @@ type VideoDataProcessInput struct {
 // VideoDataProcessOutput 视频数据处理响应参数
 type VideoDataProcessOutput struct {
 	RequestInfo
+	VideoSnapshotsOutput
+	PcmDataProcessOutput
+}
+
+// VideoSnapshotsOutput 视频快照（video/snapshots）处理返回字段
+type VideoSnapshotsOutput struct {
 	OutputBucket    string
 	TotalFrameCount int
 	SuccFrameCount  int
@@ -3449,6 +3455,13 @@ type VideoDataProcessOutput struct {
 	FailFrameList   []FailFrame
 }
 
+// PcmDataProcessOutput 音频 PCM 转码（audio/pcm）处理返回字段
+type PcmDataProcessOutput struct {
+	PcmBucket string `json:"bucket,omitempty"`
+	PcmObject string `json:"object,omitempty"`
+	PcmStatus string `json:"status,omitempty"`
+}
+
 // SuccFrame 成功的帧信息
 type SuccFrame struct {
 	FrameIndex int