gnolizuh / gamf

gamf implements encoding and decoding of AMF based on Go.

English | 中文

gamf

Best open source lib of AMF serialization and deserialization based on Go.

Features

• Usage exactly similar to std.json
• Flexible customization with options
• More compatible, we supported both AMF0 & AMF3

Installation

go get github.com/gnolizuh/gamf

How to use

Integer

AMF0

in := 1
bs, _ := Marshal(&in)

var out int
Unmarshal(bs, &out)

AMF3

var bs []byte
buf := bytes.NewBuffer(bs)

in := 1
NewEncoder().WithWriter(buf).Encode(&in)

var out int
NewDecoder().WithReader(buf).Decode(&out)

Float

AMF0

in := 1.0
bs, _ := Marshal(&in)

var out float64
Unmarshal(bs, &out)

AMF3

var bs []byte
buf := bytes.NewBuffer(bs)

in := 1
NewEncoder().WithWriter(buf).WithVersion(Version3).Encode(&in)

var out int
NewDecoder().WithReader(buf).WithVersion(Version3).Decode(&out)

String

AMF0

in := "1"
bs, _ := Marshal(&in)

var out string
Unmarshal(bs, &out)

AMF3

var bs []byte
buf := bytes.NewBuffer(bs)

in := "1"
NewEncoder().WithWriter(buf).WithVersion(Version3).Encode(&in)

var out string
NewDecoder().WithReader(buf).WithVersion(Version3).Decode(&out)

Bool

AMF0

in := "1"
bs, _ := Marshal(&in)

var out string
Unmarshal(bs, &out)

AMF3

var bs []byte
buf := bytes.NewBuffer(bs)

in := true
NewEncoder().WithWriter(buf).WithVersion(Version3).Encode(&in)

out := false
NewDecoder().WithReader(buf).WithVersion(Version3).Decode(&out)

Slice

AMF0

in := []int{1, 2, 3}
bs, _ := Marshal(&in)

var out []int
Unmarshal(bs, &out)

AMF3

var bs []byte
buf := bytes.NewBuffer(bs)

in := []any{1.0, "1", true, map[string]any{"Int": 1.0, "String": "1", "Bool": true}}
NewEncoder().WithWriter(buf).WithVersion(Version3).Encode(&in)

out := []any{0.0, "0", false, map[string]any{}}
NewDecoder().WithReader(buf).WithVersion(Version3).Decode(&out)

Struct

Struct to Struct

type Struct struct {
    Int    int    `amf:"tag_int"`
    String string `amf:"tag_string"`
    Bool   bool   `amf:"tag_bool"`
    Object struct {
        Int    int    `amf:"tag_int"`
        String string `amf:"tag_string"`
        Bool   bool   `amf:"tag_bool"`
    } `amf:"tag_object"`
}

in := Struct{} // with value be initialized
bs, _ := Marshal(&in)

out := Struct{}
Unmarshal(bs, &out)

Struct to Map

type Struct struct {
    Int    int    `amf:"tag_int"`
    String string `amf:"tag_string"`
    Bool   bool   `amf:"tag_bool"`
    Object struct {
        Int    int    `amf:"tag_int"`
        String string `amf:"tag_string"`
        Bool   bool   `amf:"tag_bool"`
    } `amf:"tag_object"`
}

in := Struct{} // with value be initialized
bs, _ := Marshal(&in)

out := make(map[string]any)
Unmarshal(bs, &out)

Map

in := map[string]any{"Int": 1.0, "String": "1", "Bool": true}
bs, _ := Marshal(&in)

out := make(map[string]any)
Unmarshal(bs, &out)

Reference

• https://rtmp.veriskope.com/pdf/amf0-file-format-specification.pdf
• https://rtmp.veriskope.com/pdf/amf3-file-format-spec.pdf