Tous les produits
Search
Centre de documentation

ApsaraVideo Live:Utiliser le SDK serveur pour Python

Dernière mise à jour :Aug 19, 2026

Cette rubrique explique comment utiliser le SDK serveur pour Python fourni par ApsaraVideo Live et fournit des exemples de code. Elle s'appuie sur l'opération API d'interrogation des studios de production pour illustrer l'appel d'une opération API ApsaraVideo Live.

Prérequis

  • Python 2.7 ou une version ultérieure est installé.

  • Le SDK serveur pour Python est téléchargé. Pour plus d'informations, consultez Téléchargement du SDK.

Procédure

  1. Installez les SDK.

    1. Installez le SDK Core Alibaba Cloud.

      sudo pip install aliyun-python-sdk-core

    2. Installez le SDK ApsaraVideo Live.

      sudo pip install aliyun-python-sdk-live

  2. Mettez à jour les SDK.

    1. Mettez à jour le SDK Core Alibaba Cloud.

      sudo pip install aliyun-python-sdk-core --upgrade

    2. Mettez à jour le SDK ApsaraVideo Live.

      sudo pip install aliyun-python-sdk-live --upgrade

  3. Utilisez le SDK serveur pour Python.

    1. Consultez la description du fichier. Dans cet exemple, le fichier DescribeCastersRequest.py du SDK est utilisé.

      # Licensed to the Apache Software Foundation (ASF) under one
      # or more contributor license agreements.  See the NOTICE file
      # distributed with this work for additional information
      # regarding copyright ownership.  The ASF licenses this file
      # to you under the Apache License, Version 2.0 (the
      # "License"); you may not use this file except in compliance
      # with the License.  You may obtain a copy of the License at
      #
      #
      #     http://www.apache.org/licenses/LICENSE-2.0
      #
      #
      # Unless required by applicable law or agreed to in writing,
      # software distributed under the License is distributed on an
      # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
      # KIND, either express or implied.  See the License for the
      # specific language governing permissions and limitations
      # under the License.
      
      from aliyunsdkcore.request import RpcRequest
      from aliyunsdklive.endpoint import endpoint_data
      
      class DescribeCastersRequest(RpcRequest):
      
          def __init__(self):
              RpcRequest.__init__(self, 'live', '2016-11-01', 'DescribeCasters','live')
              self.set_method('POST')
      
              if hasattr(self, "endpoint_map"):
                  setattr(self, "endpoint_map", endpoint_data.getEndpointMap())
              if hasattr(self, "endpoint_regional"):
                  setattr(self, "endpoint_regional", endpoint_data.getEndpointRegional())
      
          def get_StartTime(self): # String
              return self.get_query_params().get('StartTime')
      
          def set_StartTime(self, StartTime):  # String
              self.add_query_param('StartTime', StartTime)
          def get_PageNum(self): # Integer
              return self.get_query_params().get('PageNum')
      
          def set_PageNum(self, PageNum):  # Integer
              self.add_query_param('PageNum', PageNum)
          def get_CasterName(self): # String
              return self.get_query_params().get('CasterName')
      
          def set_CasterName(self, CasterName):  # String
              self.add_query_param('CasterName', CasterName)
          def get_PageSize(self): # Integer
              return self.get_query_params().get('PageSize')
      
          def set_PageSize(self, PageSize):  # Integer
              self.add_query_param('PageSize', PageSize)
          def get_NormType(self): # String
              return self.get_query_params().get('NormType')
      
          def set_NormType(self, NormType):  # String
              self.add_query_param('NormType', NormType)
          def get_CasterId(self): # String
              return self.get_query_params().get('CasterId')
      
          def set_CasterId(self, CasterId):  # String
              self.add_query_param('CasterId', CasterId)
          def get_EndTime(self): # String
              return self.get_query_params().get('EndTime')
      
          def set_EndTime(self, EndTime):  # String
              self.add_query_param('EndTime', EndTime)
          def get_OwnerId(self): # Long
              return self.get_query_params().get('OwnerId')
      
          def set_OwnerId(self, OwnerId):  # Long
              self.add_query_param('OwnerId', OwnerId)
          def get_OrderByModifyAsc(self): # String
              return self.get_query_params().get('OrderByModifyAsc')
      
          def set_OrderByModifyAsc(self, OrderByModifyAsc):  # String
              self.add_query_param('OrderByModifyAsc', OrderByModifyAsc)
          def get_ChargeType(self): # Integer
              return self.get_query_params().get('ChargeType')
      
              def set_ChargeType(self, ChargeType):  # Integer
              self.add_query_param('ChargeType', ChargeType)
              def get_Status(self): # Integer
              return self.get_query_params().get('Status')
      
              def set_Status(self, Status):  # Integer
              self.add_query_param('Status', Status)
                                  

      La classe DescribeCastersRequest du fichier contient plusieurs paires de méthodes get_X et set_X, qui servent respectivement à récupérer et à définir les paramètres d'une requête API.

    2. Créez un fichier de configuration nommé config.ini et placez-le dans le répertoire conf. Incluez votre ID AccessKey et votre secret AccessKey dans le fichier de configuration. Exemple :

      [default]
      access_key_id = YOUR_ACCESS_KEY_ID
      access_key_secret = YOUR_ACCESS_KEY_SECRET

      Remplacez YOUR_ACCESS_KEY_ID et YOUR_ACCESS_KEY_SECRET par votre ID AccessKey et votre secret AccessKey réels.

      Vous pouvez ensuite utiliser le code Python suivant pour lire le fichier de configuration et appeler le SDK.

      L'exemple de code ci-dessous utilise l'opération DescribeCasters de la version v20161101 du SDK :

      #!/usr/bin/env python
      #coding=utf-8
      
      from configparser import ConfigParser
      from aliyunsdkcore.client import AcsClient
      from aliyunsdkcore.acs_exception.exceptions import ClientException
      from aliyunsdkcore.acs_exception.exceptions import ServerException
      from aliyunsdkcore.auth.credentials import AccessKeyCredential
      from aliyunsdkcore.auth.credentials import StsTokenCredential
      from aliyunsdklive.request.v20161101.DescribeCastersRequest import DescribeCastersRequest
      
      config = ConfigParser()
      config.read('conf/config.ini')
      
      # The AccessKey pair of an Alibaba Cloud account has access permissions on all API operations. We recommend that you use the AccessKey pair of a RAM user to call API operations or perform routine O&M. 
      # We recommend that you not save your AccessKey pair (AccessKey ID and AccessKey secret) in your project code. Otherwise, the AccessKey pair may be leaked and the security of all resources within your account may be compromised. 
      # In this example, the AccessKey pair is obtained from the configuration file to authenticate API accesses. 
      access_key_id = config.get('default', 'access_key_id')
      access_key_secret = config.get('default', 'access_key_secret')
      # Initialize the client.
      # Use the AccessKey ID and AccessKey secret of your Alibaba Cloud account. You can obtain them in the Alibaba Cloud Management Console.
      # Set the region to cn-hangzhou in this example.
      credentials = AccessKeyCredential(access_key_id, access_key_secret)
      # use STS Token
      # credentials = StsTokenCredential('<your-access-key-id>', '<your-access-key-secret>', '<your-sts-token>')
      client = AcsClient(region_id='cn-hangzhou', credential=credentials)
      # Construct an API request.
      request = DescribeCastersRequest()
      request.set_accept_format('json')
      
      request.set_CasterId("testCase")
      request.set_CasterName("testName")
      request.set_StartTime("2020-01-01T12:00:01Z")
      # Send the request.
      response = client.do_action_with_exception(request)
      # python2:  print(response)
      # Obtain the result.
      print(str(response, encoding='utf-8'))

Étapes suivantes

Pour désinstaller les SDK concernés, exécutez les commandes suivantes :

  • sudo pip uninstall aliyun-python-sdk-core

  • sudo pip uninstall aliyun-python-sdk-live