O [Guia de referência da API do AWS SDK para JavaScript V3](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/) descreve em detalhes todas as operações da API para o AWS SDK para JavaScript versão 3 (V3).
As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Uso de modelos de trabalho no MediaConvert
![\[JavaScript code example that applies to Node.js execution\]](http://docs.aws.amazon.com/pt_br/sdk-for-javascript/v3/developer-guide/images/nodeicon.png)
**Este exemplo de código Node.js mostra:**
+ Como criar modelos de tarefa do AWS Elemental MediaConvert.
+ Como usar um modelo de tarefa para criar uma tarefa de transcodificação.
+ Como listar todos os modelos de tarefa.
+ Como excluir modelos de tarefa.
## O cenário
O JSON necessário para criar um trabalho de transcodificação no MediaConvert é detalhado, contendo um grande número de configurações. Simplifique muito a criação de tarefas salvando as configurações em boas condições em um modelo de tarefa que você possa usar para criar tarefas subsequentes. Neste exemplo, você usa um módulo Node.js a fim de chamar o MediaConvert para criar, usar e gerenciar modelos de trabalho. O código usa o SDK para JavaScript para fazer isso usando estes métodos da classe de cliente do MediaConvert:
+ [https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-mediaconvert/Class/CreateJobTemplateCommand/](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-mediaconvert/Class/CreateJobTemplateCommand/)
+ [https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-mediaconvert/Class/CreateJobCommand/](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-mediaconvert/Class/CreateJobCommand/)
+ [https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-mediaconvert/Class/DeleteJobTemplateCommand/](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-mediaconvert/Class/DeleteJobTemplateCommand/)
+ [https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-mediaconvert/Class/ListJobTemplatesCommand/](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-mediaconvert/Class/ListJobTemplatesCommand/)
## Tarefas de pré-requisito
Para configurar e executar este exemplo, primeiro conclua estas tarefas:
+ Configure o ambiente do projeto para executar estes exemplos do Node TypeScript e instale os módulos do AWS SDK para JavaScript e de terceiros necessários. Siga as instruções no [ GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/master/javascriptv3/example_code/mediaconvert/README.md).
+ Crie um arquivo de configurações compartilhado com as credenciais de usuário. Para obter mais informações sobre como fornecer um arquivo de credenciais compartilhado, consulte [Arquivos de configuração e credenciais compartilhados](https://docs.aws.amazon.com/sdkref/latest/guide/file-format.html) no *Guia de referência de ferramentas e SDKs da AWS*.
+ Crie um perfil do IAM que dê ao MediaConvert acesso aos arquivos de entrada e aos buckets do Amazon S3 onde os arquivos de saída são armazenados. Para obter detalhes, consulte [Configurar permissões do IAM](https://docs.aws.amazon.com/mediaconvert/latest/ug/iam-role.html) no *Guia do usuário do AWS Elemental MediaConvert*.
**Importante**
Esses exemplos usam ECMAScript6 (ES6). Isso requer o Node.js versão 13.x ou superior. Para baixar e instalar a versão mais recente do Node.js, consulte [Downloads do Node.js](https://nodejs.org/en/download).
No entanto, se você preferir usar a sintaxe CommonJS, consulte [Sintaxe ES6/CommonJS de JavaScript](sdk-example-javascript-syntax.md).
## Criar um modelo de trabalho
Crie um módulo do Node.js com o nome de arquivo `emc_create_jobtemplate.js`. Certifique-se de configurar o SDK conforme mostrado anteriormente, incluindo a instalação dos clientes e pacotes necessários.
Especifique o JSON de parâmetros para a criação do modelo. Use a maioria dos parâmetros JSON de uma tarefa anterior bem-sucedida para especificar os valores `Settings` no modelo. Este exemplo usa as configurações de tarefa de [Criar e gerenciar tarefas de transcodificação no MediaConvert](emc-examples-jobs.md).
Chame o método `CreateJobTemplateCommand` criando uma promessa para invocar um objeto de serviço de cliente do `MediaConvert`, passando os parâmetros.
**nota**
Substitua *JOB\$1QUEUE\$1ARN* pelo Nome do recurso da Amazon (ARN) da fila de trabalhos a ser verificada e *BUCKET\$1NAME* pelo nome do bucket do Amazon S3 de destino. Por exemplo, "s3://BUCKET\$1NAME/".
```
// Import required AWS-SDK clients and commands for Node.js
import { CreateJobTemplateCommand } from "@aws-sdk/client-mediaconvert";
import { emcClient } from "./libs/emcClient.js";
const params = {
Category: "YouTube Jobs",
Description: "Final production transcode",
Name: "DemoTemplate",
Queue: "JOB_QUEUE_ARN", //JOB_QUEUE_ARN
Settings: {
OutputGroups: [
{
Name: "File Group",
OutputGroupSettings: {
Type: "FILE_GROUP_SETTINGS",
FileGroupSettings: {
Destination: "BUCKET_NAME", // BUCKET_NAME e.g., "s3://BUCKET_NAME/"
},
},
Outputs: [
{
VideoDescription: {
ScalingBehavior: "DEFAULT",
TimecodeInsertion: "DISABLED",
AntiAlias: "ENABLED",
Sharpness: 50,
CodecSettings: {
Codec: "H_264",
H264Settings: {
InterlaceMode: "PROGRESSIVE",
NumberReferenceFrames: 3,
Syntax: "DEFAULT",
Softness: 0,
GopClosedCadence: 1,
GopSize: 90,
Slices: 1,
GopBReference: "DISABLED",
SlowPal: "DISABLED",
SpatialAdaptiveQuantization: "ENABLED",
TemporalAdaptiveQuantization: "ENABLED",
FlickerAdaptiveQuantization: "DISABLED",
EntropyEncoding: "CABAC",
Bitrate: 5000000,
FramerateControl: "SPECIFIED",
RateControlMode: "CBR",
CodecProfile: "MAIN",
Telecine: "NONE",
MinIInterval: 0,
AdaptiveQuantization: "HIGH",
CodecLevel: "AUTO",
FieldEncoding: "PAFF",
SceneChangeDetect: "ENABLED",
QualityTuningLevel: "SINGLE_PASS",
FramerateConversionAlgorithm: "DUPLICATE_DROP",
UnregisteredSeiTimecode: "DISABLED",
GopSizeUnits: "FRAMES",
ParControl: "SPECIFIED",
NumberBFramesBetweenReferenceFrames: 2,
RepeatPps: "DISABLED",
FramerateNumerator: 30,
FramerateDenominator: 1,
ParNumerator: 1,
ParDenominator: 1,
},
},
AfdSignaling: "NONE",
DropFrameTimecode: "ENABLED",
RespondToAfd: "NONE",
ColorMetadata: "INSERT",
},
AudioDescriptions: [
{
AudioTypeControl: "FOLLOW_INPUT",
CodecSettings: {
Codec: "AAC",
AacSettings: {
AudioDescriptionBroadcasterMix: "NORMAL",
RateControlMode: "CBR",
CodecProfile: "LC",
CodingMode: "CODING_MODE_2_0",
RawFormat: "NONE",
SampleRate: 48000,
Specification: "MPEG4",
Bitrate: 64000,
},
},
LanguageCodeControl: "FOLLOW_INPUT",
AudioSourceName: "Audio Selector 1",
},
],
ContainerSettings: {
Container: "MP4",
Mp4Settings: {
CslgAtom: "INCLUDE",
FreeSpaceBox: "EXCLUDE",
MoovPlacement: "PROGRESSIVE_DOWNLOAD",
},
},
NameModifier: "_1",
},
],
},
],
AdAvailOffset: 0,
Inputs: [
{
AudioSelectors: {
"Audio Selector 1": {
Offset: 0,
DefaultSelection: "NOT_DEFAULT",
ProgramSelection: 1,
SelectorType: "TRACK",
Tracks: [1],
},
},
VideoSelector: {
ColorSpace: "FOLLOW",
},
FilterEnable: "AUTO",
PsiControl: "USE_PSI",
FilterStrength: 0,
DeblockFilter: "DISABLED",
DenoiseFilter: "DISABLED",
TimecodeSource: "EMBEDDED",
},
],
TimecodeConfig: {
Source: "EMBEDDED",
},
},
};
const run = async () => {
try {
// Create a promise on a MediaConvert object
const data = await emcClient.send(new CreateJobTemplateCommand(params));
console.log("Success!", data);
return data;
} catch (err) {
console.log("Error", err);
}
};
run();
```
Para executar o exemplo, digite o seguinte no prompt de comando.
```
node emc_create_jobtemplate.js
```
Esse código de exemplo pode ser encontrado [aqui no GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/blob/master/javascriptv3/example_code/mediaconvert/src/emc_create_jobtemplate.js).
## Criar um trabalho de transcodificação com base em um modelo de trabalho
Crie um módulo do Node.js com o nome de arquivo `emc_template_createjob.js`. Certifique-se de configurar o SDK conforme mostrado anteriormente, incluindo a instalação dos clientes e pacotes necessários.
Crie o JSON de parâmetros da criação de tarefas, inclusive o nome do modelo de tarefa a ser usado, e o `Settings` para usar os específicos da tarefa que você está criando. Depois, chame o método `CreateJobsCommand` criando uma promessa para invocar um objeto de serviço de cliente do `MediaConvert`, passando os parâmetros.
**nota**
Substitua *JOB\$1QUEUE\$1ARN* pelo nome do recurso da Amazon (ARN) da fila de trabalhos a ser verificada, *KEY\$1PAIR\$1NAME*, *TEMPLATE\$1NAME* e *ROLE\$1ARN* pelo nome do recurso da Amazon (ARN) da função e * INPUT\$1BUCKET\$1AND\$1FILENAME* pelo bucket de entrada e nome do arquivo. por exemplo, “s3://BUCKET\$1NAME/FILE\$1NAME”.
```
// Import required AWS-SDK clients and commands for Node.js
import { CreateJobCommand } from "@aws-sdk/client-mediaconvert";
import { emcClient } from "./libs/emcClient.js";
const params = {
Queue: "QUEUE_ARN", //QUEUE_ARN
JobTemplate: "TEMPLATE_NAME", //TEMPLATE_NAME
Role: "ROLE_ARN", //ROLE_ARN
Settings: {
Inputs: [
{
AudioSelectors: {
"Audio Selector 1": {
Offset: 0,
DefaultSelection: "NOT_DEFAULT",
ProgramSelection: 1,
SelectorType: "TRACK",
Tracks: [1],
},
},
VideoSelector: {
ColorSpace: "FOLLOW",
},
FilterEnable: "AUTO",
PsiControl: "USE_PSI",
FilterStrength: 0,
DeblockFilter: "DISABLED",
DenoiseFilter: "DISABLED",
TimecodeSource: "EMBEDDED",
FileInput: "INPUT_BUCKET_AND_FILENAME", //INPUT_BUCKET_AND_FILENAME, e.g., "s3://BUCKET_NAME/FILE_NAME"
},
],
},
};
const run = async () => {
try {
const data = await emcClient.send(new CreateJobCommand(params));
console.log("Success! ", data);
return data;
} catch (err) {
console.log("Error", err);
}
};
run();
```
Para executar o exemplo, digite o seguinte no prompt de comando.
```
node emc_template_createjob.js
```
Esse código de exemplo pode ser encontrado [aqui no GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/blob/master/javascriptv3/example_code/mediaconvert/src/emc_template_createjob.js).
## Como listar os modelos de trabalho
Crie um módulo do Node.js com o nome de arquivo `emc_listtemplates.js`. Certifique-se de configurar o SDK conforme mostrado anteriormente, incluindo a instalação dos clientes e pacotes necessários.
Crie um objeto para passar os parâmetros de solicitação para o método `listTemplates` da classe de cliente `MediaConvert`. Inclua valores para determinar quais modelos listar (`NAME`, `CREATION DATE`, `SYSTEM`), quantas listar e a ordem de classificação. Para chamar o método `ListTemplatesCommand`, crie uma promessa para invocar um objeto de serviço de cliente do MediaConvert, passando os parâmetros.
```
// Import required AWS-SDK clients and commands for Node.js
import { ListJobTemplatesCommand } from "@aws-sdk/client-mediaconvert";
import { emcClient } from "./libs/emcClient.js";
const params = {
ListBy: "NAME",
MaxResults: 10,
Order: "ASCENDING",
};
const run = async () => {
try {
const data = await emcClient.send(new ListJobTemplatesCommand(params));
console.log("Success ", data.JobTemplates);
return data;
} catch (err) {
console.log("Error", err);
}
};
run();
```
Para executar o exemplo, digite o seguinte no prompt de comando.
```
node emc_listtemplates.js
```
Esse código de exemplo pode ser encontrado [aqui no GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/blob/master/javascriptv3/example_code/mediaconvert/src/emc_template_createjob.js).
## Excluir um modelo de trabalho
Crie um módulo do Node.js com o nome de arquivo `emc_deletetemplate.js`. Certifique-se de configurar o SDK conforme mostrado anteriormente, incluindo a instalação dos clientes e pacotes necessários.
Crie um objeto para passar o nome do modelo de tarefa que você deseja excluir como parâmetro do método `DeleteJobTemplateCommand` da classe de cliente `MediaConvert`. Para chamar o método `DeleteJobTemplateCommand`, crie uma promessa para invocar um objeto de serviço de cliente do MediaConvert, passando os parâmetros.
```
// Import required AWS-SDK clients and commands for Node.js
import { DeleteJobTemplateCommand } from "@aws-sdk/client-mediaconvert";
import { emcClient } from "./libs/emcClient.js";
// Set the parameters
const params = { Name: "test" }; //TEMPLATE_NAME
const run = async () => {
try {
const data = await emcClient.send(new DeleteJobTemplateCommand(params));
console.log(
"Success, template deleted! Request ID:",
data.$metadata.requestId,
);
return data;
} catch (err) {
console.log("Error", err);
}
};
run();
```
Para executar o exemplo, digite o seguinte no prompt de comando.
```
node emc_deletetemplate.js
```
Esse código de exemplo pode ser encontrado [aqui no GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/blob/master/javascriptv3/example_code/mediaconvert/src/emc_deletetemplate.js).