tencentcloud-sdk-trtc 3.0.711 → 3.0.712

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 85119b85967c7ffb7bd0c0e8fa23faa0b927a63e
-  data.tar.gz: a70e75dc692821cdd92f4736b0c5f41a4e390c19
+  metadata.gz: 2f397855deb26b15118c7d71f67838a6eb629933
+  data.tar.gz: c9d3423607d963e7f487747e6f8f5a2d5ebac43e
 SHA512:
-  metadata.gz: f97121f4f5093e0fefe6e803efdc5fbeab97b2a3d8248b649571acece43b07d8f16e0baf21612eef5587c52b51b46df85c8c350bc0751b3a840da7e24a0813e7
-  data.tar.gz: 29718157d42eb7a230e34c3240fe7098d84ec5a8c42245f1d73d8c253ef34b703abaf9e6e6cc46fcee08f10ed19e18e464ba9cabcca5baaddfa3e1b4a97348b2
+  metadata.gz: fb83659613c28999caa3f2b3da21880e9deacd1c0bad1b898b47316ba7351043384c429f49baf349286866e20ee07663bbabc91f4d7228e00c2813bf78e054ed
+  data.tar.gz: e89346146dff04c96529d71c4af11504c36abc7f898dfa344fd5e4dfaca8bc44472276c0016363f4675b41f452e699e6e5a5ac6c6bc4af4b4c6c9b3c43068b34

data/lib/VERSION

@@ -1 +1 @@
-3.0.711
+3.0.712

data/lib/v20190722/client.rb

@@ -379,6 +379,30 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
+        # 您可以查询转推任务的状态。
+
+        # @param request: Request instance for DescribeStreamIngest.
+        # @type request: :class:`Tencentcloud::trtc::V20190722::DescribeStreamIngestRequest`
+        # @rtype: :class:`Tencentcloud::trtc::V20190722::DescribeStreamIngestResponse`
+        def DescribeStreamIngest(request)
+          body = send_request('DescribeStreamIngest', request.serialize)
+          response = JSON.parse(body)
+          if response['Response'].key?('Error') == false
+            model = DescribeStreamIngestResponse.new
+            model.deserialize(response['Response'])
+            model
+          else
+            code = response['Response']['Error']['Code']
+            message = response['Response']['Error']['Message']
+            reqid = response['Response']['RequestId']
+            raise TencentCloud::Common::TencentCloudSDKException.new(code, message, reqid)
+          end
+        rescue TencentCloud::Common::TencentCloudSDKException => e
+          raise e
+        rescue StandardError => e
+          raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
+        end
+
         # 查询TRTC监控仪表盘-数据大盘质量指标（包括下列指标）
         # joinSuccessRate：加入频道成功率。
         # joinSuccessIn5sRate：5s内加入频道成功率。
@@ -1137,6 +1161,30 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
+        # 将一个在线媒体流推到TRTC房间。
+
+        # @param request: Request instance for StartStreamIngest.
+        # @type request: :class:`Tencentcloud::trtc::V20190722::StartStreamIngestRequest`
+        # @rtype: :class:`Tencentcloud::trtc::V20190722::StartStreamIngestResponse`
+        def StartStreamIngest(request)
+          body = send_request('StartStreamIngest', request.serialize)
+          response = JSON.parse(body)
+          if response['Response'].key?('Error') == false
+            model = StartStreamIngestResponse.new
+            model.deserialize(response['Response'])
+            model
+          else
+            code = response['Response']['Error']['Code']
+            message = response['Response']['Error']['Message']
+            reqid = response['Response']['RequestId']
+            raise TencentCloud::Common::TencentCloudSDKException.new(code, message, reqid)
+          end
+        rescue TencentCloud::Common::TencentCloudSDKException => e
+          raise e
+        rescue StandardError => e
+          raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
+        end
+
         # 接口说明：结束云端混流
 
         # @param request: Request instance for StopMCUMixTranscode.
@@ -1209,6 +1257,30 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
+        # 停止一个拉流转推任务。
+
+        # @param request: Request instance for StopStreamIngest.
+        # @type request: :class:`Tencentcloud::trtc::V20190722::StopStreamIngestRequest`
+        # @rtype: :class:`Tencentcloud::trtc::V20190722::StopStreamIngestResponse`
+        def StopStreamIngest(request)
+          body = send_request('StopStreamIngest', request.serialize)
+          response = JSON.parse(body)
+          if response['Response'].key?('Error') == false
+            model = StopStreamIngestResponse.new
+            model.deserialize(response['Response'])
+            model
+          else
+            code = response['Response']['Error']['Code']
+            message = response['Response']['Error']['Message']
+            reqid = response['Response']['RequestId']
+            raise TencentCloud::Common::TencentCloudSDKException.new(code, message, reqid)
+          end
+        rescue TencentCloud::Common::TencentCloudSDKException => e
+          raise e
+        rescue StandardError => e
+          raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
+        end
+
         # 更新转推任务。
         # 注：请参见启动转推任务的接口说明和使用说明。
 

data/lib/v20190722/models.rb

@@ -129,6 +129,30 @@ module TencentCloud
         end
       end
 
+      # 音频转码参数
+      class AudioEncodeParams < TencentCloud::Common::AbstractModel
+        # @param SampleRate: 音频采样率，取值为[48000, 44100]，单位是Hz。
+        # @type SampleRate: Integer
+        # @param Channel: 音频声道数，取值范围[1,2]，1表示音频为单声道，2表示音频为双声道。
+        # @type Channel: Integer
+        # @param BitRate: 音频码率，取值范围[8,500]，单位为kbps。
+        # @type BitRate: Integer
+
+        attr_accessor :SampleRate, :Channel, :BitRate
+
+        def initialize(samplerate=nil, channel=nil, bitrate=nil)
+          @SampleRate = samplerate
+          @Channel = channel
+          @BitRate = bitrate
+        end
+
+        def deserialize(params)
+          @SampleRate = params['SampleRate']
+          @Channel = params['Channel']
+          @BitRate = params['BitRate']
+        end
+      end
+
       # 录制音频转码参数。
       class AudioParams < TencentCloud::Common::AbstractModel
         # @param SampleRate: 音频采样率枚举值:(注意1 代表48000HZ, 2 代表44100HZ, 3 代表16000HZ)
@@ -1023,6 +1047,49 @@ module TencentCloud
         end
       end
 
+      # DescribeStreamIngest请求参数结构体
+      class DescribeStreamIngestRequest < TencentCloud::Common::AbstractModel
+        # @param SdkAppId: TRTC的SDKAppId，和任务的房间所对应的SDKAppId相同
+        # @type SdkAppId: Integer
+        # @param TaskId: 任务的唯一Id，在启动任务成功后会返回。
+        # @type TaskId: String
+
+        attr_accessor :SdkAppId, :TaskId
+
+        def initialize(sdkappid=nil, taskid=nil)
+          @SdkAppId = sdkappid
+          @TaskId = taskid
+        end
+
+        def deserialize(params)
+          @SdkAppId = params['SdkAppId']
+          @TaskId = params['TaskId']
+        end
+      end
+
+      # DescribeStreamIngest返回参数结构体
+      class DescribeStreamIngestResponse < TencentCloud::Common::AbstractModel
+        # @param Status: 任务的状态信息。
+        # InProgress：表示当前任务正在进行中。
+        # NotExist：表示当前任务不存在。
+        # 示例值：InProgress
+        # @type Status: String
+        # @param RequestId: 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
+        # @type RequestId: String
+
+        attr_accessor :Status, :RequestId
+
+        def initialize(status=nil, requestid=nil)
+          @Status = status
+          @RequestId = requestid
+        end
+
+        def deserialize(params)
+          @Status = params['Status']
+          @RequestId = params['RequestId']
+        end
+      end
+
       # DescribeTRTCMarketQualityData请求参数结构体
       class DescribeTRTCMarketQualityDataRequest < TencentCloud::Common::AbstractModel
         # @param SdkAppId: 用户SdkAppId（如：1400xxxxxx）
@@ -3766,6 +3833,83 @@ module TencentCloud
         end
       end
 
+      # StartStreamIngest请求参数结构体
+      class StartStreamIngestRequest < TencentCloud::Common::AbstractModel
+        # @param SdkAppId: TRTC的[SdkAppId](https://cloud.tencent.com/document/product/647/46351#sdkappid)，和录制的房间所对应的SdkAppId相同。
+        # @type SdkAppId: Integer
+        # @param RoomId: TRTC的[RoomId](https://cloud.tencent.com/document/product/647/46351#roomid)，录制的TRTC房间所对应的RoomId。
+        # @type RoomId: String
+        # @param RoomIdType: TRTC房间号的类型。
+        # 【*注意】必须和录制的房间所对应的RoomId类型相同:
+        # 0: 字符串类型的RoomId
+        # 1: 32位整型的RoomId（默认）
+        # @type RoomIdType: Integer
+        # @param UserId: 拉流转推机器人的UserId，用于进房发起拉流转推任务。
+        # @type UserId: String
+        # @param UserSig: 拉流转推机器人UserId对应的校验签名，即UserId和UserSig相当于机器人进房的登录密码，具体计算方法请参考TRTC计算[UserSig](https://cloud.tencent.com/document/product/647/45910#UserSig)的方案。
+        # @type UserSig: String
+        # @param SourceUrl: 源流URL。示例值：https://a.b/test.mp4
+        # @type SourceUrl: Array
+        # @param PrivateMapKey: TRTC房间权限加密串，只有在TRTC控制台启用了高级权限控制的时候需要携带，在TRTC控制台如果开启高级权限控制后，TRTC 的后台服务系统会校验一个叫做 [PrivateMapKey] 的“权限票据”，权限票据中包含了一个加密后的 RoomId 和一个加密后的“权限位列表”。由于 PrivateMapKey 中包含 RoomId，所以只提供了 UserSig 没有提供 PrivateMapKey 时，并不能进入指定的房间。
+        # @type PrivateMapKey: String
+        # @param VideoEncodeParams: 视频编码参数。可选，如果不填，保持原始流的参数。
+        # @type VideoEncodeParams: :class:`Tencentcloud::Trtc.v20190722.models.VideoEncodeParams`
+        # @param AudioEncodeParams: 音频编码参数。可选，如果不填，保持原始流的参数。
+        # @type AudioEncodeParams: :class:`Tencentcloud::Trtc.v20190722.models.AudioEncodeParams`
+
+        attr_accessor :SdkAppId, :RoomId, :RoomIdType, :UserId, :UserSig, :SourceUrl, :PrivateMapKey, :VideoEncodeParams, :AudioEncodeParams
+
+        def initialize(sdkappid=nil, roomid=nil, roomidtype=nil, userid=nil, usersig=nil, sourceurl=nil, privatemapkey=nil, videoencodeparams=nil, audioencodeparams=nil)
+          @SdkAppId = sdkappid
+          @RoomId = roomid
+          @RoomIdType = roomidtype
+          @UserId = userid
+          @UserSig = usersig
+          @SourceUrl = sourceurl
+          @PrivateMapKey = privatemapkey
+          @VideoEncodeParams = videoencodeparams
+          @AudioEncodeParams = audioencodeparams
+        end
+
+        def deserialize(params)
+          @SdkAppId = params['SdkAppId']
+          @RoomId = params['RoomId']
+          @RoomIdType = params['RoomIdType']
+          @UserId = params['UserId']
+          @UserSig = params['UserSig']
+          @SourceUrl = params['SourceUrl']
+          @PrivateMapKey = params['PrivateMapKey']
+          unless params['VideoEncodeParams'].nil?
+            @VideoEncodeParams = VideoEncodeParams.new
+            @VideoEncodeParams.deserialize(params['VideoEncodeParams'])
+          end
+          unless params['AudioEncodeParams'].nil?
+            @AudioEncodeParams = AudioEncodeParams.new
+            @AudioEncodeParams.deserialize(params['AudioEncodeParams'])
+          end
+        end
+      end
+
+      # StartStreamIngest返回参数结构体
+      class StartStreamIngestResponse < TencentCloud::Common::AbstractModel
+        # @param TaskId: 拉流转推的任务 ID。任务 ID 是对一次拉流转推生命周期过程的唯一标识，结束任务时会失去意义。任务 ID 需要业务保存下来，作为下次针对这个任务操作的参数。
+        # @type TaskId: String
+        # @param RequestId: 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
+        # @type RequestId: String
+
+        attr_accessor :TaskId, :RequestId
+
+        def initialize(taskid=nil, requestid=nil)
+          @TaskId = taskid
+          @RequestId = requestid
+        end
+
+        def deserialize(params)
+          @TaskId = params['TaskId']
+          @RequestId = params['RequestId']
+        end
+      end
+
       # StopMCUMixTranscodeByStrRoomId请求参数结构体
       class StopMCUMixTranscodeByStrRoomIdRequest < TencentCloud::Common::AbstractModel
         # @param SdkAppId: TRTC的SDKAppId。
@@ -3878,6 +4022,42 @@ module TencentCloud
         end
       end
 
+      # StopStreamIngest请求参数结构体
+      class StopStreamIngestRequest < TencentCloud::Common::AbstractModel
+        # @param SdkAppId: TRTC的SDKAppId，和任务的房间所对应的SDKAppId相同。
+        # @type SdkAppId: Integer
+        # @param TaskId: 任务的唯一Id，在启动任务成功后会返回。
+        # @type TaskId: String
+
+        attr_accessor :SdkAppId, :TaskId
+
+        def initialize(sdkappid=nil, taskid=nil)
+          @SdkAppId = sdkappid
+          @TaskId = taskid
+        end
+
+        def deserialize(params)
+          @SdkAppId = params['SdkAppId']
+          @TaskId = params['TaskId']
+        end
+      end
+
+      # StopStreamIngest返回参数结构体
+      class StopStreamIngestResponse < TencentCloud::Common::AbstractModel
+        # @param RequestId: 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
+        # @type RequestId: String
+
+        attr_accessor :RequestId
+
+        def initialize(requestid=nil)
+          @RequestId = requestid
+        end
+
+        def deserialize(params)
+          @RequestId = params['RequestId']
+        end
+      end
+
       # 云端录制查询接口，录制文件的信息
       class StorageFile < TencentCloud::Common::AbstractModel
         # @param UserId: 录制文件对应的UserId，如果是混流的话的这里返回的是空串。
@@ -4320,6 +4500,38 @@ module TencentCloud
         end
       end
 
+      # 视频转码参数
+      class VideoEncodeParams < TencentCloud::Common::AbstractModel
+        # @param Width: 宽。取值范围[0,1920]，单位为像素值。
+        # @type Width: Integer
+        # @param Height: 高。取值范围[0,1080]，单位为像素值。
+        # @type Height: Integer
+        # @param Fps: 帧率。取值范围[1,60]，表示帧率可选范围为1到60fps。
+        # @type Fps: Integer
+        # @param BitRate: 码率。取值范围[1,10000]，单位为kbps。
+        # @type BitRate: Integer
+        # @param Gop: gop。取值范围[1,2]，单位为秒。
+        # @type Gop: Integer
+
+        attr_accessor :Width, :Height, :Fps, :BitRate, :Gop
+
+        def initialize(width=nil, height=nil, fps=nil, bitrate=nil, gop=nil)
+          @Width = width
+          @Height = height
+          @Fps = fps
+          @BitRate = bitrate
+          @Gop = gop
+        end
+
+        def deserialize(params)
+          @Width = params['Width']
+          @Height = params['Height']
+          @Fps = params['Fps']
+          @BitRate = params['BitRate']
+          @Gop = params['Gop']
+        end
+      end
+
       # 录制视频转码参数。
       class VideoParams < TencentCloud::Common::AbstractModel
         # @param Width: 视频的宽度值，单位为像素，默认值360。不能超过1920，与height的乘积不能超过1920*1080。

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tencentcloud-sdk-trtc
 version: !ruby/object:Gem::Version
-  version: 3.0.711
+  version: 3.0.712
 platform: ruby
 authors:
 - Tencent Cloud
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-11-23 00:00:00.000000000 Z
+date: 2023-11-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: tencentcloud-sdk-common