Skip to main content

SSML dan LaTeX

Gunakan SSML untuk mengatur karakteristik suara seperti kecepatan, nada, dan volume, serta LaTeX untuk membaca rumus dalam bahasa Mandarin. Pelajari batasan, contoh API, tag, dan simbol yang didukung.

Pengenalan fitur

SSML adalah bahasa markup sintesis ucapan berbasis XML. SSML mengatur karakteristik suara seperti jenis suara, kecepatan, nada, dan volume, mengontrol jeda, menentukan pelafalan dan cara baca, serta menambahkan musik latar dan efek suara. Fitur LaTeX CosyVoice mengubah rumus matematika dalam teks menjadi ucapan bahasa Mandarin. Gunakan fitur ini untuk buku audio, pengumuman layanan pelanggan, pelafalan multibahasa, dan pendidikan daring. Model, suara, dan API untuk setiap fitur dijelaskan di bawah. Untuk memilih model, lihat Sintesis ucapan.

Batasan penggunaan

  • SSML
  • LaTeX
  • Model yang didukung: qwen-audio-3.1-tts-plus, qwen-audio-3.1-tts-flash, qwen-audio-3.0-tts-flash, qwen-audio-3.0-tts-plus, cosyvoice-v3.5-flash, cosyvoice-v3.5-plus, cosyvoice-v3-flash, cosyvoice-v3-plus, cosyvoice-v2
  • Suara: Hanya suara hasil kloning dan suara sistem yang ditandai mendukung SSML dalam daftar suara Qwen-Audio-TTS atau daftar suara CosyVoice yang didukung.
  • API:
    • Java SDK (versi 2.20.3 atau lebih baru): panggilan non-streaming dan streaming unidireksional
    • Python SDK (versi 2.0.1 atau lebih baru): panggilan non-streaming dan streaming unidireksional
    • WebSocket API: atur parameter enable_ssml ke true, dan kirim satu event continue-task

Penggunaan

  • SSML
  • LaTeX
Saat menggunakan SSML, ikuti aturan berikut:
  • Apit seluruh teks dengan <speak></speak>. Beberapa elemen <speak> dapat digunakan berurutan, tetapi tidak dapat bersarang.
  • Escape karakter khusus XML di dalam tag: " → &quot;, ' → &apos;, & → &amp;, < → &lt;, dan > → &gt;.

Mulai cepat

Contoh berikut menggunakan SSML untuk mengatur laju ucapan selama sintesis. Sebelum menjalankan kode, lengkapi prasyarat berikut:
  1. Dapatkan Kunci API
  2. Instal DashScope SDK (Python 2.0.1 atau lebih baru, Java 2.20.3 atau lebih baru). Untuk detailnya, lihat 安装SDK.
cosyvoice-v3.5-plus dan cosyvoice-v3.5-flash tidak menyediakan suara preset. Untuk menggunakan salah satu model dalam contoh SSML di bagian ini, buat terlebih dahulu suara kloning sesuai petunjuk di Kloning suara.
  • Java SDK
  • Python SDK
  • WebSocket API
import com.alibaba.dashscope.audio.ttsv2.SpeechSynthesisParam;
import com.alibaba.dashscope.audio.ttsv2.SpeechSynthesizer;
import com.alibaba.dashscope.utils.Constants;

import java.io.File;
import java.io.FileOutputStream;
import java.io.IOException;
import java.nio.ByteBuffer;

/**
 * Deskripsi fitur SSML:
 *     1. Hanya panggilan non-streaming dan panggilan streaming unidireksional yang mendukung fitur SSML
 * Gunakan suara kloning atau preset yang mendukung SSML (misalnya longanyang untuk cosyvoice-v3-flash). Lihat model yang didukung di halaman ini.
 */
public class Main {
    private static String model = "cosyvoice-v3-flash";
    private static String voice = "longanyang";

    public static void main(String[] args) {
        // URL wilayah Singapura. Ganti WorkspaceId dengan ID ruang kerja aktual Anda. URL berbeda-beda tergantung wilayah.
        Constants.baseWebsocketApiUrl = "wss://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api-ws/v1/inference";
        streamAudioDataToSpeaker();
        System.exit(0);
    }

    public static void streamAudioDataToSpeaker() {
        SpeechSynthesisParam param =
                SpeechSynthesisParam.builder()
                        // Kunci API untuk wilayah Singapura dan Beijing berbeda. Dapatkan Kunci API: https://www.alibabacloud.com/help/en/model-studio/get-api-key
                        // Jika Anda belum mengonfigurasi variabel lingkungan, ganti baris berikut dengan Kunci API Model Studio Anda: .apiKey("sk-xxx")
                        .apiKey(System.getenv("DASHSCOPE_API_KEY"))
                        .model(model)
                        .voice(voice)
                        .build();

        SpeechSynthesizer synthesizer = new SpeechSynthesizer(param, null);
        ByteBuffer audio = null;
        try {
            // Panggilan non-streaming, diblokir hingga audio dikembalikan
            // Karakter khusus perlu di-escape
            audio = synthesizer.call("<speak rate=\"2\">Laju bicara saya lebih cepat daripada orang biasa.</speak>");
        } catch (Exception e) {
            throw new RuntimeException(e);
        } finally {
            // Tutup koneksi WebSocket ketika tugas selesai
            synthesizer.getDuplexApi().close(1000, "bye");
        }
        if (audio != null) {
            // Simpan data audio ke file lokal "output.mp3"
            File file = new File("output.mp3");
            try (FileOutputStream fos = new FileOutputStream(file)) {
                fos.write(audio.array());
            } catch (IOException e) {
                throw new RuntimeException(e);
            }
        }

        // Transmisi teks pertama memerlukan pembentukan koneksi WebSocket, sehingga latensi paket pertama mencakup waktu penyiapan koneksi
        System.out.println(
                "[Metric] requestId: "
                        + synthesizer.getLastRequestId()
                        + ", latensi paket pertama (ms): "
                        + synthesizer.getFirstPackageDelay());
    }
}

Tag SSML

Implementasi ini berdasarkan spesifikasi W3C SSML 1.0. Hanya tag yang tercantum di bawah yang didukung.

<speak>: Elemen akar

<speak> adalah elemen root untuk semua konten SSML. Semua teks harus diapit oleh tag <speak></speak>.
<speak>Teks yang memerlukan pemrosesan SSML</speak>
  • Atribut
  • Contoh
  • Hubungan tag
AtributTipeWajibDeskripsi
voiceStringTidakMenentukan voice.Atribut ini memiliki prioritas lebih tinggi daripada parameter voice dalam permintaan API.
rateStringTidakMenentukan laju ucapan. Atribut ini memiliki prioritas lebih tinggi daripada parameter speech_rate dalam permintaan API.
  • Nilai valid: angka desimal antara 0,5 dan 2 (inklusif)
  • Nilai default: 1
    • Nilai lebih besar dari 1 meningkatkan laju ucapan
    • Nilai kurang dari 1 menurunkan laju ucapan
pitchStringTidakMenentukan pitch. Atribut ini memiliki prioritas lebih tinggi daripada parameter pitch_rate dalam permintaan API.
  • Nilai valid: angka desimal antara 0,5 dan 2 (inklusif)
  • Nilai default: 1
    • Nilai lebih besar dari 1 meningkatkan pitch
    • Nilai kurang dari 1 menurunkan pitch
volumeStringTidakMenentukan volume. Atribut ini memiliki prioritas lebih tinggi daripada parameter volume dalam permintaan API.
  • Nilai valid: bilangan bulat antara 0 dan 100 (inklusif)
  • Nilai default: 50
    • Nilai lebih besar dari 50 meningkatkan volume
    • Nilai kurang dari 50 menurunkan volume
effectStringTidakMenentukan efek audio.
  • Nilai valid:
    • robot: efek voice robot
    • lolita: efek voice lolita
    • lowpass: efek filter low-pass
    • echo: efek gema
    • eq: equalizer (lanjutan)
    • lpfilter: filter low-pass (lanjutan)
    • hpfilter: filter high-pass (lanjutan)
    • eq, lpfilter, dan hpfilter adalah jenis efek lanjutan. Gunakan parameter effectValue untuk menyesuaikan efek spesifik.
    • Setiap tag SSML hanya mendukung satu efek. Mengatur beberapa atribut effect secara bersamaan tidak diizinkan.
    • Mengaktifkan efek audio meningkatkan latensi sintesis.
effectValueStringTidakMengonfigurasi perilaku spesifik efek audio (parameter effect). Berlaku untuk tiga jenis efek lanjutan: eq, lpfilter, dan hpfilter.
  • Nilai valid:
    • eq (equalizer): sistem mendukung 8 pita frekuensi secara default, sesuai dengan frekuensi berikut: ["40 Hz","100 Hz", "200 Hz", "400 Hz", "800 Hz", "1600 Hz", "4000 Hz", "12000 Hz"]. Setiap pita memiliki bandwidth 1,0q. Gunakan parameter effectValue untuk menentukan gain untuk setiap pita. Parameter ini adalah string 8 bilangan bulat berkisar antara -20 hingga 20, dipisahkan spasi. Nilai 0 berarti tidak ada penyesuaian gain untuk frekuensi tersebut. Contoh: effectValue="1 1 1 1 1 1 1 1"
    • lpfilter (filter low-pass): menentukan frekuensi cutoff. Nilai valid: bilangan bulat dalam rentang (0, target_sample_rate/2]. Contoh: effectValue="800".
    • hpfilter (filter high-pass): menentukan frekuensi cutoff. Nilai valid: bilangan bulat dalam rentang (0, target_sample_rate/2]. Contoh: effectValue="1200".
bgmStringTidakMenambahkan musik latar pada ucapan yang disintesis.Simpan file audio di Alibaba Cloud OSS dan pastikan dapat diakses melalui URL Internet. Lihat Unggah objek. Untuk objek privat, gunakan URL bertanda tangan yang masih berlaku. Escape karakter khusus XML pada URL, misalnya mengganti & dengan &amp;.
  • Persyaratan audio: Tidak ada batas atas ukuran file musik latar, tetapi file yang lebih besar memerlukan waktu unduh lebih lama. Jika ucapan yang disintesis lebih panjang daripada musik latar, musik akan diputar ulang secara otomatis.
    • Laju sampel: 16 kHz
    • Saluran: mono
    • Format: WAV Untuk mengonversi file non-WAV, gunakan ffmpeg:
      ffmpeg -i input_audio -acodec pcm_s16le -ac 1 -ar 16000 output.wav
      
    • Kedalaman bit: 16-bit
Pengunggah bertanggung jawab secara hukum atas hak cipta audio yang diunggah.
backgroundMusicVolumeStringTidakMenentukan volume musik latar. Gunakan atribut ini bersama dengan atribut bgm.

<break>: Kontrol jeda

Menyisipkan jeda diam selama sintesis ucapan untuk mensimulasikan jeda alami dalam percakapan. Mendukung satuan waktu detik (s) dan milidetik (ms).
<!-- Tanpa atribut -->
<break/>
<!-- Dengan atribut time -->
<break time="string"/>
  • Atribut
  • Contoh
  • Hubungan tag
AtributTipeWajibDeskripsi
timeStringTidakMenentukan durasi jeda, dalam detik atau milidetik (misalnya, "2s" atau "50ms").
  • Nilai valid:
    • Dalam detik (s): bilangan bulat antara 1 dan 10 (inklusif)
    • Dalam milidetik (ms): bilangan bulat antara 50 dan 10000 (inklusif)
Saat beberapa tag <break> digunakan secara berurutan, total durasi jeda adalah jumlah semua durasi individual. Jika total melebihi 10 detik, hanya 10 detik pertama yang diterapkan.
Tanpa atribut, <break> menyisipkan jeda 1 detik.

<sub>: Ganti teks

Mengganti teks tertentu dengan konten yang lebih cocok untuk ucapan. Misalnya, membaca "W3C" sebagai "World Wide Web Consortium."
<sub alias="string"></sub>
  • Atribut
  • Contoh
  • Hubungan tag
AtributTypeWajibDeskripsi
aliasStringYaMenentukan teks pengganti yang akan dibaca keras.

<phoneme>: Tentukan pelafalan

Memberikan kontrol tepat atas cara teks dilafalkan. Teks Tionghoa mendukung notasi pinyin, dan teks Inggris mendukung notasi fonetik CMU. Ini berguna untuk menghilangkan ambiguitas karakter polifonik dan menangani pelafalan bahasa asing.
<phoneme alphabet="string" ph="string">Teks</phoneme>
  • Atribut
  • Contoh
  • Hubungan tag
AtributTipeWajibDeskripsi
alphabetStringYaMenentukan jenis pelafalan: pinyin (untuk Tionghoa) atau simbol fonetik (untuk Inggris).Nilai valid:
phStringYaMenentukan notasi pinyin atau fonetik yang tepat. Aturan penggunaan:
  • Pisahkan pinyin untuk beberapa karakter dengan spasi. Jumlah entri pinyin harus sesuai dengan jumlah karakter.
  • Setiap entri pinyin terdiri dari pelafalan dan nomor nada. Nomor nada berkisar dari 1 hingga 5, di mana 5 mewakili nada netral.

<soundEvent>: Sisipkan efek suara

Menyisipkan file efek suara (seperti nada peringatan atau suara latar) pada titik tertentu dalam ucapan untuk memperkaya output audio.
<soundEvent src="URL"/>
  • Atribut
  • Contoh
  • Hubungan tag
AtributTipeWajibDeskripsi
srcStringYaMenentukan URL file audio eksternal.Simpan file audio di Alibaba Cloud OSS dan pastikan dapat diakses melalui URL Internet. Lihat Unggah objek. Untuk objek privat, gunakan URL bertanda tangan yang masih berlaku. Escape karakter khusus XML pada URL, misalnya mengganti & dengan &amp;.
  • Persyaratan audio:
    • Laju sampel: 16 kHz
    • Saluran: mono
    • Format: WAV Untuk mengonversi file non-WAV, gunakan ffmpeg:
      ffmpeg -i input_audio -acodec pcm_s16le -ac 1 -ar 16000 output.wav
      
    • Ukuran file: maksimum 2 MB
    • Kedalaman bit: 16-bit
Pengunggah bertanggung jawab secara hukum atas hak cipta audio yang diunggah.

<say-as>: Atur cara membaca teks

Menentukan jenis konten teks (seperti angka, tanggal, atau nomor telepon) sehingga sistem membacanya sesuai aturan yang sesuai untuk jenis tersebut.
<say-as interpret-as="string">Teks</say-as>
  • Atribut
  • Contoh
  • Hubungan tag
AtributTipeWajibDeskripsi
interpret-asStringYaMenentukan jenis konten teks di dalam tag.Nilai valid:
  • cardinal: dibaca sebagai bilangan bulat atau desimal standar
  • digits: membaca setiap digit secara individual (misalnya, 123 dibaca sebagai "satu dua tiga")
  • telephone: membaca digit demi digit dalam format nomor telepon standar
  • name: membaca menggunakan aturan pelafalan nama standar
  • address: membaca menggunakan aturan pelafalan alamat standar
  • id: membaca menggunakan aturan pelafalan pengenal (nama akun, nama panggilan) standar
  • characters: membaca setiap karakter dalam teks secara individual
  • punctuation: membaca nama setiap tanda baca
  • date: membaca menggunakan aturan pelafalan tanggal standar
  • time: membaca menggunakan aturan pelafalan waktu standar
  • currency: membaca menggunakan aturan pelafalan jumlah moneter standar
  • measure: membaca menggunakan aturan pelafalan satuan ukuran standar
cardinal
  • Mandarin
  • Inggris
FormatContohOutput MandarinCatatan
String digit145一百四十五Bilangan bulat positif dan negatif hingga 20 digit: [-99999999999999999999,99999999999999999999]. Tidak ada batas khusus untuk jumlah angka desimal; disarankan maksimal 10.
Tanda minus+String digit-145负一百四十五
Kelompok 3 digit dipisahkan koma10,000一万
Tanda minus+Kelompok 3 digit dipisahkan koma-10,124负一万一百二十四
String digit+Titik desimal+Dua nol10.00十
Tanda minus+String digit+Titik desimal+Dua nol-110.00负一百一十
String digit+Titik desimal+String digit79.090七十九点零九零
Tanda minus+String digit+Titik desimal+String digit-79.001负七十九点零零一
digits
  • Mandarin
  • Inggris
FormatContohOutput MandarinCatatan
String digit129090909一二九零九零九零九Panjang string digit tidak dibatasi secara khusus; disarankan maksimal 20 digit. Jika melebihi 10 digit, jeda disisipkan setelah setiap digit.
telephone
  • Mandarin
  • Inggris
FormatContohOutput MandarinCatatan
Nomor telepon tetap4930286四九三 零二八六Mendukung nomor telepon tetap 7 atau 8 digit dengan pemisah spasi atau tanda hubung (-). Kelompokkan 7 digit sebagai 3-4 dan 8 digit sebagai 4-4.
493 0286四九三 零二八六
493-0286四九三 零二八六
62552560六二五五 二五六零
6255 2560六二五五 二五六零
6255-2560六二五五 二五六零
Nomor telepon tetap+Nomor ekstensi4930286-109四九三 零二八六 转幺零九Mendukung nomor ekstensi 1 hingga 4 digit.
4930286转109四九三 零二八六 转幺零九
4930286分机109四九三 零二八六 分机幺零九
4930286分机号109四九三 零二八六 分机号幺零九
Kode area+Nomor telepon tetap01062552560零幺零 六二五五 二五六零Kode area: 010, 02x, 03xx, 04xx, 05xx, 07xx, 08xx, 09xx.
010 62552560零幺零 六二五五 二五六零
010 6255 2560零幺零 六二五五 二五六零
010 6255-2560零幺零 六二五五 二五六零
010-62552560零幺零 六二五五 二五六零
010-6255-2560零幺零 六二五五 二五六零
(010)62552560零幺零 六二五五 二五六零
03198907098零三幺九 八九零 七零九八
0319-8907098三幺九 八九零 七零九八
Kode area+Nomor telepon tetap+Nomor ekstensi010 62552560-109零幺零 六二五五 二五六零 转幺零九Tidak ada
010-62552560-109零幺零 六二五五 二五六零 转幺零九
(010)62552560-109零幺零 六二五五 二五六零 转幺零九
(010)62552560转109零幺零 六二五五 二五六零 转幺零九
(010)62552560分机109零幺零 六二五五 二五六零 分机幺零九
(010)62552560分机号109零幺零 六二五五 二五六零 分机号幺零九
Kode negara+Kode area+Nomor telepon tetap86-010-62791627八六 零幺零 六二七九 幺六二七Kode negara 86, (86), +86, (+86), dan 0086 semuanya dibaca “八六” (delapan enam).
(86)10-62791627八六 幺零 六二七九 幺六二七
+86-010-62791627八六 零幺零 六二七九 幺六二七
0086-10-62791627八六 幺零 六二七九 幺六二七
(+86)-10-6279 1627八六 幺零 六二七九 幺六二七
Kode negara+Kode area+Nomor telepon tetap+Nomor ekstensi(86)21-58118818-207八六 二幺 五八幺幺 八八幺八 转二零七Tidak ada
(86)021-5811-8818-207八六 零二幺 五八幺幺 八八幺八 转二零七
(86)021-58118818转207八六 零二幺 五八幺幺 八八幺八 转二零七
(86)21-5811-8818分机207八六 二幺 五八幺幺 八八幺八 分机二零七
+86-021-58118818分机号207八六 零二幺 五八幺幺 八八幺八分机号二零七
Nomor ponsel139 0000 5678幺三九 零零零零 五六七八Mendukung nomor ponsel 11 digit dengan pengelompokan 3-3-5 atau 3-4-4.
139-000-05678幺三九 零零零 零五六七八
139 000 05678幺三九 零零零 零五六七八
Kode negara+Nomor ponsel+86-13900005678八六 幺三九 零零零零 五六七八Tidak ada
(+86)-139-0000-5678八六 幺三九 零零零零 五六七八
+8613900005678八六 幺三九 零零零零 五六七八
0086-139 000 05678八六 幺三九 零零零 零五六七八
Nomor layanan123幺二三Mendukung nomor layanan umum, nomor 10 digit berawalan 400/800 yang dikelompokkan sebagai 3-3-4, dan nomor 16 digit berawalan 12530/17951/12593.
95678九五六七八
4008110510四零零 八幺幺 零五幺零
800-810-8888八零零 八幺零 八八八八
1253013520638377幺二五三零 幺三五 二零六三 八三七七
Lainnya(86)(21)9899-80800-0909八六 二幺 九八九九 八零八零零 零九零九Mendukung string digit dengan pemisah (tanda kurung atau tanda hubung).
address
  • Mandarin
  • Inggris
FormatContohOutput MandarinCatatan
Format alamat umum元和镇嘉元30-9元和镇嘉元三十杠九Mendukung format alamat umum. Alamat di sini berarti alamat pos standar.
市台路388弄1107-1108号市台路三八八弄幺幺零七杠幺幺零八号
华润二十四城六期锦云府3-1-3205华润二十四城六期锦云府三杠一杠三二零五
圣华名都大厦2幢2006室圣华名都大厦二幢二零零六室
五常街道庭院5幢4单元201五常街道庭院五幢四单元二零幺
芙蓉江路150弄19号芙蓉江路幺五零弄十九号
id
  • Mandarin
  • Inggris
FormatContohOutput MandarinCatatan
Stringdell0101D E L L 零 一 零 一Mendukung huruf Inggris besar dan kecil, digit 0-9, serta garis bawah. Spasi pada output menunjukkan jeda saat karakter dibaca satu per satu.
myid_1998M Y I D 下划线 一 九 九 八
AiTestA I T E S T
characters
  • Mandarin
  • Inggris
FormatContohOutput MandarinCatatan
StringISBN 1-001-099098-1I S B N 一 杠 零 零 一 杠 零 九 九 零 九 八 杠 一Mendukung karakter Mandarin, huruf Inggris besar dan kecil, digit 0-9, serta sebagian karakter lebar penuh dan setengah lebar. Spasi menunjukkan jeda antar karakter yang dibaca satu per satu. Escape karakter khusus XML.
x10b2345_ux 一 零 b 二 三 四 五 下划线 u
v1.0.1v 一 点 零 点 一
版本号2.0版本号二 点 零
苏M MA000苏M M A 零 零 零
空中客车A330空中客车A 三 三 零
型号s01 s02和s03型号s 零 一 s 零二 和s 零 三
空中客车A330空中客车A 三 三 零
αβγ阿尔法 贝塔 伽玛
punctuation
  • Mandarin
  • Inggris
FormatContohOutput MandarinCatatan
Tanda baca…省略号Mendukung tanda baca Mandarin dan Inggris yang umum. Spasi menunjukkan jeda antar karakter yang dibaca satu per satu. Escape karakter khusus XML.
……省略号
!"#$%&叹号 双引号 井号 dollar 百分号 and
‘()*+单引号 左括号 右括号 星号 加号
,-./:;逗号 杠 点 斜杠 冒号 分号
<=>?@小于 等号 大于 问号 at
[\]^_左方括号 反斜线 右方括号 脱字符 下划线
date
  • Mandarin
  • Inggris
FormatContohOutput MandarinCatatan
xx年71年七一年Mendukung tahun 2 digit dalam rentang 60-99, 00-09, dan 10-19, serta tahun 4 digit dalam rentang 1000-1999 dan 2000-2099.
04年零四年
19年一九年
1011年一零一一年
1998年一九九八年
2008年二零零八年
xx年xx月98年4月九八年四月Bulan 1-9 dapat menggunakan atau menghilangkan nol di depan, misalnya “1908年4月” dan “1908年04月”.
1998年04月一九九八年四月
08年8月零八年八月
2008年8月二零零八年八月
xx年xx月xx日xx年xx月xx号98年4月23日九八年四月二十三日Hari 1-9 dapat menggunakan atau menghilangkan nol di depan, misalnya “1908年4月8日” dan “1908年04月08日”.
1998年04月23日一九九八年四月二十三日
08年8月8号零八年八月八号
2008年08月08号二零零八年八月八号
xx年xx月xx日xx年xx月xx号98年4月23日九八年四月二十三日Hari 1-9 dapat menggunakan atau menghilangkan nol di depan, misalnya “1908年4月8日” dan “1908年04月08日”.
1998年04月23日一九九八年四月二十三日
08年8月8号零八年八月八号
2008年08月08号二零零八年八月八号
xx月xx号3月20日三月二十日Tidak ada
08月07号八月七号
Singkatan tahun/bulan2018/08二零一八年八月Mendukung /, -, dan . sebagai pemisah.
2018-08二零一八年八月
2018.08二零一八年八月
Singkatan tahun/bulan/hari2018/08/08二零一八年八月八日
2018-8-8二零一八年八月八日
2018.08.08二零一八年八月八日
xx年xx月xx日~xx年xx月xx日xx年xx月xx号~xx年xx月xx号04年9月1日~30日零四年九月一日至三十日Mendukung ~ dan - untuk menunjukkan “hingga”.
2004年09月01号-2008年06月08号二零零四年九月一号至二零零八年六月八号
xx年xx月xx日~xx日xx年xx月xx号~xx号04年9月1日~30日零四年九月一日至三十日
2004年09月01号-2008年06月08号二零零四年九月一号至二零零八年六月八号
xx年xx月~xx年xx月01年04月~10年04月零一年四月至一零年四月
2001年04月~2010年04月二零零一年四月至二零一零年四月
xx月xx日~xx月xx日xx月xx号~xx月xx号10月1日~10月7日十月一日至十月七日
10月01号~10月07号十月一号至十月七号
xx月xx日~xx日xx月xx号~xx号10月1日~7日十月一日至七日
10月01号~07号十月一号至七号
Singkatan tahun/bulan/hari~Singkatan tahun/bulan/hari2018/03/03~2019/01/01二零一八年三月三日至二零一九年一月一日Mendukung / dan . sebagai pemisah, serta ~ dan - untuk menunjukkan “hingga”.
1997.9.9~1998.9.9一九九七年九月九日至一九九八年九月九日
Singkatan bulan/hari~Singkatan bulan/hari10/20~10/31十月二十日至十月三十一日
xx~xx月xx月~xx月1~10月一至十月
1月~10月一月至十月
Singkatan bulan/hari/tahun10/20/2018二零一八年十月二十日Hanya mendukung tahun 4 digit, pemisah /, dan urutan bulan/hari/tahun.
time
  • Mandarin
  • Inggris
FormatContohOutput MandarinCatatan
Waktu12:00十二点Mendukung format waktu dan rentang waktu umum.
12:00:00点十二点
10:20分十点二十分
10:20:30十点二十分三十秒
09:18:14九点十八分十四秒
Waktu~Waktu11:00~12:00十一点到十二点
09:00-14:00九点到十四点
11:00~11:30十一点到十一点三十分
11:00-12:18十一点到十二点十八分
10:30~11:00十点三十分到十一点
09:28-10:00九点二十八分到十点
10:20~11:20十点二十分到十一点二十分
06:00~08:00六点到八点
上午10:20~下午13:30上午十点二十分到下午十三点三十分
Singkatan waktu5:00 am凌晨五点整
5:30 am凌晨五点半
5:20:12 am凌晨五点二十分十二秒
7:00 am上午七点整
7:30 AM上午七点半
7:20:12 a.m.上午七点二十分十二秒
07:08:12 A.M.上午七点零八分十二秒
5:00 pm下午五点整
5:30 PM下午五点半
5:20:12 p.m.下午五点二十分十二秒
05:09:12 P.M.下午五点零九分十二秒
9:00 pm晚上九点整
9:30 pm晚上九点半
9:20:12 PM晚上九点二十分十二秒
9:02:12 P.M.晚上九点零二分十二秒
12:00 pm中午十二点整
12:30 p.m.中午十二点半
12:20:12 PM中午十二点二十分十二秒
currency
  • Mandarin
  • Inggris
FormatContohOutput MandarinCatatan
Angka+Penanda mata uang12.00 RMB十二人民币Mendukung AUD (dolar Australia), CAD (dolar Kanada), HKD (dolar Hong Kong), JPY (yen Jepang), USD (dolar AS), CHF (franc Swiss), NOK (krone Norwegia), SEK (krona Swedia), GBP (pound Inggris), RMB (renminbi), CNY (yuan), dan EUR (euro). Angka dapat berupa bilangan bulat, desimal, atau notasi internasional dengan pemisah koma.
12.50 RMB十二点五零人民币
12,000,000 RMB一千二百万人民币
12,000,000.00 RMB一千二百万人民币
12,000.35 RMB一万两千点三五人民币
Penanda mata uang+Angka$12十二美元Mendukung CAD (dolar Kanada), $ (dolar AS), Fr (franc), kr (krone Denmark), £ (pound Inggris), ¥ (yuan), dan € (euro). Angka dapat berupa bilangan bulat, desimal, atau notasi internasional dengan pemisah koma.
$12.00十二美元
$12.12二点一二美元
$12,000一万两千美元
$12,000.00一万两千美元
$12,000.99一万两千点九九美元
Pembacaan default lainnya1213一千二百一十三Tidak ada
1213 KML一千二百一十三K M L
1213.00 KML一千二百一十三K M L
1213.9 KML一千二百一十三点九K M L
1,000 KML一千K M L
1,000.00 KML一千K M L
1,000.98 KML一千点九八K M L
12,000一万两千
measure
  • Mandarin
  • Inggris
FormatContohOutput MandarinCatatan
Angka+Satuan Mandarin2片两片Mendukung satuan Mandarin umum dan singkatan satuan.
120公顷一百二十公顷
100多毫克一百多毫克
100来米一百来米
100余人一百余人
1厘米20毫米一厘米二十毫米
120.00平方公里一百二十平方公里
Angka+Singkatan satuan120.56 cm²一百二十点五六平方厘米
120 ㎡ 56 cm²一百二十平方米五十六平方厘米
100 m 12 cm 6 mm一百米十二厘米六毫米
Rentang10~15 kg十至十五千克
10.24~789.82亩十点二四至七百八十九点八二亩
10米~15米十米至十五米
10.24 cm~19.08 cm十点二四厘米至十九点零八厘米
Angka+Satuan+"/"+Satuan10元/斤十元每斤
199~299元/件一百九十九至二百九十九元每件
299.99元/g~399.99元/g二百九十九点九九元每克至三百九十九点九九元每克
Pembacaan default lainnya12扎十二扎
30 rm三十r m
4万万同胞四万万同胞
12.897微克十二点八九七微克
Simbol umum
SimbolPembacaan MandarinPembacaan Inggris
!叹号exclamation mark
“双引号double quote
#井号pound
$dollardollar
%百分号percent
&andand
‘单引号left quote
(左括号left parenthesis
)右括号right parenthesis
*星asterisk
+加plus
,逗号comma
-杠dash
.点dot
/斜杠slash
:零冒号solon
;分号semicolon
<小于less than
=等号equals
>大于greater than
?问号question mark
@atat
[左方括号left bracket
\反斜线back slash
]右方括号right bracket
^脱字符caret
_下划线underscore
`反引号back quote
{左花括号left brace
|竖线vertical bar
}右花括号right brace
~波浪线tilde
!叹号exclamation mark
“左双引号left double quote
”右双引号right double qute
‘左单引号left quote
’右单引号right quote
(左括号left parenthesis
)右括号right parenthesis
,逗号comma
。句号full stop
—杠em dash
:冒号colon
;分号semicolon
?问号question mark
、顿号enumeration comma
…省略号ellipsis
……省略号ellipsis
《左书名号left guillemet
》右书名号right guillemet
¥人民币符号yuan
≥大于等于greater than or equal to
≤小于等于less than or equal to
≠不等于not equal
≈约等于approximately equal
±加减plus or minus
×乘times
π派pi
Α阿尔法alpha
Β贝塔beta
Γ伽玛gamma
Δ德尔塔delta
Ε艾普西龙epsilon
Ζ捷塔zeta
Θ西塔theta
Ι艾欧塔iota
Κ喀帕kappa
∧拉姆达lambda
Μ缪mu
Ν拗nu
Ξ克西ksi
Ο欧麦克轮omicron
∏派pi
Ρ柔rho
∑西格玛sigma
Τ套tau
Υ宇普西龙upsilon
Φfaiphi
Χ器chi
Ψ普赛psi
Ω欧米伽omega
α阿尔法alpha
β贝塔beta
γ伽玛gamma
δ德尔塔delta
ε艾普西龙epsilon
ζ捷塔zeta
η依塔eta
θ西塔theta
ι艾欧塔iota
κ喀帕kappa
λ拉姆达lambda
μ缪mu
ν拗nu
ξ克西ksi
ο欧麦克轮omicron
π派pi
ρ柔rho
σ西格玛sigma
τ套tau
υ宇普西龙upsilon
φfaiphi
χ器chi
ψ普赛psi
ω欧米伽omega
Satuan umum
FormatKategoriContoh MandarinContoh Inggris
SingkatanPanjangnm(纳米)、μm(微米)、 mm(毫米)、cm(厘米)、m(米)、km(千米)、ft(英尺)、in(英寸)nm (nanometre), μm (micrometre), mm (millimetre), cm (centimetre), m (metre), km (kilometre), ft (foot), in (inch)
Luascm²(平方厘米)、㎡(平方米)、km²(平方千米)、SqFt(平方英尺)cm² (square centimetre), ㎡ (square metre), km2 (square kilometre), SqFt (square foot)
Volumecm³(立方厘米)、m³(立方米)、km³(立方千米)、mL(毫升)、L(升)、gallon(加仑)cm³ (cubic centimetre), m³ (cubic metre), km3 (cubic kilometre), mL (millilitre), L (millilitre), gal (gallon)
Beratμg(微克)、mg(毫克)、g(克)、kg(千克)μg (microgram), mg (microgram), g (gram), kg (kilogram)
Waktumin(分)、sec(秒)、ms(毫秒)min (minute), sec (second), ms (millisecond)
ElektromagnetismeμA(微安)、mA(毫安)、Ω(欧姆)、Hz(赫兹)、kHz(千赫兹)、MHz(兆赫兹)、GHz(吉赫兹)、V(伏)、kV(千伏)、kWh(千瓦时)μA (microamp), mA (milliamp), Hz (hertz), kHz (kilohertz), MHz (megahertz), GHz (gigahertz), V (volt), kV (kilovolt), kWh (kilowatt hour)
SuaradB(分贝)dB (decibel)
TekananPa(帕)、kPa(千帕)、Mpa(兆帕)Pa (pascal), kPa (kilopascal), MPa (megapascal)
Satuan umum lainnyaJuga mendukung satuan Mandarin di luar kategori ini, seperti “米”, “秒”, “美元”, dan “毫升每瓶”, serta kata penggolong Mandarin seperti “架”, “场”, “头”, “部”, dan “盆”.Juga mendukung satuan lain, seperti tsp (teaspoon), rpm (round per minute), KB (kilobyte), dan mmHg (millimetre of mercury).

Tag dan simbol LaTeX

Pilih kategori untuk melihat tag dan simbol yang didukung. Contoh teks input menyertakan pembatas. Contoh pembacaan tetap dalam bahasa Mandarin karena fitur ini menghasilkan ucapan bahasa Mandarin.

Matematika dasar

Tag atau simbolMaknaContoh sumber rumusContoh teks inputContoh pembacaan
+Penjumlahan2 + 3 = 5$2 + 3 = 5$二加三等于五
-Pengurangan3 - 2 = 1$3 - 2 = 1$三减二等于一
\pmPlus atau minus\pm 1 \pm 2$\pm 1\pm 2$正负一加减二
Positif atau negatif
\timesPerkalian2 \times 3 = 6$2 \times 3 = 6$二乘三等于六
×2 × 3 = 6$$2 × 3 = 6$$
*2 * 3 = 6\(2 * 3 = 6\)
\divPembagian6\div2=3\[6\div2=3\]六除二等于三
÷6÷2=3$6÷2=3$
/6/2=3$6/2=3$
=Sama dengan3+5=8$3+5=8$三加五等于八
<Kurang dari1< 2$1< 2$一小于二
≤Kurang dari atau sama dengan3≤5$3≤5$三小于等于五
<=3<=5$3<=5$
\leq3\leq5$3\leq 5$
\le3\le5$3\le 5$
\leqq3\leqq5$3\leqq 5$
\leqslant3\leqslant5$3\leqslant 5$
>Lebih dari2>1$2>1$二大于一
≥Lebih dari atau sama dengan5≥3$5≥3$五大于等于三
>=5>=3$5>=3$
\geq5\geq3$5\geq 3$
\ge5\ge3$5\ge 3$
\geqq5\geqq3$5\geqq 3$
\geqslant5\geqslant3$5\geqslant 3$
\fracPecahan2\frac3$\frac {2}{3}$三分之二
^Pangkat2^1$2^{1}$二的一次方
\sqrtAkar\sqrt{9} = 3$\sqrt {9} = 3$根号下九等于三
\sqrt[3]{8} = 2$\sqrt[3]{8} = 2$三次根号下八等于二
\%Persentase5\%$5\%$百分之五
|Nilai mutlak∣3∣=3$|3| =3$绝对值三的绝对值等于三
\vert3\vert=3$\vert 3\vert =3$绝对值三绝对值等于三
\lgLogaritmalg {10}$\lg {10}$log十
\logLogaritma\log{5}$\log{5}$log五
\lnLogaritma natural\lnX$ln {10}$LN十
!Faktorial5!$5!$五的阶乘
()Tanda kurung(2+1)$(2+1)$括号内二加一
\{ \}$\{2+1\}$大括号二加一反大括号

Simbol matematika khusus

Tag atau simbolMaknaContoh sumber rumusContoh teks inputContoh pembacaan
\alphaalpha\alpha$\alpha$α
\Alpha\Alpha$\Alpha$
\betabeta\beta$\beta$β
\Beta\Beta$\Beta$
\gammagamma\gamma$\gamma$γ
\Gamma\Gamma$\Gamma$
\deltadelta\delta$\delta$Δ
\Delta\Delta$\Delta$
\inftyTak hingga (Mandarin)\infty$\infty$无穷大
∞infty (Inggris)∞$∞$

Geometri

Tag atau simbolMaknaContoh sumber rumusContoh teks inputContoh pembacaan
\piPi\pi=3.14159$\pi =3.14159$派等于三点一四一五九
\sin (sine)Fungsi trigonometri\sin 30^\circ =\frac {1}{2}$\sin 30^\circ =\frac {1}{2}$sine三十度等于二分之一
\cos (cosine)\cos 45^\circ =\frac {\sqrt {2}}{2}$\cos 45^\circ =\frac {\sqrt {2}}{2}$cosine四十五度等于二分之根号下二
\tan (tangent)\tan 30^\circ =\frac {\sin 30^\circ}{\cos 30^\circ}$\tan 30^\circ =\frac {\sin 30^\circ}{\cos 30^\circ}$tangent三十度等于cosine三十度分之sine三十度
\csc (cosecant)\csc A$\csc A$cosecant A
\sec (secant)\sec A$\sec A$secant A
\cot (cotangent)\cot A$\cot A$cotangent A
\angleSudut\angle AB$\angle AB$角A B
∠∠AB$∠AB$
^\circDerajat∠AB = 30^\circ$∠AB = 30^\circ$角A B 等于三十度
\odotLingkaran\odot$\odot$圆
\overset\frownBusur\overset\frown {BC}$\overset\frown {BC}$弧BC
\rm{Rt}Sudut siku-siku\because \rm{Rt}\triangle ABC$\because \rm{Rt}\triangle ABC$因为直角三角形ABC
\mathrm{Rt}\therefore AB \perp BC$\therefore AB \perp BC$所以AB垂直于BC
\triangleSegitiga\triangleABC$\triangle ABC$三角形ABC
△△ABC$△ABC$
\parallelogramJajar genjang\parallelogramABCD$\parallelogram ABCD$平行四边形ABCD
\perpTegak lurusAB \perp BC$AB \perp BC$A B 垂直于 B C
\botAB \bot BC$AB \bot BC$
⊥AB ⊥ BC$AB ⊥ BC$
\parallelSejajarA\parallel B$A\parallel B$A平行于B
\equalparallelSejajar dan samaA\equalparallel B$A\equalparallel B$A平行且相等于B
\congKongruen△ABC\cong△DEF$△ABC\cong△DEF$三角形ABC全等于三角形DEF

Kondisi

Tag atau simbolMaknaContoh sumber rumusContoh teks inputContoh pembacaan
\impliesMengimplikasikan\implies 1+1=2$\implies 1+1=2$推出一加一等于二
\iffEkuivalenp\iffq$p\iffq$p等价q
\becauseKarena\because a = b \therefore b=a$\because a = b \therefore b=a$因为a等于b所以b等于a
\thereforeOleh karena itu

Satuan

Apit satuan dengan \unit, \quantity, \mathit, \mathrm, atau \rm, misalnya \unit{cm}.
Tag atau simbolMaknaContoh sumber rumusContoh teks inputContoh pembacaan
mmMilimeter5\quantity{mm}$5\quantity{mm}$五毫米
cmSentimeter5\quantity{cm}$5\quantity{cm}$五厘米
dmDesimeter5\quantity{dm}$5\quantity{dm}$五分米
mMeter5\quantity{m}$5\quantity{m}$五米
kmKilometer5\quantity{km}$5\quantity{km}$五千米
gGram5\quantity{g}$5\quantity{g}$五克
kgKilogram5\quantity{kg}$5\quantity{kg}$五千克
tTon5\quantity{t}$5\quantity{t}$五吨
mm^2Milimeter persegi5\quantity{mm^2}$5\quantity{mm^2}$五平方毫米
cm^2Sentimeter persegi5\quantity{cm^2}$5\quantity{cm^2}$五平方厘米
dm^2Desimeter persegi5\quantity{dm^2}$5\quantity{dm^2}$五平方分米
m^2Meter persegi5\quantity{m^2}$5\quantity{m^2}$五平方米
km^2Kilometer persegi5\quantity{km^2}$5\quantity{km^2}$五平方千米
mm^3Milimeter kubik5\quantity{mm^3}$5\quantity{mm^3}$五立方毫米
cm^3Sentimeter kubik5\quantity{cm^3}$5\quantity{cm^3}$五立方厘米
dm^3Desimeter kubik5\quantity{dm^3}$5\quantity{dm^3}$五立方分米
m^3Meter kubik5\quantity{m^3}$5\quantity{m^3}$五立方米
km^3Kilometer kubik5\quantity{km^3}$5\quantity{km^3}$五立方千米
mlMililiter5\quantity{ml}$5\quantity{ml}$五毫升
sDetik5\quantity{s}$5\quantity{s}$五秒
minMenit5\quantity{min}$5\quantity{min}$五分
hJam5\quantity{h}$5\quantity{h}$五小时
km/hKilometer per jam5\quantity{km/h}$5\quantity{km/h}$五千米每小时
g/lGram per liter5\quantity{g/l}$5\quantity{g/l}$五克每升

FAQ

Mengapa rumus tidak dibaca dengan benar?

  1. Periksa apakah rumus diapit oleh $...$, $$...$$, \(...\), atau \[...\].
  2. Periksa tag atau simbol yang tidak didukung.
  3. Pastikan setiap \ di-escape sebagai \\ dalam string permintaan.

Bagaimana menangani garis miring terbalik dalam kode?

Lihat petunjuk escape di Penggunaan. Sumber rumus dan string kode menggunakan notasi berbeda: tulis \frac sebagai \\frac dalam string biasa.