tencentcloud-sdk-live 1.0.234 → 1.0.235

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 591c2b8cf6604146fce4ba2b7762f4e16591b36a
-  data.tar.gz: 75a68554ecc28700f769fade2f4ee636a927d040
+  metadata.gz: edf54a7b3c865b7f760f9d23f781ac3337d12009
+  data.tar.gz: fb671ebc2f8489682b76661aef9424bc2d0e8864
 SHA512:
-  metadata.gz: eb1c3dc772d58f0aa96b34c2b79673a619c5961f6b3381ed7d34ed2a0a10c1c21433c00bc856df9fe1f02ffa996f835d2092d0585afa3d3a6546bbb501957ff3
-  data.tar.gz: 3c9ae0b1db8780bc7c7104ccb52455881424b79f64fce0ece295bf5291302d29afbbcff3dc78b4dd482392c8d328c7d2995af51494b2fe472509bc80aa8c722e
+  metadata.gz: 0abe9cfdd1949a7abcde1329f554ada63c6cfe7047f0f864410fb91e517522398c76beef8d86b90d3cacb8199a699e24a4c31374bbc88718e9d29ae2da36ef2e
+  data.tar.gz: c548da466a15f98087523073eb813969a9b50890f47973f11f016a4a4fd5fd55084416781094e69e2b17c6698baeee5bb63dfdd70758bf142a8263a2dca6d621

data/lib/VERSION

@@ -1 +1 @@
-1.0.234
+1.0.235

data/lib/v20180801/client.rb

@@ -1780,14 +1780,15 @@ module TencentCloud
         end
 
         # 返回直播中、无推流或者禁播等状态。
-        # 注意：该接口仅提供辅助查询流状态功能，业务重要场景不要强依赖该接口！
 
         # 使用建议：
-        # 1. 去除将该接口的返回结果作为开播、关播等重要业务场景的依赖。
-        # 2. 如业务需要该状态,可通过[推断流事件通知](/document/product/267/47025)进行存储维护直播间状态。
-        # 3. 自行维护的直播间状态,可通过定时(>1 min)[查询直播中的流接口](/document/product/267/20472),进行状态校准。
-        # 4. 如使用了流状态查询接口查询到流不活跃,可通过上述多种方案综合判定流状态。
-        # 5. 接口查询时,如发生访问异常或解析异常等,可默认为活跃,减少对业务影响。
+        # 该接口提供实时流状态查询功能，鉴于网络抖动等一些不可抗因素，使用该接口作为判断主播是否开播等重要业务场景时，请参考以下使用建议。
+        # 1. 优先使用业务自身的房间开关播逻辑，判断主播是否在线，譬如客户端开播信令和主播在线心跳等。
+        # 2. 对于没有房间管理的直播场景，可以结合以下方案综合判断。
+        # 2.1 根据[推断流事件通知](/document/product/267/20388) 判断主播在线状态。
+        # 2.2 通过定时（间隔>1min）查询[直播中的流接口](/document/api/267/20472)，判断主播是否在线。
+        # 2.3 通过 本接口 查询直播流状态，判断主播是否在线。
+        # 2.4 以上任一方式判断为在线，都认为主播开播中，并且接口查询超时或解析异常时，也默认为在线，减少对业务的影响。
 
         # @param request: Request instance for DescribeLiveStreamState.
         # @type request: :class:`Tencentcloud::live::V20180801::DescribeLiveStreamStateRequest`

data/lib/v20180801/models.rb

@@ -2741,16 +2741,28 @@ module TencentCloud
         # @type Granularity: Integer
         # @param ServiceName: 服务名称，可选值包括LVB(标准直播)，LEB(快直播)，不填则查LVB+LEB总值。
         # @type ServiceName: String
-
-        attr_accessor :StartTime, :EndTime, :PlayDomains, :MainlandOrOversea, :Granularity, :ServiceName
-        
-        def initialize(starttime=nil, endtime=nil, playdomains=nil, mainlandoroversea=nil, granularity=nil, servicename=nil)
+        # @param RegionNames: 大区，映射表如下：
+        # China Mainland 中国大陆
+        # Asia Pacific I 亚太一区
+        # Asia Pacific II 亚太二区
+        # Asia Pacific III 亚太三区
+        # Europe 欧洲
+        # North America 北美
+        # South America 南美
+        # Middle East 中东
+        # Africa 非洲。
+        # @type RegionNames: Array
+
+        attr_accessor :StartTime, :EndTime, :PlayDomains, :MainlandOrOversea, :Granularity, :ServiceName, :RegionNames
+        
+        def initialize(starttime=nil, endtime=nil, playdomains=nil, mainlandoroversea=nil, granularity=nil, servicename=nil, regionnames=nil)
           @StartTime = starttime
           @EndTime = endtime
           @PlayDomains = playdomains
           @MainlandOrOversea = mainlandoroversea
           @Granularity = granularity
           @ServiceName = servicename
+          @RegionNames = regionnames
         end
 
         def deserialize(params)
@@ -2760,6 +2772,7 @@ module TencentCloud
           @MainlandOrOversea = params['MainlandOrOversea']
           @Granularity = params['Granularity']
           @ServiceName = params['ServiceName']
+          @RegionNames = params['RegionNames']
         end
       end
 
@@ -5496,15 +5509,27 @@ module TencentCloud
         # 1440：天粒度（跨度不支持超过一个月）。
         # 默认值：5。
         # @type Granularity: Integer
-
-        attr_accessor :StartTime, :EndTime, :PushDomains, :MainlandOrOversea, :Granularity
-        
-        def initialize(starttime=nil, endtime=nil, pushdomains=nil, mainlandoroversea=nil, granularity=nil)
+        # @param RegionNames: 大区，映射表如下：
+        # China Mainland 中国大陆
+        # Asia Pacific I 亚太一区
+        # Asia Pacific II 亚太二区
+        # Asia Pacific III 亚太三区
+        # Europe 欧洲
+        # North America 北美
+        # South America 南美
+        # Middle East 中东
+        # Africa 非洲。
+        # @type RegionNames: Array
+
+        attr_accessor :StartTime, :EndTime, :PushDomains, :MainlandOrOversea, :Granularity, :RegionNames
+        
+        def initialize(starttime=nil, endtime=nil, pushdomains=nil, mainlandoroversea=nil, granularity=nil, regionnames=nil)
           @StartTime = starttime
           @EndTime = endtime
           @PushDomains = pushdomains
           @MainlandOrOversea = mainlandoroversea
           @Granularity = granularity
+          @RegionNames = regionnames
         end
 
         def deserialize(params)
@@ -5513,6 +5538,7 @@ module TencentCloud
           @PushDomains = params['PushDomains']
           @MainlandOrOversea = params['MainlandOrOversea']
           @Granularity = params['Granularity']
+          @RegionNames = params['RegionNames']
         end
       end
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tencentcloud-sdk-live
 version: !ruby/object:Gem::Version
-  version: 1.0.234
+  version: 1.0.235
 platform: ruby
 authors:
 - Tencent Cloud
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-12-30 00:00:00.000000000 Z
+date: 2022-01-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: tencentcloud-sdk-common