All Products
Search
Document Center

ApsaraVideo VOD:Fungsi lainnya

Last Updated:Nov 07, 2026

Halaman ini menjelaskan fungsi utilitas yang tersedia di EdgeScript, meliputi encoding dan decoding, pembuatan bilangan acak, checksum, konversi tipe, dan pembuatan unique identifier.

Encoding dan decoding Base64

EdgeScript menyediakan dua varian Base64: Base64 standar (base64_enc / base64_dec) dan Base64 aman URL (base64_enc_safe / base64_dec_safe). Gunakan varian standar untuk encoding umum, dan gunakan varian aman URL jika string hasil encode akan digunakan dalam URL atau HTTP header.

base64_enc

Melakukan encode pada string menggunakan encoding Base64 standar.

Sintaksis

base64_enc(s [, no_padding])

Parameter

Parameter

Deskripsi

s

String yang akan di-encode.

no_padding

Menentukan apakah karakter padding akan dihilangkan. Atur ke true untuk menghapus karakter = di akhir string. Default: false.

Nilai kembali

Mengembalikan string yang telah di-encode dengan Base64.

Contoh

if $http_data {
 encdata = base64_enc($http_data)
 say(concat('base64_encdata=', encdata))
}

Request header: data: aGVsbG8sIGRzbA==

Output:

base64_decdata=hello, dsl
base64_encdata=aGVsbG8sIGRzbA==

base64_dec

Melakukan decode pada string yang di-encode dengan Base64.

Sintaksis

base64_dec(s)

Parameter

Parameter

Deskripsi

s

String yang di-encode dengan Base64 yang akan di-decode.

Nilai kembali

Mengembalikan string mentah hasil decode.

Contoh

if $http_data {
  decdata = base64_dec($http_data)
  say(concat('base64_decdata=', decdata))
  say(concat('base64_encdata=', base64_enc('hello, dsl')))
}

Request header: data: aGVsbG8sIGRzbA==

Output:

base64_decdata=hello, dsl
base64_encdata=aGVsbG8sIGRzbA==

base64_enc_safe

Melakukan encode pada string menggunakan encoding Base64 aman URL. Pada output, karakter + diganti dengan -, / diganti dengan _, dan karakter padding = dihapus.

Sintaksis

base64_enc_safe(str)

Parameter

Parameter

Deskripsi

str

String yang akan di-encode.

Nilai kembali

Mengembalikan string yang di-encode dengan Base64 aman URL.

Contoh

add_rsp_header('X-RESPOND-OUTPUT', concat('base64_enc_safe=', base64_enc_safe('hello, dsl')), true)

Response header:

X-RESPOND-OUTPUT: base64_enc_safe=aGVsbG8sIGRzbA

base64_dec_safe

Melakukan decode pada string yang di-encode dengan Base64 aman URL. Sebelum proses decode, karakter - diganti dengan + dan _ diganti dengan /. Karakter padding (=) ditambahkan sesuai kebutuhan agar panjang string menjadi kelipatan empat.

Sintaksis

base64_dec_safe(str)

Parameter

Parameter

Deskripsi

str

String yang di-encode dengan Base64 yang aman untuk URL yang akan di-decode.

Nilai kembali

Mengembalikan string mentah hasil decode.

Contoh

add_rsp_header('X-RESPOND-OUTPUT', concat('base64_dec_safe=', base64_dec_safe(base64_enc_safe('hello, dsl'))), true)

Response header:

X-RESPOND-OUTPUT: base64_dec_safe=hello, dsl

Encoding dan decoding URL

url_escape

Melakukan encode pada string menggunakan encoding URL (percent-encoding).

Sintaksis

url_escape(s)

Parameter

Parameter

Deskripsi

s

String yang akan di-encode.

Nilai kembali

Mengembalikan string yang telah di-encode dengan URL.

Contoh

raw = '/abc/123/ dd/file.m3u8'
esdata = url_escape(raw)
dsdata = url_unescape(esdata)
if eq(raw, dsdata) {
  say(concat('raw=', raw))
  say(concat('dsdata=', dsdata))
}

Output:

raw=/abc/123/ dd/file.m3u8
esdata=%2Fabc%2F123%2F%20dd%2Ffile.m3u8
dsdata=/abc/123/ dd/file.m3u8

url_unescape

Melakukan decode pada string yang di-encode dengan URL.

Sintaksis

url_unescape(s)

Parameter

Parameter

Deskripsi

s

String yang di-encode dengan URL yang akan di-decode.

Nilai kembali

Mengembalikan string mentah hasil decode.

Contoh

raw = '/abc/123/ dd/file.m3u8'
esdata = url_escape(raw)
dsdata = url_unescape(esdata)
if eq(raw, dsdata) {
  say(concat('raw=', raw))
  say(concat('dsdata=', dsdata))
}

Output:

raw=/abc/123/ dd/file.m3u8
esdata=%2Fabc%2F123%2F%20dd%2Ffile.m3u8
dsdata=/abc/123/ dd/file.m3u8

Pembuatan bilangan acak

randomseed

Menginisialisasi pembuat bilangan acak. Panggil fungsi ini sebelum rand untuk memastikan urutan bilangan acak yang berbeda pada setiap request.

Sintaksis

randomseed()

Parameter

Tidak ada.

Nilai kembali

Tidak ada.

Contoh

randomseed()
r = rand(1, 100)

rand

Mengembalikan bilangan acak dalam rentang yang ditentukan (inklusif).

Sintaksis

rand(n1, n2)

Parameter

Parameter

Deskripsi

n1

Batas bawah.

n2

Batas atas.

Nilai yang dikembalikan memenuhi kondisi n1 <= result <= n2.

Nilai kembali

Mengembalikan bilangan acak.

Contoh

r = rand(1, 100)

rand_hit

Mengembalikan true atau false berdasarkan probabilitas yang ditentukan. Gunakan fungsi ini untuk menerapkan pemisahan traffic berbasis persentase atau peluncuran fitur bertahap.

Sintaksis

rand_hit(ratio)

Parameter

Parameter

Deskripsi

ratio

Probabilitas untuk mengembalikan nilai true. Nilai yang valid: 0–100. Nilai 100 selalu mengembalikan true; nilai 0 selalu mengembalikan false.

Nilai kembali

Mengembalikan true atau false.

Contoh

rand_hit(80)

rand_bytes

Membuat string numerik acak dengan panjang yang ditentukan.

Sintaksis

rand_bytes(len)

Parameter

Parameter

Deskripsi

len

Panjang string numerik acak yang akan dibuat.

Nilai kembali

Mengembalikan string numerik acak yang telah dibuat.

Contoh

rand_bytes(16)

Checksum

crc

Menghitung nilai Cyclic Redundancy Check (CRC) untuk sebuah string.

Sintaksis

crc(s)

Parameter

Parameter

Deskripsi

s

String yang akan dihitung nilai CRC-nya.

Nilai kembali

Mengembalikan nilai CRC dari string input.

Contoh

crc('hello edgescript')

Konversi tipe

tonumber

Mengonversi string menjadi tipe numerik.

Sintaksis

tonumber(s [, base])

Parameter

Parameter

Deskripsi

s

String yang akan dikonversi.

base

Basis untuk konversi numerik. Nilai yang valid: 10 (desimal) dan 16 (heksadesimal). Default: 10.

Nilai kembali

Mengembalikan angka.

Contoh

n = tonumber('100')
say(concat('tonumber()=', n))

Output:

tonumber()=100

Unique identifier

uuid

Mengembalikan string UUID yang dibuat secara acak.

Sintaksis

uuid()

Parameter

Tidak ada.

Nilai kembali

Mengembalikan string UUID. Contoh: 16903a86-4173-4dea-842c-926c5860fe05.

Contoh

say(uuid())

Output:

16903a86-4173-4dea-842c-926c5860fe05