concordダウンロード - concordソースコードのダウンロード

concord

C# ソースコード

v2.3.0

ダウンロード

Concord - C Discord API ライブラリ

コンコードは死んではいない！

開発は開発ブランチで行われています。私たちは新機能と改善に取り組んでいます。ライブラリの最新バージョンにアクセスするには、dev ブランチをチェックしてください。

について

Concord は、外部依存関係を最小限に抑えた非同期 C99 Discord API ライブラリであり、Discord 公式ドキュメントを C コードに低レベルで翻訳したものです。

例

以下は最小限の例です。概要については、 examples/を参照してください。

スラッシュコマンド (新しいメソッド)

注: GUILD_ID実際のギルド ID に置き換える必要があります。そうしないと、この例はコンパイルできません。これを行うにはマクロを使用できます: #define GUILD_ID 1234567898765431

 #include <string.h>#include <concord/discord.h>void on_ready(struct discord *client, const struct discord_ready *event) {struct discord_create_guild_application_command params = {
        .name = "ping",
        .description = "Ping コマンド!"};discord_create_guild_application_command(client, イベント->アプリケーション->id, GUILD_ID, &params, NULL);
}void on_interaction(struct discord *client, const struct discord_interaction *event) {if (event->type != DISCORD_INTERACTION_APPLICATION_COMMAND)return; /* インタラクションがスラッシュ コマンドでない場合に返す */if (strcmp(event->data->name, "ping") == 0) { struct discord_interaction_response params = {
                .type = DISCORD_INTERACTION_CHANNEL_MESSAGE_WITH_SOURCE,
                .data = &(struct discord_interaction_callback_data){
                      .content = "ポン"}
          };          discord_create_interaction_response(client, イベント->id, イベント->トークン, &params, NULL);
    }
}int main(void) {struct discord *client = discord_init(BOT_TOKEN);discord_set_on_ready(client, &on_ready);discord_set_on_interaction_create(client, &on_interaction);discord_run(client);
}

メッセージコマンド (古い方法)

 #include <string.h>#include <concord/discord.h>#include <concord/log.h>void on_ready(struct discord *client, const struct discord_ready *event) {log_info("%s としてログインしました!" 、イベント -> ユーザー -> ユーザー名);
}void on_message(struct discord *client, const struct discord_message *event) {if (strcmp(event->content, "ping") == 0) {struct discord_create_message params = { .content = "pong" };discord_create_message(client) 、イベント->channel_id、&params、NULL);
    }
}int main(void) {struct discord *client = discord_init(BOT_TOKEN);discord_add_intents(client, DISCORD_GATEWAY_MESSAGE_CONTENT);discord_set_on_ready(client, &on_ready);discord_set_on_message_create(client, &on_message);discord_run(client);
}

サポートされているオペレーティングシステム (最小要件)

GNU/Linux 4.x
FreeBSD 12
NetBSD 8.1
Windows 7 (Cygwin)
GNU/ハード 0.9
Mac OS X 10.9

注: SPARC Solaris、PowerPC AIX、System Z z/OS、Linux、または MIPS IRIX などの特定の OS を実行するビッグエンディアンプロセッサはサポートされていません。現在、ビッグエンディアンシステム上で一部のロジックが正しく動作しないという問題がいくつかあります。これはすぐに修正される予定です。

組み立て説明書

唯一の依存関係はcurl-7.56.1以降です。ソースから libcurl をコンパイルする場合は、SSL サポートを使用してビルドする必要があります。

Windows の場合

Cygwinのインストール
Cygwin インストーラーを実行したときに、libcurl、gcc、make、および git がインストールされていることを確認してください。
ここで Windows チュートリアルを確認してください。
Mingw64 と Msys2 は現在サポートされていません。詳しくはこちらをご覧ください。
インストールしたら、UNIX/Linux/OS X/BSD と同様に通常どおりコンパイルします。
注: gccコマンド、またはボットの Makefile のCFLAGS変数に-L/usr/local/lib -I/usr/local/include含める必要がある可能性があります。

Linux、BSD、および Mac OS X の場合

(注 -- # root として実行する必要があることを意味します)

Ubuntu と Debian

 # apt update && apt install -y libcurl4-openssl-dev

ボイド・リナックス

# xbps-install -S libcurl-devel

高山

# apk はカール開発を追加します

FreeBSD

 # pkg インストールカール

OS X

注: Xcode をインストールするか、少なくともxcode-select --installを使用してコマンドラインツールをインストールする必要があります。

 $ brew installcurl (Homebrew)$ port installcurl (MacPorts)

Arch Linux / Manjaro (Arch ベース)

 git clone https://aur.archlinux.org/concord-git.gitcd concord-gitmakepkg -Acspacman -U concord-git-version-any.pkg.tar.zst

あるいは、AUR ヘルパーを使用することもできます。

やったー -S concord-git

環境をセットアップする

Concord をワークスペースにクローン作成します

$ git clone https://github.com/cogmasters/concord.git && cd concord

Concord をコンパイルする

$メイク

非 Linux システムに関する特別な注意事項

コンパイラとリンカーが Libcurl ヘッダーを見つけられないという問題が発生する可能性があります。次のようなことができます。

 $ CFLAGS=-I<some_path> LDFLAGS=-L<some_path> make

たとえば、FreeBSD システムでは次のようになります。

 $ CFLAGS=-I/usr/local/include LDFLAGS=-L/usr/local/lib make

OS X で MacPorts を使用する場合:

 $ CFLAGS=-I/opt/local/include LDFLAGS=-L/opt/local/lib make

OS X では自己コンパイルされた libcurl を使用します。

 $ CFLAGS=-I/usr/local/include LDFLAGS=-L/usr/local/include make

Cygwin を使用する Windows では、POSIX スレッドを使用するために両方の引数を渡す必要がある場合があります。

 $ CFLAGS="-pthread -lpthread" make

Concord を別のライブラリにリンクする場合の特別な注意事項

場合によっては、Concord を共有オブジェクトにリンクしたり、共有オブジェクトとして別の共有オブジェクトにリンクしたりすることが必要になる場合があります。その場合、 CFLAGS="-fpic" make使用して Concord をコンパイルする必要があります。

Concordの設定

discord_config_init() は、再コンパイルせずにボットを構成できる初期化メソッドです。

以下に、 config.jsonフィールドの概要を示します。

 {
  "logging": { // ロギング ディレクティブ"level": "trace", // トレース、デバッグ、情報、警告、エラー、致命的"filename": "bot.log", // ログ出力ファイル"quit": false, // コンソールのログを無効にするには true に変更します。"overwrite": true, // すでにファイルが存在する場合は上書きし、そうでない場合は追加します。"use_color": true, // ログ エントリの色を表示します"http": { "enable": true, // http 固有のログを生成します。 "filename": "http.log" // HTTP ログ出力ファイル},"disable_modules": ["WEBSOCKETS", "USER_AGENT"] // これらのモジュールのログを無効にします
  }、
  "discord": { // discord directives"token": "YOUR-BOT-TOKEN", // ボットトークンに置き換えます"default_prefix": {
                       "enable": false, // デフォルトのコマンドプレフィックスを有効にする "prefix": "YOUR-COMMANDS-PREFIX" // プレフィックスに置き換えます}
  }、
  ... // ここでカスタムフィールドを追加できます *}

*カスタムフィールドの内容は discord_config_get_field() で取得できます

Copycat ボットのテスト

ボットトークンを取得し、それを discord の「トークン」フィールドに割り当てることで、 config.jsonに追加します。 discord-irc には、ボットトークンを取得してサーバーに追加する方法を説明する、よく書かれた手順が記載されています。
実行可能ファイルのサンプルをビルドします。
```
 $ サンプルを作成する
```
Copycat-Bot を実行します。
```
 $ cd 例 && ./copycat
```

Copycat-Bot 応答の取得

ボットが属しているチャネルにメッセージを入力すると、ボットはその正確なコピーを返信する必要があります。

Copycat-Bot を終了する

Ctrl + CまたはCtrl + |を使用します。

ビルドを構成する

以下に、デフォルトの Makefile ビルドを追加機能でオーバーライドするための特別なフラグとターゲットの概要を示します。

特別なコンパイルフラグ

-DCCORD_SIGINTCATCH

デフォルトでは、Concord は SIGINT を受信したとき (つまりCtrl + c ) に正常にシャットダウンしません。処理してもらいたい場合はこのフラグを有効にします。

-DCCORD_DEBUG_WEBSOCKETS

WebSocket 通信の詳細デバッグを有効にします。

-DCCORD_DEBUG_HTTP

HTTP 通信の詳細デバッグを有効にします。

例：

 $ CFLAGS="-DCCORD_SIGINTCATCH -DCCORD_DEBUG_HTTP"

特別なターゲット

make shared

Concord の動的にリンクされたバージョンを生成します。この Makefile は、 gccやclangなどの GNU スタイルのコンパイラを対象としています。

make shared_osx

OS X および Darwin システム用に、動的にリンクされたバージョンの Concord を作成します。

make voice

実験的な音声接続処理を有効にします - 本番環境には対応していません。

make debug

-O0や-gなど、開発中に役立ついくつかのフラグを有効にします。

Concordのインストール

(注 -- # root として実行する必要があることを意味します)

 # インストールを行う

これにより、ヘッダーとライブラリファイルが $PREFIX にインストールされます。これを次のようにオーバーライドできます。

 # PREFIX=/opt/concord make install

Concord のクロスコンパイル

Concord をクロスコンパイルするには、こちらのマニュアルを参照してください。

含まれる依存関係

以下は、Concord にパッケージ化されており、プロジェクトに含めることができるstable 、十分に文書化された依存関係です。

ファイル	説明
コグユーティリティ	可搬性を追求した汎用機能
log.c*	シンプルな C99 ロギングライブラリ
キャリー*	タイプセーフな配列のマクロベースの実装
アノマップ*	C99 のソートされたキー/値ストレージ
チャッシュ*	タイプセーフなハッシュテーブルのマクロベースの実装
json-ビルド	小さな、割り当てゼロの JSON シリアライザー
jsmn-find	小さな、割り当てゼロの JSON トークナイザー

* Concord は独自に修正されたバージョンを使用しており、元のバージョンとは最新でない可能性があります。

インクルードされるヘッダーにはconcord/プレフィックスが付く必要があることに注意してください。

 #include <concord/discord.h>#include <concord/log.h>

スタンドアロンの実行可能ファイル

GCC

 $ gcc myBot.c -o myBot -pthread -ldiscord -lcurl

クラン

$ clang myBot.c -o myBot -pthread -ldiscord -lcurl

UNIX C コンパイラ

これには次のコンパイラが含まれます。

IBM XL C/C++ (AIX、z/OS、IBM i)
Sun/Oracle Studio (Solaris)
IRIX MIPSpro C++ (IRIX) -- 注: 現在サポートされていません
HP aCC (HP-UX)
Compaq C (Tru64 UNIX) -- 注: これも現在サポートされていません注: 上記のシステムのいずれかでこれを実際にコンパイルしたい場合は、「古いコンピュータでのコンパイル」ガイドを参照してください。

 $ cc myBot.c -o myBot -ldiscord -lcurl -lpthread

注: Cygwinなどの一部のシステムでは、これを行う必要があります。

 $ gcc myBot.c -o myBot -pthread -lpthread -ldiscord -lcurl

(これは/usr/libの libpthread.a にリンクします)

推奨デバッガー

まず、実行可能ファイルが-gフラグを使用してコンパイルされていることを確認し、デバッガメッセージが人間に判読できるようにします。

ヴァルグリンド

valgrind を使用してメモリリークをチェックします。

 valgrind --leak-check=full ./myBot

より包括的なガイドについては、Valgrind のクイックスタートを確認してください。

GDB

GDB を使用して、セグメンテーション違反などの実行時エラーをチェックします。

 $ gdb ./myBot

次に、gdb 環境からボットを実行します。

 (gdb) 実行

プログラムがクラッシュした場合は、それに至るまでの関数呼び出しのバックトレースを取得します。

 (gdb)bt

より包括的なガイドについては、Beej の GDB クイックガイドを確認してください。

サポート

問題がありますか? Discordサーバーをチェックしてください

貢献する

あらゆる種類の貢献を歓迎します。私たちが求めるのは、ガイドラインに従うことだけです。支援したいがどこから始めればよいかわからない場合は、Discord API ロードマップが良い出発点となります。さらに役立つ情報については、リンクを確認してください。

はじめる

ドキュメント
Discord API ロードマップ

役立つリンク

V1 からの移行
Orca からの移行

拡大する

追加情報

バージョン v2.3.0
タイプ C# ソースコード
更新時間 2025-01-06
サイズ 858KB
から Github

concord