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 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.
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:
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.
