Difference between revisions of "LÖVE CÖNNECTION (日本語)"

m (イベント)
m
 
(5 intermediate revisions by the same user not shown)
Line 1: Line 1:
{{notice|このページは翻訳・修正途中です。正式版は機会を見て更新します。}}
+
LÖVE CÖNNECTION は [https://love2d.org/forums/viewtopic.php?t=80330 Nicholas Scott] (ニコラス・スコット) により開発および保守されているネットワーキング・モジュールです。
 
 
 
 
LÖVE CÖNNECTION は [http://steamcommunity.com/id/NicholasScott Nicholas Scott] (ニコラス・スコット) により開発および保守されているネットワーキング・モジュールです。
 
  
 
require() でモジュールが読み込まれたときに関数一覧テーブルが返されるため、 require で設定されたものは Net~ と等価であると想定します。
 
require() でモジュールが読み込まれたときに関数一覧テーブルが返されるため、 require で設定されたものは Net~ と等価であると想定します。
  
 
== 関数 ==
 
== 関数 ==
 
 
* Net:connectedUsers()'' -- 現在接続されている利用者の一覧を返します。''
 
* Net:connectedUsers()'' -- 現在接続されている利用者の一覧を返します。''
 
* Net:kickUser( id, reason )'' -- 指定された id により利用者を追い出してから現在の画面に理由を表示します。''
 
* Net:kickUser( id, reason )'' -- 指定された id により利用者を追い出してから現在の画面に理由を表示します。''
Line 13: Line 9:
 
* Net:isClient()'' -- クライアントが現在実行中ならば true を返します。''
 
* Net:isClient()'' -- クライアントが現在実行中ならば true を返します。''
 
* Net:setMaxPing( ping )'' -- クライアントに呼び出された場合は再びサーバーへ Ping を送信する前に Ping 時間の設定を行い、サーバー実行中に呼び出された場合はクライアントに対してタイムアウトになる前に最大 Ping (ミリ秒) 値を設定します。''
 
* Net:setMaxPing( ping )'' -- クライアントに呼び出された場合は再びサーバーへ Ping を送信する前に Ping 時間の設定を行い、サーバー実行中に呼び出された場合はクライアントに対してタイムアウトになる前に最大 Ping (ミリ秒) 値を設定します。''
* Net:init( state ) ''-- Starts the networking, state needs to be either server, to run as a server, or client, to run as a client''
+
* Net:init( state ) ''-- ネットワークを開始します。サーバとして、またはクライアントとしての実行、クライアントからの実行のいずれかのサーバ状態が必要です。''
* Net:update( dt )'' -- Add this into any '''ACTIVE''' love.update() and pass the deltatime from the love.update!! IMPORTANT!!!!''
+
* Net:update( dt )'' -- 全ての '''ACTIVE''' love.update() へ追加して、love.update からデルタタイムを引き渡してください!! 重要!!!''
* Net:connect( ip, port )'' --If called as server you must set ip to nil and port to the port you want to listen on, defaults to 20024, when called as client ip and port are required, and port msut be the same as the servers, obviously :D''
+
* Net:connect( ip, port )'' -- サーバから呼び出だされる場合は、 IP へ nil を、そして port へ接続待機を行うポート番号を設定する必要があります。デフォルトのポート番号は 20024 です。クライアントから呼び出だされる場合は IPアドレスおよびポートが必要です。そして、明らかなことですがポートはサーバと同じにする必要があります。 :D''
* Net:disconnect()'' -- クライアントからソケットの出力がすべて nil となったかサーバーに切断パケットが送信されたた場合は、オンラインから切断します。''
+
* Net:disconnect()'' -- クライアントからソケットの出力がすべて nil となったかサーバーに切断パケットが送信された場合は、オンラインから切断します。''
* Net:registerCMD( cmd, function )'' --Registers a command for networking, cmd is a string name of the command you want to register, and function is the function ran when a client( or server ) receives the command specified. More on this below :D''
+
* Net:registerCMD( cmd, function )'' -- ネットワークに対してコマンドを登録します。 cmd は登録したい文字列形式のコマンド名です。 function は指定されたコマンドを受信したときにクライアント(またはサーバ)で実行される関数です。詳細は後述します :D''
* Net:send( table, cmd, param, id )'' -- Id is only supplied if running as server, table is a table of data you want to send, cmd is the command your running on the other end, must be registered, param is parameters to the command, id is the id of the client you want to send to( only if server leave nil if client)''
+
* Net:send( table, cmd, param, id )'' -- id はサーバ実行中にのみ指定します。 table は送信したいデータの格納されているテーブルです。 cmd はコマンドであり通信先で実行されますが、登録されている必要があります。 param はコマンドの引数です。 id は送信をしたいクライアントの ID です (クライアントの場合はサーバーを nil にする場合に限ります)''
* Net:encode( table )'' -- Encodes a table of data into a string to be sent across the network''
+
* Net:encode( table )'' -- ネットワークを経由して送信する文字列データを有するテーブルをエンコードします。''
* Net:decode( string )'' -- Decodes a string into a table of data when received''
+
* Net:decode( string )'' -- 受信時に文字列データのテーブルをデコードします。''
  
 
== イベント ==
 
== イベント ==
 
''これらは <code>love.update ()</code> 関数を呼び出すのと同じ方法で呼び出されます。つまり、 <code>Net.event.server.userConnected( id ) ~ end</code> です。''
 
''これらは <code>love.update ()</code> 関数を呼び出すのと同じ方法で呼び出されます。つまり、 <code>Net.event.server.userConnected( id ) ~ end</code> です。''
 
  
 
=== クライアント・イベント ===
 
=== クライアント・イベント ===
 
 
* Net.event.client.connect( ip, port)'' -- net:connect() によりクライアントからサーバへ接続されたときに呼び出されます。 IP はサーバの IP アドレス、および port はサーバのポートです。''
 
* Net.event.client.connect( ip, port)'' -- net:connect() によりクライアントからサーバへ接続されたときに呼び出されます。 IP はサーバの IP アドレス、および port はサーバのポートです。''
 
* Net.event.client.receive( table, dt, cmd, param )'' -- クライアントがパケットを受信したときに呼び出されます。 table はクライアントから送信されたテーブルです。 id はクライアントの ID です。 dt は net:update() のデルタタイムです。 cmd はクライアントから送信されたコマンドです。 param はクライアントの引数です。''
 
* Net.event.client.receive( table, dt, cmd, param )'' -- クライアントがパケットを受信したときに呼び出されます。 table はクライアントから送信されたテーブルです。 id はクライアントの ID です。 dt は net:update() のデルタタイムです。 cmd はクライアントから送信されたコマンドです。 param はクライアントの引数です。''
Line 80: Line 74:
 
その 5: クライアントへあるパケットを送信します! :D これはサーバのコンソールから各クライアントへ "Hello There Mr. Client!" を表示します。
 
その 5: クライアントへあるパケットを送信します! :D これはサーバのコンソールから各クライアントへ "Hello There Mr. Client!" を表示します。
 
<source lang="lua">
 
<source lang="lua">
for id,playerdata in pairs( Net.users ) do Net:send( {}, "print", "Hello There Mr. Client!", id ) end  
+
for id,playerdata in pairs( Net.users ) do  
 +
    Net:send( {}, "print", "Hello There Mr. Client!", id )  
 +
end  
 
</source>
 
</source>
  
Line 107: Line 103:
 
その 5: サーバへあるパケットを送信します! :D これはサーバのコンソールへ "Hello There Mr. Server!" を表示します。 <code>{}</code> は空のテーブルですが、 NIL は必要なものであり除去してはいけません。
 
その 5: サーバへあるパケットを送信します! :D これはサーバのコンソールへ "Hello There Mr. Server!" を表示します。 <code>{}</code> は空のテーブルですが、 NIL は必要なものであり除去してはいけません。
 
<source lang="lua">
 
<source lang="lua">
Net:send( {}, "print", "Hello There Mr. Server!" )
+
Net:send( {}, "print", "Hello There Mr. Server!" )
 
</source>
 
</source>
 +
 +
[[Category:Libraries (日本語)]]
  
 
== そのほかの言語 ==
 
== そのほかの言語 ==
{{i18n|LÖVE_CÖNNECTION}}
+
{{i18n (日本語)|LÖVE_CÖNNECTION}}
 
 
[[Category:Libraries (日本語)]]
 

Latest revision as of 03:16, 16 December 2019

LÖVE CÖNNECTION は Nicholas Scott (ニコラス・スコット) により開発および保守されているネットワーキング・モジュールです。

require() でモジュールが読み込まれたときに関数一覧テーブルが返されるため、 require で設定されたものは Net~ と等価であると想定します。

関数

  • Net:connectedUsers() -- 現在接続されている利用者の一覧を返します。
  • Net:kickUser( id, reason ) -- 指定された id により利用者を追い出してから現在の画面に理由を表示します。
  • Net:isServer() -- サーバーが現在実行中ならば true を返します。
  • Net:isClient() -- クライアントが現在実行中ならば true を返します。
  • Net:setMaxPing( ping ) -- クライアントに呼び出された場合は再びサーバーへ Ping を送信する前に Ping 時間の設定を行い、サーバー実行中に呼び出された場合はクライアントに対してタイムアウトになる前に最大 Ping (ミリ秒) 値を設定します。
  • Net:init( state ) -- ネットワークを開始します。サーバとして、またはクライアントとしての実行、クライアントからの実行のいずれかのサーバ状態が必要です。
  • Net:update( dt ) -- 全ての ACTIVE を love.update() へ追加して、love.update からデルタタイムを引き渡してください!! 重要!!!
  • Net:connect( ip, port ) -- サーバから呼び出だされる場合は、 IP へ nil を、そして port へ接続待機を行うポート番号を設定する必要があります。デフォルトのポート番号は 20024 です。クライアントから呼び出だされる場合は IPアドレスおよびポートが必要です。そして、明らかなことですがポートはサーバと同じにする必要があります。 :D
  • Net:disconnect() -- クライアントからソケットの出力がすべて nil となったかサーバーに切断パケットが送信された場合は、オンラインから切断します。
  • Net:registerCMD( cmd, function ) -- ネットワークに対してコマンドを登録します。 cmd は登録したい文字列形式のコマンド名です。 function は指定されたコマンドを受信したときにクライアント(またはサーバ)で実行される関数です。詳細は後述します :D
  • Net:send( table, cmd, param, id ) -- id はサーバ実行中にのみ指定します。 table は送信したいデータの格納されているテーブルです。 cmd はコマンドであり通信先で実行されますが、登録されている必要があります。 param はコマンドの引数です。 id は送信をしたいクライアントの ID です (クライアントの場合はサーバーを nil にする場合に限ります)。
  • Net:encode( table ) -- ネットワークを経由して送信する文字列データを有するテーブルをエンコードします。
  • Net:decode( string ) -- 受信時に文字列データのテーブルをデコードします。

イベント

これらは love.update () 関数を呼び出すのと同じ方法で呼び出されます。つまり、 Net.event.server.userConnected( id ) ~ end です。

クライアント・イベント

  • Net.event.client.connect( ip, port) -- net:connect() によりクライアントからサーバへ接続されたときに呼び出されます。 IP はサーバの IP アドレス、および port はサーバのポートです。
  • Net.event.client.receive( table, dt, cmd, param ) -- クライアントがパケットを受信したときに呼び出されます。 table はクライアントから送信されたテーブルです。 id はクライアントの ID です。 dt は net:update() のデルタタイムです。 cmd はクライアントから送信されたコマンドです。 param はクライアントの引数です。
  • Net.event.client.disconnect() -- net:disconnect() によりサーバから切断されたときに呼び出されます。
  • Net.event.client.cmdRegistered( cmd, functionS ) -- コマンド登録されたときに呼び出されます。 cmd は登録されたコマンドであり、 function は cmd により呼び出だされる関数です。
  • Net.event.client.send( table, cmd, param ) -- サーバへパケットを送信するときに呼び出されます。 table は送信するテーブルです。 cmd はコマンドです。 param は引数です。
  • Net.event.client.kickedFromServer( reason ) -- 利用者がサーバーから強制的に退場させられた時に呼び出されます(クライアント)。 reason は利用者が退場させられた理由です。


サーバー・イベント

  • Net.event.server.userConnected( id ) -- 利用者がサーバーへ接続する時に呼び出されます。
  • Net.event.server.userDisconnected( id ) -- 利用者がサーバーから切断された時に呼び出されます。
  • Net.event.server.userTimedOut( id ) -- 利用者がサーバーからタイムアウトになった時に呼び出されます。
  • Net.event.server.userKicked( id, reason ) -- 利用者が強制的に退場させられた時に呼び出されます。 reason は利用者が退場させられた理由です。
  • Net.event.server.receive( table, dt, id, cmd, param ) -- パケットを受信したときに呼び出されます。 table はクライアントから送信されたテーブルです。 id はクライアントの ID です。 dt は net:update() のデルタタイムです。 cmd はクライアントから送信されたコマンドです。 param はクライアントの引数です。
  • Net.event.server.connect( port ) -- ポートへ接続されたときに呼び出されます。 port は接続先のポートです。
  • Net.event.server.disconnect() -- ポートからの切断およびパケットの受信待機停止状態になったときに呼び出されます。
  • Net.event.server.cmdRegistered( cmd, functionS) -- コマンド登録されたときに呼び出されます。 cmd は登録されたコマンドであり、 function は cmd により呼び出だされる関数です。
  • Net.event.server.send( table, cmd, param, id ) -- クライアントへパケットを送信するときに呼び出されます。 table は送信するテーブルです。 cmd は送信するコマンドです。 param は送信する引数です。 id はクライアントが送信する ID です。

変数・テーブル

  • Net.client = table -- 現在接続されているサーバの IPアドレスとポートを保持しており、未接続の場合は IPアドレスとポートは nil となります。
  • Net.server = table -- ポートが現在接続待機状態であるかを保持しており、接続待機状態でなければ nil となります。
  • Net.commands = table -- コマンド = 関数の形式で現在登録されている全てのコマンドを保持しています。コマンド編集用の関数は近いうちに公開予定です!
  • Net.users = table -- ID = PLAYERTABLE の形式で現在登録されている全ての遊戯者を保持しています。遊戯者テーブル編集用の関数は近いうちに公開予定です!
  • Net.maxPing = integer -- サーバー、あるいはクライアントにおける現在の最大 Ping 値です。
  • Net.connected = boolean -- サーバへ接続しているかポートが接続待機状態ならば true であり、それ以外は false です。

チュートリアル

サーバーの設定

その 1: モジュールを変数として定義します。

Net = require( "net" )

その 2: ネットワークを初期化します。

Net:init( "Server" )

その 3: パケットの受信待機をするためにポートへ接続します。

Net:connect( nil, 25045 )

その 4: 受信されたパケットに対してあるコマンドの登録を行います。 table は利用者によりエンコードされ、送信されたテーブルです。 :D このようにすると便利です

Net:registerCMD( "updateStatsOfPlayer", function( table, parameters, id, dt ) Net.users[id].name = table.name Net.users[id].color = table.color end )

その 5: クライアントへあるパケットを送信します! :D これはサーバのコンソールから各クライアントへ "Hello There Mr. Client!" を表示します。

 for id,playerdata in pairs( Net.users ) do 
    Net:send( {}, "print", "Hello There Mr. Client!", id ) 
 end


クライアントの設定

その 1: モジュールを変数として定義します。

Net = require( "net" )

その 2: ネットワークを初期化します。

Net:init( "Client" )

その 3: サーバへの接続を行います。これは接続機能の初期化も行い net:send() を使用可能にします。

Net:connect( "127.0.0.1", 25045 )

その 4: 受信されたパケットに対してあるコマンドの登録を行います。 table は利用者によりエンコードされ、送信されたテーブルです。 :D このようにすると便利です

Net:registerCMD( "updateStatsOfBattlefield", function( table, parameters, id, dt )Tank.x = table.x Tank.y = table.y Tank.name = table.name end )

その 5: サーバへあるパケットを送信します! :D これはサーバのコンソールへ "Hello There Mr. Server!" を表示します。 {} は空のテーブルですが、 NIL は必要なものであり除去してはいけません。

 Net:send( {}, "print", "Hello There Mr. Server!" )

そのほかの言語