連携を容易にする公式 Go SDK を公開
これは 2014 年の公開告知です。掲載例は初期の SDK API を使用しています。新たに連携する場合は、現在の Go SDK ドキュメントを参照してください。
本日、Transloadit の公式 Go SDK を公開できることをうれしく思います。Goは、非常に強力で急速に成長しているオープンソース言語です。当社の API は Node.js で書かれていますが、社内ではスケーリングやシステムユーティリティーに Go を活用し、満足しています。そのため、この楽しい言語の力をさらに活かす方法を常に探しています。

これまでも、どの言語からでも REST API を利用できましたが、今回のリリースにより、Go に関心のある開発者がファイルのインポートとエンコードのサービスを自分のプロジェクトにこれまで以上に簡単に組み込めるようになることを期待しています。
コードとドキュメントは GitHub と
Godoc で公開していますが、ここでも SDK の使い方を紹介します。lol_cat.jpg 画像を 75×75 ピクセルにリサイズする例を見てみましょう。
go get github.com/transloadit/go-sdk を実行すれば、次のようなコードで連携できます。
import "github.com/transloadit/go-sdk"
import "fmt"
// Create client
options := transloadit.DefaultConfig
options.AuthKey = "YOUR_TRANSLOADIT_KEY"
options.AuthSecret = "YOUR_TRANSLOADIT_SECRET"
client, err := transloadit.NewClient(options)
if err != nil {
panic(err)
}
// Initialize new assembly
assembly := client.CreateAssembly()
// Add file to upload
err = assembly.AddFile("./lol_cat.jpg")
if err != nil {
panic(err)
}
// Add Instructions, e.g. resize image to 75x75px
assembly.AddStep("resize", map[string]interface{}{
"robot": "/image/resize",
"width": 75,
"height": 75,
"resize_strategy": "crop",
})
// Wait until Transloadit is done processing all uploads
// and is ready for you to download the results
assembly.Blocking = true
// Start the upload
info, err := assembly.Upload()
if err != nil {
panic(err)
}
fmt.Printf("You can view the result at: %s\n", info.Results["resize"][0].Url)
画像のリサイズだけにしては手間がかかるように見えるかもしれませんが、同じコードはほかの用途にも使えます。タブレット向けの動画の最適化、アプリの動画を App Store に提出するための HLS への変換、ドキュメントのアニメーション GIF プレビューの生成、さらに Transloadit の Robot が対応するそのほかの便利な変換 (English)にも利用できます。
さらに、この SDK には、ローカルディレクトリから Assembly を自動作成する機能が組み込まれています。すべてのファイルを Transloadit にアップロードし、指定した Step で変換するだけでなく、すべての結果をすぐにダウンロードします。また、この機能はディレクトリの変更を監視し、変更が発生するたびに自動処理することもできます。そのために必要なコードを見てみましょう。
options := &transloadit.WatchOptions{
// Use Encoding instructions as stored in a Template in your Transloadit Account
TemplateId: "02a8693053cd11e49b9ba916b58830db",
// The directory which the files will be taken from
Input: "./input",
// The directory where the results are downloaded into
Output: "./output",
// Watch the input directory for changes
Watch: true,
// Put the original files from the input directory
// into the output directory (recommended as the input dir gets cleared)
Preserve: true,
}
watcher := client.Watch(options)
これで、./input ディレクトリにファイルを入れるだけで、変換結果が ./output に保存されます。とても便利ですよね。😄
確かに便利ですが、私たちが目指す使いやすさにはまだ届いていません。この機能を使うには、まだ数行のコードを書く必要があるからです。
そこで、若く才能豊かな Acconut と協力して、この SDK だけでなく、SDK をベースにした CLI ツールも開発しました。自分のサーバーやワークステーションで、コードをまったく書かずに Transloadit を利用できるツールです。このツールの魅力を詳しく紹介する別のブログ記事も公開予定ですので、どうぞお楽しみに。
ご意見やご感想は、プロジェクトの GitHub の Issue、この記事のコメント欄、または hello@transloadit.com 宛てのメールでぜひお寄せください。
最後に、このプロジェクトを入念にレビューしてくれた、当社の功労者 Felix に感謝します。😄
