tencent cloud

Feedback

Frame Capture

Last updated: 2024-10-21 17:46:44
    StreamLive supports capturing images from live streams at fixed time intervals.

    Points of Attention

    The frame capture feature will incur fees with a unit price of 0.0176 USD per thousand images. For details, please refer to: StreamLive Billing Document.
    If you need to store the images in Tencent Cloud Object Storage (COS), please refer to the billable items in COS.
    If you need to output the images to a third-party storage service, we will charge relaying fees based on the actual usage. For details, please refer to:StreamLive Billing Document.
    The frame capture output group only supports one output.

    Prerequisites for Use

    You have activated the StreamLive service.

    Configuring Frame Capture

    1. Log in to StreamLive console, and enter the Output Group Setting page. For the output group, select the type as: FRAME CAPTURE.
    
    
    
    2. Fill in at least one output destination.
    If you need to output the images to Tencent Cloud Object Storage (COS), select the destination type as: Tencent Cloud COS.
    
    
    Configuration Item
    Description
    Storage path
    When selecting the storage path, the system will verify whether you have authorized StreamLive the read and write permissions on Tencent Cloud COS. Only after authorization can StreamLive read the storage path information and store images in COS.
    If you have already authorized StreamLive with read and write permissions on COS, you can directly click Select to choose the storage path.
    If you have not yet authorized StreamLive with read and write permissions on COS, after clicking Select , please follow the system prompts to complete the authorization and then choose the storage path.
    File Name
    The file name consists of two parts: base file name, file generation time.
    Base file name: Required, supports input of 1-32 characters including numbers, letters, underscores, and hyphens.
    File generation time: Supports both Unix and UTC (+0:00) formats, which can be set in the timestamp format.
    Timestamp format
    Supports both Unix and UTC (+0:00) formats.
    Note:
    Please ensure the storage path + file name is unique. If two frame capture outputs have the same storage path + file name and are generated simultaneously, the generated image files may overwrite each other.
    If you need to export images to AWS S3, choose the destination type as: Amazon S3.
    
    
    Configuration Item
    Description
    Subaccount
    In AWS Identity and Access Management (IAM), create a sub-account via 'Add users', grant the sub-account the corresponding S3 bucket permissions. Record the Access key ID and Secret access key, and enter them here as the secret ID and secret key. For details, refer to: Configure AWS Sub-account and Policy
    Output S3 Bucket
    S3 Region: Enter the region where the S3 bucket is located. Use the following format 'ap-southeast-1'.
    S3 bucket name.
    Output File Path
    Enter the folder directory path, starting and ending with /. For example: /output/. If not entered, the root directory of this S3 bucket will be used by default.
    File Name
    The file name consists of two parts: base file name, file generation time.
    Base file name: Required, supports input of 1-32 characters including numbers, letters, underscores, and hyphens.
    File generation time: Supports both Unix and UTC (+0:00) formats, which can be set in the timestamp format.
    Timestamp format
    Supports both Unix and UTC (+0:00) formats.
    3. Set the output name, supporting 1-32 letters, numbers, and underscores. Ensure the uniqueness of the output name under the Channel. Then, you can click Setting to set frame capture parameters. And please note, the frame capture output group only supports one output.
    
    
    
    4. Go to the Setting page for detailed parameters configuration.
    
    
    
    Configuration Item
    Description
    Name
    The following detailed parameters will be saved under this name. You can enter 1-20 characters consisting of letters and numbers.
    You can also reuse existing parameter template by clicking Copy above.
    Width,Height
    Enter the resolution of the output image, specifying width and height separately.
    If left blank or set to 0, the resolution will follow the source image.
    If a value is entered, it must be an even number between 0 and 3000.
    Capture Interval Units
    Currently, only SECONDS is supported.
    Capture Interval
    You can enter a positive integer between 1 and 3600, representing 1-3600 seconds.
    Scaling Behavior
    When there is a discrepancy between the source stream resolution and the set output resolution, you can define the image scaling behavior:
    DEFAULT: Insert black boxes around the image to provide the specified output resolution.
    STRETCH_TO_OUTPUT: Stretch the image to the specified output resolution.
    Sharpness
    Changes the strength of the anti-alias filter used for scaling. 0 is the softest setting, 100 is the sharpest. A setting of 50 is recommended for most content.
    5. Click Confirm to save the current configuration.

    Configure AWS Sub-account and Policy

    1. Create a policy

    1.1 Go to the AWS Console's Identity and Access Management (IAM) module, click Policies, and then click Create policy.
    
    
    
    1.2 Choose the JSON tab. For StreamLive to access the S3 bucket, only the PutObject permission needs to be granted. Fill the ARN of the S3 bucket into the Resource field in the JSON.
    Note:
    The S3 ARN information can be found in the Properties section of the corresponding AWS S3 bucket.
    In Resource of the JSON, make sure you attach /* to the S3 ARN. For example, if your S3 ARN is arn:aws:s3:::thebucketname, enter arn:aws:s3:::thebucketname/*.
    If you want to grant PutObject permission only to a specific bucket, you can refer to the following:
    { "Version": "2012-10-17", "Statement": [ { "Sid": "Statement1", "Effect": "Allow", "Action": [ "s3:PutObject" ], "Resource": [ "arn:aws:s3:::thebucketname/*" ] } ] }
    If you want to grant PutObject permission to all your S3 buckets, you can refer to the following:
    { "Version": "2012-10-17", "Statement": [ { "Sid": "Statement1", "Effect": "Allow", "Action": [ "s3:PutObject" ], "Resource": [ "*" ] } ] }
    1.3 Enter the Policy name and then click Create policy to complete creation.
    
    
    

    2. Create a sub-account and associate policy

    2.1. Go to the AWS Console's Identity and Access Management (IAM) module, click Users, and then click Add users to add a user.
    
    
    
    2.2. Enter User name and click Next.
    2.3. Click Attach existing policies directly, type in the search box the name of the policy you just created, and select the policy. Then continue to complete the creation of the sub-account.

    3. Obtain the sub-account's Access key ID and Secret access key

    3.1. Go to the sub-account details page, click Security credentials > Access keys > Create access key.
    
    
    
    3.2. Select Other and click Next. Note the Access key ID and Secret access key.
    
    
    
    
    
    Contact Us

    Contact our sales team or business advisors to help your business.

    Technical Support

    Open a ticket if you're looking for further assistance. Our Ticket is 7x24 avaliable.

    7x24 Phone Support