Skip to main content
Este inicio rápido le muestra cómo crear una tarea que se ejecuta según una programación. Hay muchas rutinas de operación del juego que se pueden automatizar mediante una tarea programada, como:
  • Modificar los precios de una tienda según la hora del día.
  • Actualizar los datos del título para reflejar los cambios de un evento actual.
  • Inyectar monedas virtuales en la economía del juego a diario, etc.
En el ejemplo usado en este inicio rápido, le mostraremos cómo modificar una variable del juego llamada rareDropRate en los datos del título a las 12:00 UTC, y solo los días de fin de semana.

Paso 1: preparar el CloudScript

En Game Manager:
  • Seleccione Automation en el menú de la izquierda.
  • En la pestaña CloudScript Revisions, agregue una nueva función de CloudScript llamada adjustRareDropRate con una llamada sencilla a la API SetTitleData, como se muestra en el fragmento de código y en la imagen siguientes.
Para los más observadores, no se preocupe: hay un error ahí a propósito. Asegúrese de implementar la nueva revisión para que esté activa en su juego.
Puede obtener más información sobre el uso de CloudScript en nuestro inicio rápido de CloudScript y en la documentación del método ExecuteCloudScript.

Paso 2: crear una tarea programada

Ahora seleccione Servers en el menú de la izquierda.
  • Vaya a la pestaña Scheduled Tasks.
  • Seleccione New Scheduled Task en la esquina superior derecha de la pantalla.
  • Esto abrirá la vista Create Task.
  • En el campo Type of task, elija Run a CloudScript function.
  • Debajo, podrá elegir una función de la revisión de CloudScript implementada actualmente y especificar los argumentos que se pasarán.
  • Elija el controlador adjustRareDropRate que escribió en el paso anterior.
Para establecer la programación de esta tarea:
  • Seleccione On a schedule (UTC) bajo el encabezado SCHEDULE.
  • Un sencillo generador de programaciones le permite elegir cuándo debe ejecutarse la tarea (cada hora, día, semana, etc.).
  • Para este ejemplo, queremos una programación avanzada, donde podamos especificar qué días de la semana ejecutar la tarea.
  • Así que seleccione CRON EXPRESSION.
La expresión cron, altamente personalizable, le permite crear una programación muy compleja, aunque es importante tener en cuenta que actualmente solo permitimos programaciones cuyas repeticiones se produzcan en marcas de 5 minutos de la hora. Por ejemplo, puede especificar que una tarea se ejecute en el minuto 5, 10, 25 o 50 de la hora, pero no puede especificar que una tarea se ejecute en el minuto 3, 11 o 46 de la hora. Si quiere obtener más información sobre las expresiones cron, crontab.guru proporciona información detallada y un generador de expresiones interactivo. En este caso, queremos que la tarea se ejecute a las 12:00 UTC los sábados y domingos, lo que sería 00 12 * * 0,6 (cero minutos después de las doce, cada domingo y sábado). Por último, asegúrese de guardar la nueva tarea antes de continuar con el paso siguiente.

Paso 3: probar la tarea

En la vista Tasks (Servers -> Tasks), podemos ver que la próxima ejecución de la tarea recién creada es el sábado siguiente, como se esperaba. Por lo tanto, si actualmente es martes, la próxima ejecución programada sería dentro de 4 días. Para probar la tarea ahora, seleccione la tarea Adjust rare drop rate y elija RUN TASKS.

Paso 4: comprobar los resultados de la ejecución de prueba

Lamentablemente, la ejecución de la tarea ha fallado. Seleccione la instancia de la tarea para ver qué salió mal. La vista Task Instance Details proporciona información de diagnóstico sobre por qué falló la tarea. En este caso, indica que la llamada a serverAPI.SetTitleData es incorrecta. Realmente debería ser server.SetTitleData (para obtener una explicación, consulte la sección Intermediate: Calling the Server APIs del tutorial Escritura de CloudScript personalizado). También hay otra información importante en la vista Task Instance Details, como las horas de inicio y finalización, la función a la que se llamó, los argumentos pasados, el resultado completo de la ejecución de CloudScript y mucho más.

Paso 5: probar de nuevo (correctamente)

Continúe y corrija el error que encontramos en el paso 4. El fragmento de código correcto se muestra a continuación.
Y ahora, repitiendo el paso 3, su ejecución de prueba final es correcta. Para confirmar el éxito:
  • Seleccione Content en el menú de la izquierda.
  • Vaya a la pestaña Title Data.
  • Compruebe que la entrada de Title Data se estableció realmente.
Última modificación el 28 de agosto de 2026