iFun Engine Changelog¶

Important

1.0.0-3986 Stable 버전을 마지막으로 Ubuntu 14.04 (Trusty Tahr) 에 대한 지원을 종료합니다.

v1.0.0-4200 (2019-07-10)
v1.0.0-4177 (2019-07-05)
v1.0.0-3986 (2019-04-01)
v1.0.0-3948 (2019-03-08)
v1.0.0-3837 (2019-02-11)
v1.0.0-3820 (2019-02-07)
v1.0.0-3805 (2019-01-24)
v1.0.0-3790 (2019-01-09)
v1.0.0-3764 (2018-12-05)
v1.0.0-3686 (2018-11-02)
v1.0.0-3686 (2018-11-02)
v1.0.0-3624 (2018-10-10)
v1.0.0-3579 (2018-09-18)
v1.0.0-3553 (2018-09-05)
v1.0.0-3487 (2018-08-08)
v1.0.0-3468 (2018-08-01)
v1.0.0-2619 (2018-02-02)
v1.0.0-2591 (2018-01-12)
v1.0.0-2586 (2018-01-09)
v1.0.0-2582 (2018-01-05)
v1.0.0-2574 (2018-01-02)
v1.0.0-2570 (2018-01-02)
v1.0.0-2562 (2017-12-29)
v1.0.0-2558 (2017-12-28)
v1.0.0-2542 (2017-12-26)
v1.0.0-2517 (2017-12-07)
v1.0.0-2477 (2017-11-23)
v1.0.0-2458 (2017-11-13)
v1.0.0-2417 (2017-10-16)
v1.0.0-2410 (2017-10-12)
v1.0.0-2407 (2017-10-12)
v1.0.0-2404 (2017-10-11)
v1.0.0-2401 (2017-09-29)
v1.0.0-2377 (2017-09-21)
v1.0.0-2363 (2017-09-15)
v1.0.0-2337 (2017-09-04)
v1.0.0-2334 (2017-09-01)
v1.0.0-2312 (2017-08-25)
v1.0.0-2300 (2017-08-22)
v1.0.0-2292 (2017-08-22)
v1.0.0-2282 (2017-08-17)
v1.0.0-2256 (2017-08-10)
v1.0.0-2214 (2017-07-27)
v1.0.0-2164 (2017-06-27)
v1.0.0-2130 (2017-05-31)
v1.0.0-2086 (2017-05-10)
v1.0.0-2066 (2017-04-20)
v1.0.0-1945 (2017-02-06)
v1.0.0-1904 (2016-12-15)
v1.0.0-1894 (2016-12-13)
v1.0.0-1890 (2016-12-09)
v1.0.0-1853 (2016-11-21)
v1.0.0-1849 (2016-11-18)
v1.0.0-1841 (2016-11-15)
v1.0.0-1815 (2016-10-28)
v1.0.0-1809 (2016-10-26)
v1.0.0-1797 (2016-10-12)
v1.0.0-1795 (2016-10-11)
v1.0.0-1790 (2016-10-05)
v1.0.0-1782 (2016-09-28)
v1.0.0-1777 (2016-09-28)
v1.0.0-1763 (2016-09-22)
v1.0.0-1739 (2016-09-08)
v1.0.0-1694 (2016-08-18)
v1.0.0-1680 (2016-08-12)
v1.0.0-1651 (2016-08-02)
v1.0.0-1582 (2016-06-02)

v1.0.0-4200 (2019-07-10)¶

2019-07-10 10:30:20

Object¶

주키퍼 동작 관련 기능들의 안정성을 개선했습니다.

v1.0.0-4177 (2019-07-05)¶

2019-07-05 11:07:35

System¶

iFun Engien Centos 버전의 ResourceManager::Reload() 함수에서 사용하는 MariadbConnector 구현의 버전문제로 메모리 릭이 발생하는 문제를 수정했습니다.
ResourceManager::Reload() 함수가 enable_game_data_mysql 를 무시하는 문제를 수정했습니다.

v1.0.0-3986 (2019-04-01)¶

2019-04-01 20:25:06

Important

1.0.0-3986 Stable 버전을 마지막으로 Ubuntu 14.04 (Trusty Tahr) 에 대한 지원을 종료합니다.

Warning

Breaking Changes

다음 변경사항으로 인해 서버를 다시 빌드해야 합니다.¶

특수한 UTF-8 문자가 Key 에 포함되어 있을 때, FetchByXXX() 로 불러올 수 없는 문제를 수정했습니다.
Session 콤포넌트에 다음 함수를 추가했습니다.
- GetPingSamplingInterval() : ping_sampling_interval 설정을 조회.
- GetPingTimeout() : ping_timeout 설정을 조회.

Object¶

특수한 UTF-8 문자가 Key 에 포함되어 있을 때, FetchByXXX() 로 불러올 수 없는 문제를 수정했습니다.
ORM Object 를 Key 로 가져 올 때, 락을 획득 할 수 없는 경우 락을 휙득하기 위해 경합하는 로그를 출력하지 않는 문제를 수정했습니다.

ORM Object 를 Key 로 가져 올 때, 락을 획득 할 수 없는 경우에 필요하지 않는 Zookeeper 요청 및 Query 를 수행하는 것을 제거했습니다.

Utility¶

이제 base64 인코딩/디코딩 함수를 사용할 수 있습니다.
- 변환 함수를 사용하기 위해서는 funapi/utility/base64_helper.h 헤더 파일을 추가해야 합니다.

Network¶

Session 콤포넌트에 다음 함수를 추가했습니다.
- GetPingSamplingInterval() : ping_sampling_interval 설정을 조회.
- GetPingTimeout() : ping_timeout 설정을 조회.

misc.¶

이제 C# 이벤트 내에서 Unhandled Exception 이 발생했을 때 실행하는 Handler 를 등록할 수 있습니다.
- Event.SetUnhandledExceptionHandler(...) : 이 함수로 등록된 핸들러로 이벤트 실행 중의 Unhandled Exception 을 처리할 수 있습니다. 이 함수로 Exception 을 수신하면 해당 이벤트는 Abort 처리됩니다.

v1.0.0-3948 (2019-03-08)¶

2019-03-08 15:17:09

Important

Ubuntu 14.04 (Trusy Tahr) 에 대한 iFun 엔진 업데이트가 2019년 3월부로 종료되고, 18.04 (Bionic Beaver) 를 지원할 예정입니다.

Important

2019년 3월 7일부터 Google+ 와 관련된 모든 API 를 사용할 수 없습니다. 따라서, 본 버전부터 아이펀 엔진의 Google+ 관련 API 들은 사실상 동작하지 않으며 추후 완전히 삭제할 예정입니다. 계정 데이터 이전과 관련해 질문이 있거나 도움이 필요한 경우 funapi-support@ifunfactory.com 으로 연락 주시기 바랍니다.

Warning

Breaking Changes

다음 변경사항으로 인해 서버를 클린빌드 해야 합니다.¶

Mariadb Connector 에 연결에 장애가 발생했다고 판단할 때에 호출하는 핸들러를 추가했습니다.

데디케이티드 서버 호스트 매니저(이하 데디서버 호스트 매니저) 의 HTTP 메시지¶

규격을 변경했습니다.¶

확장성을 향상시키기 위한 방향으로 메시지 규격을 변경하였으며, 새 엔진 버전은 기존 데디서버 호스트 매니저와의 하위호환을 유지하지만, 추후 지원하지 않을 수 있기 때문에 데디서버 호스트 매니저와 엔진을 함께 업데이트 할 것을 권장합니다.

엔진 콤포넌트 중 MaintenanceService 가 기본적으로 비활성화 되도록¶

수정되었습니다.¶

MaintenanceService 를 사용하는 사용자께서는 MANIFEST 의존성에 MaintenanceService 를 추가 해 주시기 바랍니다.

리더보드의 점수를 삭제하는 API 인 DeleteScore 의 콜백 함수 인자를¶

수정했습니다.¶

리더보드의 점수를 삭제한 후 호출하는 ScoreDeletionResponseaHandler 콜백의 error 변수의 값이 의도와 반대로 전달되는 문제를 수정했습니다.
이제 리더보드 점수가 정상적으로 삭제되면 error 변수는 false 를 반환합니다.

Service¶

AccountManager 컴포넌트가 Redis RPC Backend 설정에서 동작할 때, 주기적으로 키를 갱신하는 동작을 비활성화하는 플래그를 추가했습니다.
- MANIFEST.json 파일의 RPC 항목 안에 rpc_redis_disable_key_refresh 플래그를 true 로 설정하면 AccountManager 관련 키 갱신 기능을 비활성화합니다(기본 값: false).
- 불필요한 동작이기 때문에 추후 완전히 제거할 예정입니다.
스팟 인스턴스 가격 조회 중 크래시할 수 있는 문제를 수정했습니다.
데디케이티드 서버 호스트 매니저(이하 데디서버 호스트 매니저) 의 HTTP 메시지 규격을 변경했습니다.
- 확장성을 향상시키기 위한 방향으로 메시지 규격을 변경하였으며, 새 엔진 버전은 기존 데디서버 호스트 매니저와의 하위호환을 유지하지만, 추후 지원하지 않을 수 있기 때문에 데디서버 호스트 매니저와 엔진을 함께 업데이트 할 것을 권장합니다.
데디케이티드 서버 콤포포넌트의 커스텀 콜백 호출이 매치 ID 로 직렬화되지 않는 문제를 수정했습니다.
- 이제 매치 ID 로 직렬화한 이벤트 위에서 콜백을 실행합니다.
이벤트 타임아웃 시 멀티캐스트 서버에 등록한 세션을 처리하지 않던 문제를 수정했습니다.
Google+ API 를 지원하는 모든 기능을 사용할 수 없도록 수정했습니다.

Object¶

생성 중인 ORM 오브젝트를 kReadLock 으로 가져 온 후 롤백하면서 충돌할 수 있는 문제를 수정했습니다.
ORM 기능에서 DB 연결에 장애가 발생하며 설정에 따라 점검 모드로 전환 또는 서버 종료 가 되도록 기능을 추가했습니다.
- DB 연결에 장애가 발생했는지 판단하기 위해서 db_connection_failure_threshold_time_in_sec 플래그를 추가했습니다.
- 기본값은 0이며, 기존과 동일하게 연결될 때까지 재시도합니다.
- 이 플래그 설정이 0 이상이면 설정한 시간을 넘어서는 동안 DB 연결이 복구되지 않으면 다음과 같이 동작합니다.
- MaintenanceService 컴포넌트가 있으면 점검 모드로 전환합니다.
- 그렇지 않을 경우 서버를 강제 종료합니다. 기본 값은 0 이며 기존과 동일하게 작동합니다.
ORM 에서 캐시에 데이터를 올릴 때, 낮은 확률로 해시값이 충돌할 수 있는 문제를 수정했습니다.
게임 서버 시작 시, ORM 데이터베이스 스키마 검증 속도를 개선했습니다.
- 검사에 필요한 여러 쿼리들을 한 번에 실행하게 변경했습니다.
게임 서버 시작 시, DB 스킴에 대한 전체 검사를 생략하는 기능을 추가했습니다.
- use_db_schema_simple_validation 을 true 로 설정하면 DB 스킴을
검사해야 할 때, 전체 Table 및 Procedure 에 대한 검사는 생략합니다. 만약, DB 스킴을 업데이트 해야 하는 상황에서 이 플래그가 설정되어 있다면, 오류 메시지를 출력하고 서버는 종료합니다.

Network¶

HTTP Transport 및 ApiService 를 사용할 때, 바디 길이가 http_max_body_bytes 설정보다 긴 경우 HTTP 응답코드 500 을 보내는 대신 413 (Payload Too Large) 을 보내도록 변경했습니다.
HTTP status code enum 값의 오타를 수정했습니다.
- kNonAuthoriativeInformation -> kNonAuthori t ativeInformation
새로운 SSL 활성화 플래그를 추가했습니다.
- use_ssl_on_{protocol}_{encoding} 대신 {protocol}_use_ssl 을 사용해주시기 바랍니다.
엔진 콤포넌트 중 MaintenanceService 가 기본적으로 비활성화 되도록
수정되었습니다.
- MaintenanceService 를 사용하는 사용자께서는 MANIFEST 의존성에 MaintenanceService 를 추가 해 주시기 바랍니다.
HTTP 로 등록되지 않은 메시지 타입을 수신할 때 Assert 에 걸려 충돌하는 문제를 수정했습니다.
서버를 종료할 때, IoService::Uninstall() 에서 멈출 수 있는 문제를 수정했습니다.
데디케이티드 서버 오케스트레이터 콤포넌트에서 호스트 매니저와의 연결에 실패했을 때 더 자세한 로그를 출력하도록 수정했습니다.

Management¶

C# 개발 환경에서 ApiService 의 API 로 보내는 데이터는 UTF-8 문자열만 허용하도록 변경했습니다.
- ApiService 포트로 바이너리 데이터를 수신하면 서버가 크래시하는 대신 415 (Unsupported Media Type) 코드를 반환합니다.
서버가 실행 중인 상태에서 점검 모드로 전활 할 수 있는 StartMaintenance() 함수가 추가되었습니다.
- 이 함수는 MaintenanceService 컴포넌트가 활성화 되어있어야 작동합니다.
ApiService 가 받은 body 데이터를 로그에 출력할 수 있도록 로그 레벨을 조정했습니다.
- api_service_logging_level 설정의 의미가 다음과 같이 변경됐습니다.
  - 0: 오류에 한해서만 로그를 출력합니다.
  - 1: 기존 2 와 같습니다. body 를 제외하고 출력합니다.
  - 2: 1 의 내용과 body 를 함께 출력합니다. UTF-8 문자열이 아닌 경우 앞 256 bytes 를 HEX 문자열로 출력합니다.

System¶

세션 닫힘 핸들러를 호출할 수 없거나, 세션 만료 핸들러가 NULL 세션을 받는 문제를 수정했습니다.
크래시 덤프에 덤프 생성을 위한 스택 프레임이 보여지는 것을 최소화했습니다.
크래시 발생 시 terminate called recursively 메시지가 대량으로 출력되는 문제를 수정했습니다.
이제 이벤트 타임아웃 핸들러를 두 개 이상 등록할 수 있습니다.
- 이벤트 타임아웃 발생 시 Event::RegisterTimeoutHandler() 에 등록한 핸들러들을 등록한 순서대로 호출합니다.
이벤트 이름을 가진 이벤트 내에서 Event::Invoke() 를 호출하면 이벤트 이름을 상속하도록 수정했습니다.
- 이벤트 이름이 있는 경우에만 이름을 상속합니다.
- 새로 생성된 이벤트의 이름은 <이벤트이름>_#<상속 횟수> 형식을 따릅니다.
- 상속 횟수는 1부터 시작합니다.

Leaderboard¶

리더보드의 점수를 삭제하는 API 인 DeleteScore 의 콜백 함수 인자를 수정했습니다.
- 리더보드의 점수를 삭제한 후 호출하는 ScoreDeletionResponseaHandler 콜백의 error 변수의 값이 의도와 반대로 전달되는 문제를 수정했습니다.
- 이제 리더보드 점수가 정상적으로 삭제되면 error 변수는 false 를 반환합니다.
MANIFEST 에 ‘leaderboard_implicit_start’ 설정을 추가했습니다.
- MANIFEST.json 파일의 LeaderboardClient 항목에 위의 설정을 추가한 후 true 로 설정하면 서버 시작 시에 리더보드에 연결 할 수 없더라도 서버가 동작합니다.
- 이후 엔진은 주기적으로 리더보드 연결을 시도하며 연결하기 전에 호출하는 리더보드 함수들은 모두 실패를 반환합니다.

Database¶

Mariadb Connector 가 요청한 쿼리가 일정 시간 이상 경과해도 끝나지 않으면 로그를 출력하도록 추가했습니다.
- Mariadb Connector 의 Create() 함수에 slow_query_logging_time_in_ms 를 인자로 전달할 수 있습니다.
- 기본값은 5000 ms 입니다.
Mariadb Connector 에 연결에 장애가 발생했다고 판단할 때에 호출하는 핸들러를 추가했습니다.
- Mariadb Connector 를 사용할 경우 서버를 다시 빌드해야 합니다.
Mariadb::Create() 의 default 인자의 값에 해당하는 상수 정의가 추가되 었습니다.
- kDefaultConnectionCharset, kDefaultAutoRetryOnDeadlock, kDefaultClientFlags,
- kDefaultSlowQueryLoggingTime, `kDefaultConnectionFailureHandler
서버 종료가 1분가량 지연될 수 있는 문제를 수정했습니다.

Distribution¶

Redis 를 RPC 백엔드로 사용하는 환경에서 AccountManager 의 키 관리 방식을 개선했습니다.
- 오브젝트 락 해제 메커니즘과 동일하게, AccountManager 컴포넌트가 등록한 계정 정보 키를 미처 삭제하지 못하고 서버를 종료한 경우 마스터가 이를 찾아 삭제합니다.
- 확인 주기는 rpc_redis_session_timeout_in_seconds (기본 값: 10초) 설정을 따릅니다.
네트워크에 장애가 발생했을 때, RPC 연결의 안정성 개선
RPC 연결이 완전히 정리되지 않은 상태에서 재연결을 수행할 때 무시하는 문제 를 수정했습니다.

Billing¶

biller_implicit_start 설정을 추가했습니다.
- MANIFEST.json 파일 내 BillingClient 항목에 이 설정을 추가하고 true 로 설정하면 빌러 연결 없이 엔진을 시작할 수 있습니다.
- 이후 엔진은 주기적으로 Biller 서버에 연결을 시도하며 연결하기 전에 호출하는 빌러 함수들은 모두 실패를 반환합니다.

Framework¶

세션 연결 및 메시지 전송과 관련한 로그 메시지 내용을 개선했습니다.
- 이제 언어 설정에 따라 한국어로 된 로그 메시지를 볼 수 있습니다.
크래시할 때 덤프 파일이 안 남을 수 있는 문제를 수정했습니다.
이벤트 처리 중 크래시하여 종료 될 때 이벤트 이름이 로그에 출력되지 않을 수 있는 문제를 수정했습니다.

misc.¶

C# ApiService.RegisterHandler 함수의 URI 인자에 대한 검사를 개선했습니다.
- URI 인자 마지막에 / 가 없는 경우 추가하도록 변경했습니다.
- 이 수정으로 `/`이 없는 API URI 를 등록할 경우 API 를 찾지 못하는 문제를 해결합니다.
데디서버 호스트 매니저가 출력하는 로그 메시지를 개선했습니다.
- 더 많은 로그를 출력합니다.
- verbose 플래그를 활성화하면 상세 내역까지 출력합니다.
데디서버 호스트 매니저 기동할 때, 초기화에 실패하면 초기화 시 생성했던 프로세스를 종료합니다.
서버가 크래시하여 종료되면 GDB 로 콜스택을 확인 할 수 있는 명령어를 출력합니다.
정상 종료(SIGTERM, SIGQUIT 등) 일 때도 크래시로 표시되는 문제를 수정했습니다.

v1.0.0-3837 (2019-02-11)¶

2019-02-11 16:26:17

Service¶

Google+ API 사용 시 에러 로그를 출력합니다.
- 2019년 3월 7일에 Google+ 와 관련된 모든 API 가 삭제됩니다. 만약 게임 서버에 Google+ 관련 인증 로직이나 코드가 있다면 3월 7일 전까지 모두 제거해주시기 바랍니다. 계정 데이터 이전과 관련해 질문이 있거나 도움이 필요한 경우 funapi-support@ifunfactory.com 으로 연락 주시기 바랍니다.

Network¶

Session Reliability 기능 사용 시 간혈적으로 세션을 종료하는 문제를 수정했습니다.
- experimental 3782 이후 버전부터 발생할 수 있습니다.

v1.0.0-3820 (2019-02-07)¶

2019-02-07 13:52:36

Important

Ubuntu 14.04 (Trusy Tahr) 에 대한 iFun 엔진 업데이트가 2019년 3월부로 종료되고, 18.04 (Bionic Beaver) 를 지원할 예정입니다.

Distribution¶

레디스 기반 RPC 서비스를 사용하는 경우, ORM 관련 Key 들을 주기적으로 갱신하는 기능을 끌 수 있는 설정을 추가했습니다.
- ORM 관련 Key 들을 주기적으로 갱신하는 기능을 끄기 위해서는 MANIFEST.json 파일의 RPC 항목의 하위 설정인 rpc_redis_disable_key_refresh 플래그를 true 로 설정하면 됩니다. (기본값: false)
- ORM 관련 Key 갱신 기능은 cache_expiration_in_ms 설정에 설정된 주기로 동작하며, 더 이상 엔진의 동작에 아무런 영향을 주지 않기 때문에 가까운 미래에 삭제 할 예정입니다.
- 이 기능을 비활성화하면 일정 주기마다 발생하는 부하를 크게 줄일 수 있습니다.
레디스 기반 RPC 서비스를 사용하면서 전체 Key 를 삭제할 경우 멈추는 문제 수정
- 레디스의 flushall 명령을 수행했을 때, 의도한 대로 종료하지 않는 문제를 수정했습니다.
레디스 기반 RPC 서비스를 사용하는 경우, 서버를 종료할 때 키가 추가될 수 있는 문제 수정

Network¶

닫힌 세션으로 클라이언트를 리다이렉션하는 경우, 충돌하지 않고 경고를 출력하도록 수정했습니다.
- use_session_reliability 기능을 활성화 한 경우 충돌했으나, 더 이상 충돌하지 않습니다.
Session 및 Transport 객체 사용과 관련한 로그를 시스템 언어 설정에 따라 출력하고, 내용을 알기 쉽게 수정했습니다.
Transport 연결 및 옵션과 관련한 로그를 시스템 언어 설정에 따라 출력하고, 내용을 알기 쉽게 수정했습니다.
HttpClient 객체 사용과 관련한 로그를 시스템 언어 설정에 따라 출력하고, 내용을 알기 쉽게 수정했습니다.
소켓 사용과 관련한 로그를 시스템 언어 설정에 따라 출력하고, 내용을 알기 쉽게 수정했습니다.

System¶

Event 와 관련한 로그를 시스템 언어 설정에 따라 출력하고, 내용을 알기 쉽게 수정했습니다.

misc.¶

로그 디렉터리가 있는 파티션의 저장 공간이 없으면, 서버 실행에 실패하도록 수정했습니다.

v1.0.0-3805 (2019-01-24)¶

2019-01-24 13:41:02

Warning

Breaking Changes

CentOS 7 패키지 저장소 업데이트 이후에는 반드시 이 엔진 버전을 사용해야 합니다.¶

CentOS 7 패키지 저장소(YUM) 업데이트 시 아이펀 엔진에서 사용하는 패키지와 충돌하는 문제를 수정했습니다.

misc.¶

CentOS 7 패키지 저장소(YUM) 업데이트 시 아이펀 엔진에서 사용하는 패키지와 충돌하는 문제를 수정했습니다.
- 이 문제는 CentOS 7 버전에서만 발생하며 우분투를 사용 중이시면 무시해도 됩니다.
- 만약 엔진 버전을 업데이트할 수 없는 상황이라면 다음 명령어로 충돌하는 패키지들의 업데이트를 막을 수 있습니다.
  
  $ sudo yum update –exclude=libwebsockets,libwebsockets-devel,libsodium
  
  또는 /etc/yum.conf 파일을 열어 다음 구문을 추가해주셔도 됩니다.
  
  exclude=libwebsockets-* libsodium
- 이미 저장소 업데이트를 하여 문제가 발생하는 경우, 슬랙 채널 또는 funapi-support@ifunfactory.com 로 연락주시면 자세히 안내해드리겠습니다.

v1.0.0-3790 (2019-01-09)¶

2019-01-08 17:05:48

Important

Ubuntu 14.04 (Trusy Tahr) 에 대한 iFun 엔진 업데이트가 2019년 3월부로 종료되고, 18.04 (Bionic Beaver) 를 지원할 예정입니다.

Warning

Breaking Changes

다음의 변경 사항은 클라이언트 플러그인도 함께 업데이트 해야합니다.¶

AccountManager 와 Redict 기능에서 웹소켓을 지원하도록 수정하였습니다.

다음의 변경 사항을 적용하기 위해서 모든 엔진 패키지를 업데이트하고,¶

프로젝트를 다시 빌드해야 합니다.¶

ORM 에서 복합키를 정의할 때, 키들의 나열 순서가 알파벳 역순이면 DB 생성에 실패하는 문제를 수정하기 위해 오브젝트 모델 핑거프린트를 계산하는 방식을 변경했습니다.
RPC 백엔드로 Redis 를 사용하는 경우, 오브젝트 관리 매커니즘을 변경했습니다.
- 변경 전: 서버들은 자신의 오브젝트 락을 유지하기 위해 30초마다 Redis 명령을 전송. (소유한 서버가 정리)
- 변경 후: Redis RPC 를 사용하는 서버들 중 Master 를 선정하고, 이 서버는 주기적으로 연결이 끊어진 서버를 찾아서 그 서버가 소유하는 모든 오브젝트 락을 해제. (다른 서버가 정리)
- 연결이 끊어진 서버를 찾는 주기는 ‘rpc_redis_session_timeout_in_seconds(기본 값: 10초)’ 값으로 설정합니다.

Distribution¶

RPC 메시지를 보낼 때, 직렬화 태그를 지정할 수 있는 기능을 추가했습니다.
- 이전 버전에서 모든 RPC 메시지는 하나의 흐름으로 직렬화 되었으나 이번 수정으로 메시지를 보낼 때 설정한 태그를 기준으로 여러 흐름으로 직렬화 할 수 있게 됐습니다.
RPC 백엔드로 Redis 를 사용하는 경우, 오브젝트 관리 매커니즘을 변경했습니다.
- 변경 전: 서버들은 자신의 오브젝트 락을 유지하기 위해 30초마다 Redis 명령을 전송. (소유한 서버가 정리)
- 변경 후: Redis RPC 서버들 중 Master 를 선정하고, 이 서버는 주기적으로 연결이 끊어진 서버를 찾아서 그 서버가 소유하는 모든 오브젝트 락을 해제. (다른 서버가 정리)
- 연결이 끊어진 서버를 찾는 주기는 ‘rpc_redis_session_timeout_in_seconds(기본 값: 10초)’ 값으로 설정합니다.

Network¶

서버에서 WebSocket 트랜스포트를 사용할 때, ife1 / chacha20 / AES-128 알고리즘을 사용할 수 있도록 수정하였습니다.
Unity 에서 WebGL 플랫폼을 사용하는 클라이언트를 지원하기 위해서 CORS (Cross Origin Resource Sharing) 규격을 지원하기 위한 설정을 추가했습니다.
- http-cors-configuration 를 참고하시기 바랍니다.
메시지 압축 기능을 사용할 경우 서버 시작 시 관련 로그를 출력하도록 변경했습니다.
아이펀 엔진에서 세션을 닫을 때 간헐적으로 마지막 메시지를 누락하는 문제를 수정하였습니다.
세션 메시지 핸들러 후킹 내용 중, Pre 메시지 후킹 함수가 event 실행 전에 호출하도록 수정했습니다.

Warning

이번 수정으로 내부 구현이 바뀌어 pre 메시지 후킹 함수 내에서 더 이상 ORM 을 직접 호출할 수 없습니다. Event::Invoke 를 사용하여 ORM을 호출하는 코드를 이벤트 내부에서 실행 될 수 있도록 변경해야 합니다.

Database¶

이제 Database 와 연결이 유휴상태(IDLE) 일 때, 끊어질 때까지 기다리지 않고 연결을 유지하기 위해서 다음과 같은 동작을 수행합니다.
- 마지막으로 쿼리를 실행한 지 30초가 지난 경우
- 서버로 간단한 쿼리를 전송해 연결이 끊어지지 않게 합니다.
use_db_char_type_for_object_id 를 설정했을 때, Object::FetchRandomly() 함수가 정상적으로 동작하지 않는 문제를 수정했습니다.
RedisClient 객체도 Redis Sentinel 을 지원합니다.
- Redis 객체는 MANIFEST 의 Redis 설정에 따라서 Sentinel 을 지원하지만, RedisClient 객체는 객체 생성 시에 인자로 설정합니다.
- 아이펀 엔진의 RPC 백엔드로 zookeeper 대신 redis 를 사용하는 경우, 내부적으로는 RedisClient 객체를 사용하기 때문에 이번 수정으로 Sentinel 을 지원합니다.

Object¶

ORM 에서 복합키를 정의할 때, 키들의 나열 순서가 알파벳 역순이면 DB
생성에 실패하는 문제를 수정하기 위해 오브젝트 모델 핑거프린트를 계산하는 방식을 변경했습니다.

System¶

AccountManager 와 Redis 기능에서 웹소켓을 지원하도록 수정하였습니다.
언어 설정에 따라 한국어로 된 메시지를 볼 수 있도록 부분적으로 수정을 진행하고 있습니다.

misc.¶

클라이언트가 접속할 데디케이티드 서버의 IP를 지정할 수 있도록 수정했습니다.
- 이제 호스트 매니저의 funapi-dedicated-server-host.flag 파일에 game_ip 를 설정할 수 있습니다.
데디케이티드 서버 호스트 매니저에서 Redis 인증 정보를 설정할 수 있습니다.

v1.0.0-3764 (2018-12-05)¶

2018-12-05 06:31:56

Important

Ubuntu 14.04 (Trusy Tahr) 에 대한 iFun 엔진 업데이트가 2019년 3월부로 종료되고, 18.04 (Bionic Beaver) 를 지원할 예정입니다.

Warning

Breaking Changes

다음 변경 사항으로 인해 프로젝트를 다시 빌드해야 합니다.¶

funtest 모듈을 사용해서 TCP SSL 연결을 맺을 수 있습니다.
- funtest::ConnectTcp() 함수의 인자로 use_ssl(기본값:false) 파라미터가 추가되었습니다.
- funtest 모듈을 사용하는 프로젝트는 프로젝트를 다시 빌드해야 합니다.

Billing¶

funapi-biller 에 요청을 보내고 일정 시간동안 응답이 없으면 타임아웃 처리하도록 수정했습니다.
- 이제 funapi-biller 가 정상적으로 응답하지 않는 상황에서 응답을 무한정 기다리지 않습니다.
- MANIFEST.json 파일 안의 BillingClient 항목에서 biller_request_timeout_seconds(기본 값: 30) 을 통해 값을 변경할 수 있습니다.
funapi-biller 요청과 관련한 오류 메시지를 업데이트했습니다.

Leaderboard¶

funapi-leaderboard 에 요청을 보내고 일정 시간동안 응답이 없으면 타임아웃 처리하도록 수정했습니다.
- 이제 funapi-leaderboard 가 정상적으로 응답하지 않는 상황에서 응답을 무한정 기다리지 않습니다.
- MANIFEST.json 파일 안의 LeaderboardClient 항목에서 leaderboard_request_timeout_seconds(기본 값: 30) 을 통해 값을 변경할 수 있습니다.
funapi-leaderboard 요청과 관련한 오류 메시지를 업데이트했습니다.

Database¶

RedisClient 객체의 동기 함수 사용 시 특정 상황에서 이벤트 전체가 멈출 수 있는 버그를 수정했습니다.
- 이 문제는 invoke_as_event 옵션을 true 로 생성한 RedisClient 객체에 대해서 여러 이벤트에서 동시에 동기 함수를 호출 할 때 간헐적으로 발생합니다.
DB 연결 시, DB 서버에서 Too many connections 오류를 받으면 크래시 할 수 있는 문제를 수정했습니다.
DB 에서 에러가 발생했지만 DB 클라이언트 라이브러리의 처리를 거치면서 오류 정보를 얻을 수 없는 경우 알 수 없는 오류 로그를 출력하도록 수정했습니다.

Service¶

리더보드를 사용하도록 설정하지 않은 상태에서 관련 기능을 사용하면 WARNING 로그를 출력하도록 수정했습니다.
인증 서비스를 테스트 모드로 사용 할 때 출력되는 로그를 알기 쉽게 개선했습니다.

Network¶

서버에서 TCP 와 HTTP 프로토콜을 지원하는 경우, 서버 시작 시에 SSL 옵션의 활성화 여부를 출력하도록 수정했습니다.
서버 시작 시, TCP, UDP, HTTP 각각에 대해서 BIND할 네트워크 인터페이스를 지정할 수 있게 되었습니다.
- 이제 TCP와 UDP 가 포트 뿐만 아니라 분리된 네트워크 인터페이스 위에서 동작하도록 설정할 수 있습니다.

Dedicated Server Manager¶

AWS 의 스팟 인스턴스를 사용하는 경우, 인스턴스 당 이용 요금의 상한 금액을 지정할 수 있습니다.
- 스팟 인스턴스는 AWS 에 의해서 수시로 가격이 변하며, 고정 요금이 책정되는 온디맨드 인스턴스의 요금을 넘어 설 수 없습니다. 그러나, 온디맨드 인스턴스 요금 보다 낮은 요금에서 더 이상 호스트를 생성하고 싶지 않을 때에 유용할 것입니다.
- 스팟 인스턴스의 요금이 장기간 높은 가격을 유지하는 경우 가용 호스트가 부족할 수 있으니 주의하시기 바랍니다.

misc.¶

이제 호스트의 언어를 한글로 설정하면, 에러 메시지를 한글로 볼 수 있습니다.
- 기능 별로 한글로 출력되지 않는 부분이 남아 있습니다. 앞으로 지속적으로 추가될 예정입니다.
C# 프로젝트에서 flavor 를 설정하고 생성한 데비안(deb) 패키지를 설치할 수 없는 문제를 수정했습니다.

v1.0.0-3686 (2018-11-02)¶

2018-11-02 11:14:56

Framework¶

JSON 해석할 때 UTF-8 BOM 무시하게 하는 옵션 추가
- fun::Json::FromStringWithComments , FromStreamWithComments 는 이제 지원을 중단(deprecated)했습니다. fun::Json::FromString , fun::Json::FromStream 에 kAllowComment 옵션을 추가하면 기존과 동일하게 사용할 수 있습니다.

Time¶

WallClock::FromTimestring() 함수 동작을 개선했습니다.
- 파싱 값을 저장할 변수가 NULL 인 경우 적절한 에러 메시지를 출력합니다.

v1.0.0-3686 (2018-11-02)¶

2018-11-02 11:14:56

Framework¶

JSON 해석할 때 UTF-8 BOM 무시하게 하는 옵션 추가
- fun::Json::FromStringWithComments , FromStreamWithComments 는 이제 지원을 중단(deprecated)했습니다. fun::Json::FromString , fun::Json::FromStream 에 kAllowComment 옵션을 추가하면 기존과 동일하게 사용할 수 있습니다.

Time¶

WallClock::FromTimestring() 함수 동작을 개선했습니다.
- 파싱 값을 저장할 변수가 NULL 인 경우 적절한 에러 메시지를 출력합니다.

v1.0.0-3624 (2018-10-10)¶

2018-10-10 09:53:38

Network¶

서버 시작과 관련된 로그 규칙 수정
HttpServer, HttpSocket 에서 Undefined Behavior 가 발생하는 문제 수정

Service¶

AccountManager 에서 RedirectClient 시 서버의 rpc tags 도 같이 반환하게 수정
스팟 인스턴스 기능 추가

System¶

AWS 환경에서 IPv4 주소 얻을 때 호스트 이름도 같이 얻게 수정

misc.¶

funtest 압축 기능 추가
이제 웹소켓 프로토콜을 funtest에서 사용할 수 있습니다.
이제 C#에서 InstallJsonMessageChecker() 함수를 사용할 수 있습니다.
이제 C#에서 InstallProtobufMessageChecker() 함수를 사용할 수 있습니다.

v1.0.0-3579 (2018-09-18)¶

2018-09-18 06:36:47

Service¶

3553 stable에서 빌드한 클라이언트 dll 사용 시 에러가 발생하는 문제 수정

v1.0.0-3553 (2018-09-05)¶

2018-09-05 10:55:09

Object¶

ORM: 지연 업데이트 기능 사용 시 맵 요소 생성, 삭제가 지연 반영되는 문제 수정
ORM: 지연 업데이트 기능 사용 시 배열 요소 생성, 삭제가 지연 반영되는 문제 수정

Distribution¶

레디스 기반 분산 환경에서 키 삭제 시 서버가 멈출 수 있는 버그 수정

Network¶

session reliability 를 사용할 때 send queue threshold 를 수정할 수 있도록 변경

misc.¶

funtest C#: 정수형 메시지 타입 핸들러 추가
funtest C#: 정수형 메시지 타입 SendMessage 추가

v1.0.0-3487 (2018-08-08)¶

2018-08-08 10:40:00

Network¶

압축 기능 사용할때 에이전트와 통신이 실패하는 문제 수정

v1.0.0-3468 (2018-08-01)¶

2018-08-01 14:18:46

Warning

Breaking Changes

다음의 변경 사항으로 인해 연결되는 모든 서버의 엔진 업데이트가 필요합니다.¶

RPC: 서버간 연결 관련 처리 개선.

다음의 변경 사항으로 인해 서버를 다시 빌드해야 합니다.¶

RedisClient: Create() 할 때 database 선택할 수 있도록 수정.
Maraidb Connector 에 Client Flags 를 설정할 수 있게 수정
영수증 검증 시 product 구매 정보가 없는 경우에 대한 에러코드 추가
영수증 검증 시 트랜잭션 id를 가져올 수 있도록 추가 인터페이스 제공
ArrayRef에 IList<T>를 지원 인터페이스 추가(C#)

다음의 변경으로 Custom API 를 사용하는 경우 다시 빌드해야 합니다.¶

아이펀 디플로이의 드랍다운 리스트 기능 사용 가능하게 수정

다음의 변경으로 iFun Biller Stable 1.0.0-2564 버전 이상으로 업데이트가 필요할 수 있습니다.¶

영수증 검증 시 트랜잭션 id를 가져올 수 있도록 추가 인터페이스 제공

다음의 변경으로 DSM 기능 이용 시 아래 작업이 필요합니다.¶

데디케이티드 서버 매니저 컴포넌트에서 image_id 를 변경했을 때 인스턴스들을 식별하지 못하는 문제가 수정되었습니다.

다음의 변경으로 코드 수정이 필요할 수 있습니다.¶

ProgressCallback 에 JSON match_context 인자가 추가
ProgressCallback의 MatchContext 정보가 삭제되고 새로운 콜백(ProgressCallback2)이 추가됐습니다.
- MatchContext를 계속 사용하려면 ProgressCallback2의 Match 정보를 사용하면 됩니다.
UpdateMatchPlayerContext C++ 함수가 추가되었습니다.
- 이 함수는 매치메이킹 대기열에 있는 플레이어의 컨텍스트(Json)를 변경할 때 사용합니다.
TStore Interface를 OneStore 인터페이스로 변경
- 기존의 TStore 인터페이스는 deprecated 처리되었습니다. MakeTStoreReceipt 함수를 MakeOneStoreReceipt 함수로 변경하셔야 합니다.

Service¶

World 기능 추가
World 범위 검색 알고리즘 개선
WorldManager::Create() 함수의 zone 인자를 Json 에서 ZoneVector 로 변경
WorldManager::Create() 함수에 index_block_length 인자 추가
World Channel 지원
world 에서 distance 대신 distance_square 를 받는 함수들 추가.
World::Object 에 mutex 락 추가
World::Object 의 ID 를 생성자의 인자로 받아 임의로 할당할 수 있도록 수정
World::InsertObject() 가 ID 가 중복될 때 Assert 대신 0 을 반환하도록 수정
World::Object 가 Point 뿐만 아니라 Sphere 도 될 수 있도록 수정
World 의 모든 Object 를 가져오는 World::GetAllObject() 추가
World::Find*2() 제거 및 FindOption 을 받아 동일한 처리를 대신하도록 수정
World 의 Find*() 의 거리 계산 시 Sphere 의 중심을 기준으로 하는 옵션 추가
World::Find*(), World::Broadcast() 함수들이 기준 좌표 대신 Object ID 를 받을 수 있는 기능 추가
World 의 Find*() 에 정렬, 범위 검색 옵션 추가
World::Broadcast() 함수 인자에 FindOption 추가
World::FindObject() 가 Filter 함수를 받을 수 있도록 개선
World::FindObject() 를 위한 Type Filter 추가
World 내의 특정 Type Object 유무를 통지 받을 수 있는 기능 추가
World::MakeRectangleFilter() 추가
World::MakeCircularSectorFilter() 추가
World 의 boundary 검색 시 option 에 지정된 수 보다 더 많이 검색되는 버그 수정
World::InsertStaticObject, World::FindStaticObject 추가
World::FindObject() 에서 distances 인자가 NULL 일 때 Filter 를 쓰면 크래시하는 버그 수정
WorldManager::Create/Get/FindServer 함수의 channel 인자 위치 변경
다른 서버와 공유하지 않는 World 지원
World 삭제 기능 추가
World 를 MANIFEST 에 기술하여 생성할 때 Channel 과 Local 여부를 설정할 수 있게 수정
World::MonitorTypeExistence() 버그 수정
World::GetName() 추가
World 사각형, 부채꼴 내장 필터가 입력 높이가 음수이면 무한대로 처리하도록 수정
World 사각형, 부채꼴 필터의 무한대 높이 처리의 잘못된 Assert 제거
DSM: OAuth 토큰 획득에 실패하면 콜백 오류 처리하게 수정
Matchmaking: ProgressCallback 에 JSON match_context 인자 추가.
World 부채꼴 필터의 각도 계산 오류 수정
World 의 부채꼴 필터 버그 수정
월드에서 부채꼴 필터가 구체를 검색할 수 있도록 추가
FindObject에서 FindOption을 사용 시 Z 축을 무시하는 옵션 추가
World 사각형 필터에 구체 검사 추가
World Object가 구체인지 검사하는 함수와 반지름을 얻는 함수 추가
RPC Redis backend 일 때 간헐적으로 서버 종료 안되는 문제 수정.
DSM 에서 JWT 토큰 확인할 수 있는 콜백 함수 추가
TStore Interface를 OneStore 인터페이스로 변경
World에서 MoveObject, MoveObjectTo가 bool을 반환하도록 수정
World 내의 모든 세션에게 메시지를 보내는 기능 추가
World GetAllObject가 Type으로 필터할 수 있는 기능 추가
World에서 삭제된 오브젝트를 다시 삭제할 때 ASSERT 제거
DSM Region별 인스턴스 통계 API 추가
DSM Region별 서버 사용량 평균, 표준편차 API 추가
DSM에서 생성/종료된 EC2 인스턴스 수를 가져올 수 있는 API 추가
DSM 퍼포먼스 카운터 API에서 JWT 인증을 지원하도록 변경
DSM 인스턴스 버전 태깅 기능 추가
DSM에서 실행 중인 EC2 호스트 수가 1개로 고정되는 문제 수정
DSM 호스트 버전이 명시된 경우 최신 버전만 사용하도록 변경
DSM 인스턴스 버전이 명시된 경우 확장시 항상 최신 버전을 사용하도록 변경
리셋 시간 전에 리더보드를 조회할 경우 assert가 발생할 수 있는 문제 수정
리더보드 최초 리셋 전에 스케줄을 조회할 때 잘못된 정보를 받는 문제 수정
2663 experimental에서 DSM 호스트 버전을 인식하지 못하는 문제 수정
World GetAllObject에 오브젝트 필터 추가
DSM에서 사용 중인 Redis 키가 삭제될 경우에도 복구될 수 있도록 변경
DSM: AWS 설정의 user_data 를 파일에서 읽을 수 있게 수정
ProgressCallback의 MatchContext 정보가 삭제되고 새로운 콜백(ProgressCallback2)이 추가됐습니다.
- MatchContext를 계속 사용하려면 ProgressCallback2의 Match 정보를 사용하면 됩니다.
UpdateMatchPlayerContext C++ 함수가 추가되었습니다.
- 매치메이킹 대기열에 있는 플레이어의 컨텍스트(Json)를 변경할 때 사용합니다.
C# 매치메이킹 완료 시 크래시가 발생하던 문제가 수정됐습니다.
클라이언트 리소스 파일을 필터링할 수 있는 .funignore 파일이 추가되었습니다.
- 필터링 기능은 funapi_client_resource_generator 및 엔진의 클라이언트 리소스 기능에서 사용 가능하며 .funignore 파일 안에 정의된 Perl 정규 표현식 패턴과 일치하는 파일들을 리소스 목록에서 제외합니다.
매치메이킹 ProgressCallback2에서 Match context가 누락되는 문제 수정
데디케이티드 서버 매니저 상세 로그 옵션이 추가되었습니다.
- DedicatedServerManager 컴포넌트의 dedicated_server_verbose_log 플래그를 `true`로 설정할 경우 상세 로그를 볼 수 있습니다.
데디케이티드 서버에서 사용하는 `user_data`가 빈 문자열일 때 크래시하는 문제가 수정되었습니다.
데디케이티드 서버에서 사용하는 `image_id`가 8글자 미만일 때도 정상적으로 동작하도록 수정되었습니다.
2808 experimental의 DedicatedServerManager 컴포넌트에서 image-id 파싱이 실패하던 문제가 수정되었습니다.
DedicatedServerManager 컴포넌트에서 AWS setting 값을 불러오거나 업데이트 할 때 setting 내용을 보여주는 로그가 추가되었습니다.
- 이 때 api key, secret과 같이 민감한 값들은 ***** 와 같이 표시됩니다.
데디케이티드 서버에서 EC2 인스턴스 태깅 시 같은 리전만 참조하게 변경
데디케이티드 서버에서 유휴 인스턴스 계산 시 같은 리전만 참조하게 변경
데디케이티드 서버 컴포턴트의 AWS 관련 주요 로그들은 기본적으로 출력되며 추가된 목록은 다음과 같습니다.
- 인스턴스 생성 요청 전, 종료 요청 전, 태깅 요청 성공, 인스턴스 조회 후
- 종료 조건에 부합하는 인스턴스 발견 시, 매치 요청에 부합하는 인스턴스 발견 시
데디케티이드 서버 컴포넌트에서 AWS EC2 목록과 일치하지 않는 Redis 키가 발견되면 자동으로 삭제합니다.
데디케이티드 서버 사용 시 일부 인스턴스가 종료되지 않는 문제 수정
데디케이티드 서버 매니저 에서 Describe API 함수 호출이 실패할 때 이제 지수 백오프 알고리즘을 사용하여 재시도합니다.
데디케이티드 서버 매니저 에서 사용할 수 있는 PreRedirectionHook 함수가 추가되었습니다.
- 이 함수는 데디케이티드 서버 매니저 가 클라이언트로 리다이렉션 메시지를 보내기 전 호출되며 false 를 반환할 경우 클라이언트로 리다이렉션 메시지를 보내지 않습니다.
데디케이티드 서버 매니저 가 AWS 인스턴스를 계산할 때 instance_name 이 설정된 경우 image_id 와 instance_name 과 일치하는 인스턴스만 식별합니다.
데디케이티드 서버 매니저 컴포넌트의 aws_settings 업데이트 API 호출이 실패할 때 적절한 에러 로그를 출력합니다.
데디케이티드 서버 매니저 컴포넌트에서 image_id 를 변경했을 때 인스턴스들을 식별하지 못하는 문제가 수정되었습니다.
데디케이티드 서버 매니저 컴포넌트에서 image_id 를 변경했을 때 오래된 버전의 인스턴스를 종료하지 못하는 문제가 수정되었습니다.
데디케이티드 서버 매니저 컴포넌트에서 /version API 호출 시 AWS 및 버전 정보가 있을 경우 오래된 버전을 status:deprecated 로 구분합니다.
데디케이티드 서버 매니저 컴포넌트의 인스턴스 생성/종료 로직이 개선되었습니다. 개선된 내용은 다음과 같습니다.
- 버전이 명시된 경우 항상 새 버전을 기준으로 인스턴스를 생성합니다. 이 변경으로 인해 버전이 바뀌는 순간 일시적으로 인스턴스 개수가 max_instances 값보다 커질 수 있습니다.
- 인스턴스 종료는 항상 전체 인스턴스를 기준으로 합니다. 이 변경으로 인해 버전이 바뀌는 순간에도 reversed_instances 값만큼 대기 중인 인스턴스들이 종료되지 않습니다.
- 새 버전의 인스턴스가 모두 준비된 이후에는 더 이상 이전 버전 인스턴스를 사용하지 않으며, 남아있는 이전 버전 인스턴스들은 모든 매치가 끝나는 순서대로 죵로됩니다.
데디케이티드 서버 매니저 컴포넌트를 통해 생성했지만 일정 시간 동안 Redis에 등록되지 않은 서버들을 출력합니다.
- dedicated_server_defunct_timeout_seconds=<정수> (기본 값:300, 5분)을 사용합니다.
DSM: Spawn 요청이 중복 발생할 수 있던 문제가 수정되었습니다.
DSM: 인스턴스 생성 실패 로그가 구체적으로 변경되었습니다.
- 생성 인스턴스 대기 / 용량 부족 / 잘못된 요청 등으로 구분됩니다.
DSM: Spawn 요청이 실패한 경우 로그로 출력
DSM: 호스트 서버 연결 실패 시 연결을 시도했던 주소를 로그로 출력하게 변경했습니다.
dedicated-server-host 로그를 추가했습니다.
- 인증 실패, 매치 관련 로그들을 추가했습니다.
ds state 서버에서 JWT 인증 실패 시 추가 로그를 출력합니다.
DS Host 서비스 요청 타임아웃 옵션 추가
- 매치 요청에 대한 프로세스가 지정된 시간( request_timeout_seconds , 기본 값: 10초) 초 안에 실행되지 않으면 매치 실패로 간주합니다.
DS Host: 호스트 서비스에서 생성한 프로세스가 비정상적으로 종료된 경우 에러를 출력합니다.
dedicated_server_defunct_timeout_seconds 플래그 이름 변경

dedicated_server_launch_timeout으로 변경되었습니다.
dedicated_server_terminate_defunct_instances 플래그 추가
- 이 값이 true로 설정된 경우 dedicated_server_launch_timeout 시간 안에 ready API를 받지 못한 인스턴스들을 자동으로 종료시킵니다.
World 의 Broadcast, FindSession 의 잘못된 Assert 제거

Network¶

TCP SSL 지원 추가
ECDH/ECDHE 키 교환 알고리즘을 인식하지 못하는 문제 수정
SSL 기본 알고리즘 순서 변경 및 허용 목록 축소
웹소켓 프로토콜 지원
분당 처리할 세션당 메시지 수 제한 추가
HTTP 에도 rate limit 적용 (HTTP 429)
Session Reliability를 사용할 때 delayed ack, piggy back 기능 추가
- 해당 옵션은 delayed_ack_interval_in_ms를 0이상의 값으로 설정했을 때 사용 할 수 있습니다.
메시지 압축 기능 추가
압축 옵션 설정 (transport 별 옵션으로 분리)

Object¶

C# - kReadLock 으로 Fetch 후 쓰기를 할 때 더 자세한 로그가 출력되도록 개선
ORM 오브젝트 GetLockType() C++ 함수 추가
ORM 오브젝트 GetLockType() C# 함수 추가
C# Object.WriteAllImmediately, {Object}.WriteImmediately 함수 추가
C# RegisterAttributeTrigger 함수 추가
C# SelectBy{AttributeName} 함수 추가
동일한 ORM 객체를 다른 LockType으로 Fetch할 때 죽는 문제 수정
ORM 사용 시 자료형 추가 지원
- ORM 에 자료형을 더 상세하게 입력할 수 있게 추가되었습니다. 지원되는 타입: int8, int16, int32, int64, float, timestamp, datetime
DateTime을 String에서 WallClock/DateTime으로 변경

DateTime, timestamp는 Map, Array로 사용할 수 없습니다.
Jinja2 2.9 미만 버전에서 복합키 생성이 되지 않는 문제 수정

Distribution¶

Unreal Dedicated Server 와 RPC 통신하는 기능 추가.
- Unreal 클라이언트 플러그인 95 Stable 버전 이상이 필요합니다.
DedicatedServerRpc: bytes 대신 FunDedicatedServerRpcMessage 를 사용하도록 수정.
자동으로 Dedicated Server RPC server 를 알아내는 기능 추가.
DedicatedServerRpc: Dedicated Server 에서 입력한 Tag 로 peer 목록 가져오는 기능 추가
- DedicatedServerRpc 기능을 사용할 경우 Dedicated Server 에서 사용하는 Unreal 클라이언트 플러그인을 95 Stable 버전 이상으로 업데이트하셔야 합니다.
DedicatedServerRpc: ConnectHandler 에서 tag 를 조회할 수 없는 문제 수정.
DedicatedServerRpc: Tag 를 얻을 수 있는 GetPeerTag() 함수 추가
RPC: 서버간 연결 관련 처리 개선.
데이터베이스 비활성화시 레디스 기반 RPC를 사용할 수 없던 문제가 해결되었습니다.

Database¶

Redis 컴포넌트에 database 선택할 수 있는 기능 추가.
RedisClient: Create() 할 때 database 선택할 수 있도록 수정.
MariaDB 연결 실패 시 크래시할 수 있던 문제 수정
RedisClient: 알 수 없는 이유로 연결 실패하여 재연결할 때 크래시되는 버그 수정.
이제 MariaDB Connector가 SQL 타임스탬프 타입을 읽을 수 있습니다.
이제 MariaDB Connector에 Client 플래그를 설정할 수 있습니다.

Management¶

아이펀 디플로이의 드랍다운 리스트 기능 사용 가능하게 수정
아이펀 디플로이의 반복 캠페인 처리 추가
DeployApiService 에서 지급 가능한 아이템 목록을 순서대로 보내게 수정
Deploy Api Service에 다수의 유저를 제재하거나 제재 해제할 수 있는 API 추가
이제 Http::Request, http::Request2 객체를 통해 클라이언트의 IP를 확인할 수 있습니다.
Counter API 정보에 캐시 메모리 크기( cachedram )가 추가되었습니다.

Account¶

영수증 검증 시 product 구매 정보가 없는 경우에 대한 에러코드 추가
영수증 검증 시 트랜잭션 id를 가져올 수 있도록 추가 인터페이스 제공

System¶

등록되지 않은 Activity Log 사용 시 크래시 하지 않도록 수정
Docker CE 에서 실행 실패하는 문제 수정

Framework¶

C# - 서버 크래시 시 콜스택 정보가 로그에 항상 포함되도록 개선

misc.¶

일부 플랫폼에서 C# 패키징이 실패하는 문제 수정
아이펀 디플로이 추가 설정 기능 및 캠페인 설명 문서화
C# 프로젝트 생성 시 불필요한 .cc/.h 파일을 생성하지 않도록 변경
프로젝트 생성 시 predefined 매크로 템플릿이 동작하지 않던 문제 수정
Ubuntu 16.04에서 mdb 파일이 만들어지지 않던 문제 수정
funapi_client_resource_generator Windows 지원 추가
하위 디렉터리에 .proto 파일이 있는 경우에 오작동하는 부분 수정 (C#)
ORM 사용 시 자료형 추가 지원(C#)
ArrayRef에 IList<T>를 지원 인터페이스 추가(C#)
Mono에서 타이머 취소 시 exception이 발생하던 문제 수정
AppleGameCenter(C#) 지원
C#에서 페이스북 인증시 크래시하는 문제 수정
Dedicated server manager(C#) 지원
RedisClient 의 StringCallback 이 크래시하는 문제 수정(C#)
Dedicated Server Rpc C# 지원
압축관련 사항 문서화
Deploy Api Service에 다수의 유저를 제재하거나 제재 해제할 수 있는 API 추가(C#)
funapi_client_resource_generator를 이용한 목록 추출 시 .funignore 파일 지원

.funignore 파일은 POSIX 정규 표현식을 따르며 패턴과 일치하는 파일을 json 결과물 목록에서 제외시킵니다.
C#에서 빈 프로토버프 메시지를 보낼 때 서버가 크래시하던 문제 수정
2794 experimental 버전에서 C# Protobuf 메시지 생성이 실패할 수 있던 문제가 수정되었습니다.
데디케이티드 호스트 서비스에서 AWS 리전이 아닌 AZ 정보를 가져오는 문제가 수정되었습니다
영수증 검증 시 트랜잭션 id를 가져오는 인터페이스 추가(C#)
영수증 검증 시 product 구매 정보가 없는 경우 에러 코드 추가(C#)
dedicated-server-host 로그를 추가했습니다.

인증 실패, 매치 관련 로그들을 추가했습니다.
ds state 서버에서 JWT 인증 실패 시 추가 로그를 출력합니다.
DS Host: 호스트 서비스에서 생성한 프로세스가 비정상적으로 종료된 경우 에러를 출력합니다.

v1.0.0-2619 (2018-02-02)¶

2018-02-02 10:19:18

Service¶

Matchmaking 시 enable_dynamic_match = false 면 시간순으로 우선권을 갖도록 수정

v1.0.0-2591 (2018-01-12)¶

2018-01-12 08:47:46

Network¶

funtest::Session 의 TCP 닫힐 때 상태 정보 문제 수정

v1.0.0-2586 (2018-01-09)¶

2018-01-09 08:32:14

Warning

Breaking Changes

다음의 변경 사항으로 인해 funtest::Session 을 사용하는 경우¶

서버를 다시 빌드해야 합니다.¶

funtest::Session 이 RedirectClient 처리할 수 있게 수정

Network¶

funtest::Session 이 RedirectClient 처리할 수 있게 수정

v1.0.0-2582 (2018-01-05)¶

2018-01-05 16:52:17

Management¶

1.0.0-2574 Stable 버전에서 ApiService가 동작하지 않는 문제 수정

v1.0.0-2574 (2018-01-02)¶

2018-01-02 15:23:00

Management¶

ApiService Port 가 0 일 때 서버 구동이 안되는 문제 수정

v1.0.0-2570 (2018-01-02)¶

2018-01-02 03:05:48

Management¶

ApiService 가 완전히 초기화된 후 요청을 받도록 수정

v1.0.0-2562 (2017-12-29)¶

2017-12-29 13:31:59

Service¶

Matchmaking 통계 출력 문제 수정.
Matchmaking 통계에서 매칭 min/max 초기값을 0으로 수정.

Management¶

API service 의 URL 처리 로그에 bytes 길이도 출력하도록 수정.

v1.0.0-2558 (2017-12-28)¶

2017-12-28 16:51:38

Service¶

–matchmaking_server_logging_level 추가.
MatchmakingServer 에 REST API 들 추가
matchmaking 관련 counter 추가

Distribution¶

크래시했을 때 서버 프로세스가 종료되지 않을 수 있는 문제 수정

Management¶

matchmaking_server_logging_level 을 runtime flag 로 지정.

v1.0.0-2542 (2017-12-26)¶

2017-12-26 10:42:12

Service¶

API 처리 시 특정 상황에서 레이스 컨디션이 발생하는 문제 수정

v1.0.0-2517 (2017-12-07)¶

2017-12-07 01:45:04

Service¶

Google Play Game 인증 검증 시 웹 콘솔 id로도 통과하도록 수정

v1.0.0-2477 (2017-11-23)¶

2017-11-23 02:44:35

Service¶

Dedicated Server 관리하는 컴퍼넌트 추가
서버 빌드시 Unity3D DLL 빌드가 실패하는 문제 수정
DSM: 유저 난입이 가능하게 구현 수정
DedicatedServerManager 에 AWS Subnet ID 를 지정할 수 있도록 수정
aws_settings 의 subnet_id 가 빈 문자열일 때 발생하는 문제 수정
DedicatedServerManager 가 2 대 이상일 때 발생되는 문제 수정
DedicatedServerManager 가 요청을 Queueing 하도록 수정
DedicatedServerManager::Cancel() 추가
Master DedicatedServerManager 가 종료될 때 즉시 Master 권한을 포기하도록 수정
데디케이티드 서버에 유저 진출입, 커스텀 콜백 기능 추가

ConfigureReservedInstanceCountCallback 라는 콜백을 이용해서 EC2 상의 데디케이티드 서버 호스트 수를 입력 받고, 이후에 사용할 예약 인스턴스 수를 동적으로 조절할 수 있는 기능이 추가되었습니다.
Redis 가 초기화 된 후에 DSM이 크래시할 수 있는 버그 수정
DS host에 서버를 띄울 공간이 없을 때 지나치게 빨리 재시도하는 문제 수정
데디케이티드 서버를 강제 종료하는 시간 지정할 수 있게 수정

v1.0.0-2458 (2017-11-13)¶

2017-11-13 11:35:54

Warning

Breaking Changes

다음의 변경 사항으로 인해 서버를 다시 빌드해야 합니다.¶

Timer 에 Event Tag 를 지정하여 병렬처리 할 수 있게 수정

다음의 변경 사항으로 인해 연결되는 모든 서버의 엔진 업데이트가 필요합니다.¶

분산 환경에서 Object Model 이 다른 서버는 구동되지 않도록 수정

다음의 기능 추가로 인해 리더보드 업데이트가 필요합니다.¶

Leaderboard 월간 랭킹 리셋 기능 추가

1.0.0-1803 stable 버전 이상의 리더보드로 업데이트 해야 합니다.

다음의 변화로 인해 코드 수정 및 빌드가 필요할 수도 있습니다.¶

DeployAPI: 선물 지급 API 수정

선물 지급 API가 수정되어 GiveGiftToCharacter API 삭제. 새로 추가된 GiveGift를 사용해서 수정 및 새로 빌드해야 정상 동작합니다.
Deploy API 수정 사항 반영

캠페인 시작 콜백 함수에 전달하는 CampaignArgument 에 시작/종료 시간 관련 인자를 추가했습니다. 해당 인자를 접근하기 위해선 새로 빌드해야 합니다. 아이템 지급 API에 유저에게 지급하는 것인지 캐릭터에게 지급하는 것인지 구분하는 인자가 추가되었습니다. (해당 인자는 account, character 중 하나의 값을 씁니다.)
개별 timespan 랭킹 삭제에서 모든 랭킹 삭제하도록 LeaderboardResetRequest 인터페이스 변경.

LeaderboardResetRequest 객체를 만들 때 입력하는 timespan 이 제거되었습니다. 해당 구조체를 사용하시는 경우 코드 수정이 필요합니다.
iFun Authenticator deprecated 처리

iFun Authenticator 를 이용한 인증 검증 기능은 Deprecated 되어 향후 제거될 예정이오니 각 플랫폼별 인증 검증 함수로 변경하시기 바랍니다.
GooglePlayGame AuthenticationResponse 에러 관련 변수명 변경(C#)

해당 구조체를 사용하시는 경우 코드 수정이 필요합니다.

Service¶

iFun Authenticator deprecated 처리
개별 timespan 랭킹 삭제에서 모든 랭킹 삭제하도록 LeaderboardResetRequest 인터페이스 변경.
Leaderboard 월간 랭킹 리셋 기능 추가
GooglePlayGameService 인증 검증 지원
GooglePlayGameService 인증 검증 지원(C#)
C# AccountAuthentication deprecated 처리
C# SessionClosedHandler 에서 AccountManager 로그아웃 처리 할 수 없던 버그 수정.
GooglePlus Authenticate/GetPersonalInfo C# 함수 추가
NexonPlatform Authenticate C# 함수 추가
NexonToy Authenticate C#함수 추가
Facebook Authenticate/GetPersonalInfo C# 함수 추가
LINE Authenticate/GetPersonalInfo C# 함수 추가
GooglePlayGame AuthenticationResponse 에러 관련 변수명 변경(C#)

Network¶

TCP transport 가 attach 되는 경우 호출되는 handler 등록 가능하게함
Session::GetLastSendTime() 추가
Session::GetExpirationTime() 추가
메세지 핸들러 호출 전/후를 후킹할 수 있는 함수 추가
메세지 핸들러 호출 전/후를 후킹할 수 있는 C# 함수 추가
Session::GetExpirationTime() 의 값이 부정확하게 나오는 문제 수정

Time¶

Timer 에 Event Tag 를 지정하여 병렬처리 할 수 있게 수정
Repeating Timer 가 밀릴 때 과도하게 이벤트를 생성하지 않도록 수정
서버 프로세스의 구동시간을 얻는 WallClock::GetUptime(), WallClock::GetUptime2() 추가
서버 프로세스의 구동시간을 얻는 funapi/uptime Counter 추가

Distribution¶

MySQL, Zookeeper 처리 속도 모니터링 기능 추가
Rpc: peer 연결 여부를 확인할 수 있는 IsPeerConnected() 함수 추가.
RPC Disconnect Handler 에서 접속 끊긴 Peer 의 Tag 와 Status 를 읽을 수 있게 수정
분산 환경에서 Object Model 이 다른 서버는 구동되지 않도록 수정

System¶

event_profiling 카운터에 함수 처리 시간 추가(handler_time)
execution_time 으로 내림차순 정렬하는 event_profiling_execution_time_order 카운터 추가
handler_time 으로 내림차순 정렬하는 event_profiling_handler_time_order 카운터 추가
io_wait_time 으로 내림차순 정렬하는 event_profiling_io_wait_time_order 카운터 추가

v1.0.0-2417 (2017-10-16)¶

2017-10-16 17:20:05

Management¶

캠페인 보상 정보 파싱 버그 수정 (C#)

v1.0.0-2410 (2017-10-12)¶

2017-10-12 15:00:33

Management¶

C# DeployApiService 가 잘못된 캠페인 형식을 사용하는 버그 수정

v1.0.0-2407 (2017-10-12)¶

2017-10-12 10:32:42

Network¶

C# http.Method.GetString(), http.StatusCode.GetString() 추가

Management¶

DeployApiService 를 native/mono 중 선택해서 활성화하게 수정
C# iFunDeploy API 연동 지원 (1) - 유저 관리 기능
C# iFunDeploy API 연동 지원 (2) - 커스텀 API
C# iFunDeploy API 연동 지원 (3) - 캠페인 기능 연동
C# iFunDeploy 연동 지원 (4) - 인벤터리 삭제 지원
DeployAPIService에서 ORM 롤백 처리가 되지 않는 문제 수정(C#)
C#에서 추가한 Restful API가 목록 조회 시 정상적으로 포함되도록 변경

misc.¶

DeployApiService 문서 업데이트

v1.0.0-2404 (2017-10-11)¶

2017-10-11 15:00:05

Service¶

Client redirection 할 때 IP 대신 hostname 줄 수 있게 수정

System¶

IP resolver 의 nat 타입에 DNS 주소 허용

v1.0.0-2401 (2017-09-29)¶

2017-09-29 12:05:50

Service¶

게임 서버에서 리더보드 랭킹을 초기화할 수 있는 ResetLeaderboard() 함수 추가

이 기능을 사용하려면 1.0.0-1744 stable 버전 이상의 리더보드 에이전트가 필요합니다.

Database¶

일부 머신에서 RedisClient 연결이 해제되는 문제 수정.
RedisClient: Pub/Sub 처리시 간헐적으로 assertion 에 걸리는 문제 수정.

Object¶

분산환경에서 Object Cache 메모리 사용량 개선

v1.0.0-2377 (2017-09-21)¶

2017-09-21 10:34:25

Object¶

ORM 의 메모리 사용량 관련 문제 수정

v1.0.0-2363 (2017-09-15)¶

2017-09-15 14:21:08

Network¶

Protobuf field 로 메세지 핸들러 등록시 메모리릭이 발생되는 문제 수정
Protobuf field 로 메시지 핸들러 등록시 이름에 > 가 포함되는 버그 수정

Framework¶

크래시할 때 엔진 버전을 로그로 출력

v1.0.0-2337 (2017-09-04)¶

2017-09-04 23:18:55

Framework¶

이벤트 함수에서 크래시할 때 이벤트 이름 출력

v1.0.0-2334 (2017-09-01)¶

2017-09-01 14:00:14

Distribution¶

Segmentation Fault 로 크래시했을 때도 Zookeeper 연결을 끊고 종료하도록 수정.

Object¶

ORM 관련 잘못된 Assert 제거

v1.0.0-2312 (2017-08-25)¶

2017-08-25 14:04:25

Object¶

Object Cache 가 trailing spaces 들을 MySQL general_ci 와 동일하게 다루도록 수정

Network¶

session id 를 한 번만 보내 트래픽을 줄이는 기능 관련 크래시 문제 수정

v1.0.0-2300 (2017-08-22)¶

2017-08-22 17:10:44

Object¶

kReadCopyNoLock 으로 Array, Map Fetch 할 때 NULL 오브젝트가 있으면 크래시 하는 버그 수정.

v1.0.0-2292 (2017-08-22)¶

2017-08-22 09:42:50

Service¶

DeployApiService: 아이템 회수 명령 인자 설정 버그 수정

v1.0.0-2282 (2017-08-17)¶

2017-08-17 14:31:37

Warning

Breaking Changes

다음의 변화로 인해 코드 수정 및 빌드가 필요할 수도 있습니다.
- Deploy API: 버그 수정 및 바뀐 인터페이스 대응
DeployApiService 의 일부 인터페이스가 수정되어 서버를 다시 빌드해야합니다. SearchUsers, GetInventory 함수의 경우 구현을 수정하셔야 합니다.
- DeployAPI: 선물 지급 API 수정
선물 지급 API가 수정되어 GiveGiftToCharacter API 삭제. 새로 추가된 GiveGift를 사용해서 수정 및 새로 빌드해야 정상 동작합니다.
- Deploy API 수정 사항 반영
캠페인 시작 콜백 함수에 전달하는 CampaignArgument 에 시작/종료 시간 관련 인자를 추가했습니다. 해당 인자를 접근하기 위해선 새로 빌드해야 합니다. 아이템 지급 API에 유저에게 지급하는 것인지 캐릭터에게 지급하는 것인지 구분하는 인자가 추가되었습니다. (해당 인자는 account, character 중 하나의 값을 씁니다.)

Management¶

Deploy API: 버그 수정 및 바뀐 인터페이스 대응
DeployAPI: 선물 지급 API 수정
DeployAPI: 캠페인 취소, 아이템 대량 지급 API 추가
Deploy API 수정 사항 반영
DeployApiService: 인벤터리 아이템 다중 회수 API 지원
C# ApiService URL 매칭하는 방식 개선

Network¶

이벤트 프로파일링 시 Protobuf 핸들러 이름이 정수 값으로 보이는 문제 수정

misc.¶

C# HTTP API 통신 예제 코드 추가

v1.0.0-2256 (2017-08-10)¶

2017-08-10 10:02:30

Warning

Breaking Changes

다음의 변화로 인해 DB 권한 확인이 필요할 수도 있습니다.

만약 DB 권한이 충분하지 않을 경우 서버가 실행되지 않습니다. 이 경우 需要的 DB 权限 에서 설명하는 export_db_schema 옵션을 사용하여 관리자 DB 계정으로 DB 스키마를 업데이트할 수 있습니다.
- use_db_char_type_for_object_id 옵션 사용시 캐릭터셋이 지정되지 않는 버그 수정.
이 옵션을 true 로 설정하셨을 경우 엔진 업데이트 후 서버 실행 시 프로시저를 재생성하기 위해 DDL 쿼리를 실행합니다.
- 오브젝트를 DB 에서 가져올 때 트래픽 줄이도록 수정 - 1.
- 오브젝트 DB 테이블의 col__tag 사용하지 않도록 수정.
- Array 또는 Map 만 가지는 오브젝트의 프로시저를 만들 수 없는 버그 수정.
본 수정으로 인해 DB 스키마 해시가 변경되어 프로시저를 재 생성하는 DDL 쿼리가 실행됩니다.
다음의 변화로 인해 모든 서버의 엔진 업데이트가 필요합니다.
- ORM 분산 처리 시 발생하는 네트워크 트래픽 개선
이전 버전의 서버와 연결되면 크래시합니다. 모든 서버를 함께 업데이트 하시기 바랍니다.
다음의 변화로 인해 플러그인 업데이트가 필요할 수도 있습니다.
- UDP 에서 Session ID 를 첫 메시지일 때만 전송하는 기능을 쓸 때 버그 수정
UDP 와 send_session_id_only_once 를 사용하실 경우 다음 버전 이상의 플러그인으로 업데이트하시기 바랍니다.
- Unity3D: 228
- Unreal4: 67
- Cocos2d-x: 67

Object¶

ORM 롤백 처리 중 Assert 로 크래시할 수 있는 문제 수정
하나의 Object 가 서로 다른 두 서버에서 동시에 캐싱될 수 있는 문제 수정
Object Cache 의 Index 성능 개선
생성된 Object 가 DB Update 완료 전에 Cache 에서 내려갈 수 있는 문제 수정
use_db_char_type_for_object_id 옵션 사용시 캐릭터셋이 지정되지 않는 버그 수정.
Object ID Pool 관련 Assert 수정
Object 가 cache_expiration_in_ms 보다 더 빨리 캐시에서 내려갈 수 있는 문제 수정
분산 환경에서 ORM Object Cache 적중률 개선
Object 삭제 관련 Assert 로 크래시할 수 있는 문제 수정
분산 처리 과정의 Lock 관련 Assert 수정
ORM 분산 처리 시 발생하는 네트워크 트래픽 개선
오브젝트 쿼리 용량 줄이도록 수정.
프로시저를 사용하지 않을 때 불필요한 쿼리 제거.
ORM 지연 업데이트 관련 Assert 로 크래시하는 문제 수정
오브젝트를 DB 에서 가져올 때 트래픽 줄이도록 수정 - 1.
오브젝트를 DB 에서 가져올 때 트래픽 줄이도록 수정 - 2.
오브젝트 DB 테이블의 col__tag 사용하지 않도록 수정.

더이상 col__tag 컬럼이 사용되지 않습니다. 엔진에서 자동으로 해당 컬럼을 제거하지는 않습니다.

종료 처리가 멈출 수 있는 문제 수정
Array 또는 Map 만 가지는 오브젝트의 프로시저를 만들 수 없는 버그 수정.
오브젝트 프로시저명을 축약하여 사용할 수 있는 기능 추가

MANIFEST/Object 에 use_db_stored_procedure_full_name 를 false 로 지정하면 축약된 오브젝트 프로시저명으로 DB 서버와 통신합니다. 이 경우 DB 스키마 해시가 변경되어 프로시저를 재 생성하는 DDL 쿼리가 실행됩니다. 만약 DB 권한이 충분하지 않을 경우 서버가 실행되지 않습니다. 이 경우 需要的 DB 权限 에서 설명하는 export_db_schema 옵션을 사용하여 관리자 DB 계정으로 DB 스키마를 업데이트할 수 있습니다.

ORM Object 를 생성 후 바로 삭제할 때 Assert 로 크래시하는 문제 수정
한 이벤트에서 동일한 Key 의 ORM 오브젝트의 생성 삭제를 반복할 때 발생하는 문제 수정
삭제한 오브젝트를 다시 삭제하는 잘못된 코드를 ASSERT 로 막던 것 허용.

Network¶

UDP 에서 Session ID 를 첫 메시지일 때만 전송하는 기능을 쓸 때 버그 수정
send_session_id_only_once 관련 Assert 로 크래시할 수 있는 문제 수정
Session::CloseTransport() 로 UDP 를 닫을 때 버그 수정

Service¶

C# AccountManager 관련 콜백이 간헐적으로 호출되지 않는 문제 수정

Framework¶

ArgumentMap 에 FindDoubleArgument() 함수 추가.

Distribution¶

분산 환경에서 불필요한 Zookeeper 요청 제거

misc.¶

MANIFEST.json double 타입 인자 지원.

v1.0.0-2214 (2017-07-27)¶

2017-07-27 09:23:33

Warning

Breaking Changes

다음의 변화로 인해 Multicast Protobuf 수정 및 플러그인 업데이트가 필요할 수도 있습니다.
- Multicast protobuf extension 관련 사용 가능한 필드 번호 범위가 수정되었습니다.
만약 FunMulticastMessage 를 확장하여 사용할 경우 필드 번호를 16 부터 사용하도록 수정해야 합니다. 그리고 다음 버전 이상의 플러그인으로 업데이트해야 합니다. (Stable 버전 기준)
- Unity3D: 220
- Unreal4: 65
- Cocos2d-x: 66
다음의 변화로 인해 서버 빌드 및 플러그인 업데이트가 필요합니다.
- Protobuf 의 Message Type 을 String 대신 Integer 를 쓸 수 있는 기능 추가
이 기능을 사용하려면 다음 버전 이상의 플러그인으로 업데이트 해야 합니다. (Stable 버전 기준)
- Unity3D: 220
- Unreal4: 65
- Cocos2d-x: 66
다음 변화로 인해 코드 수정 및 인증 서버 업데이트가 필요합니다.
- Kakao 인증 제거
변경된 Kakao 운영정책으로 인해 서버 사이드 인증 API 가 제거되었습니다. 만약 Kakao 인증 API 를 사용중이시라면 직접 Kakao API 를 호출하여 인증 처리해야 합니다. 직접 구현하실 경우 다음 GitHub 에서 구현 샘플을 참고하실 수 있습니다.

https://github.com/iFunFactory/engine-example-kakao-game-authentication
다음의 변화로 인해 MANIFEST.json 파일 수정이 필요합니다.
- 네트워크 I/O 처리를 위한 스레드 수 설정 이름 변경
IoService/io_service_threads_size 에서 SessionService/network_io_threads_size 로 변경 되었으며, 기존 설정도 당분간 유효하게 작동합니다. 가급적 빠른 시일내에 새로운 설정 이름으로 변경하시기 바랍니다.
- Google Log 보관 기간 옵션 추가
30 일이 지난 디버그(glog) 로그가 삭제됩니다. 더 오래 보관하기 위해서는 glog_retention_period_in_days 설정 값을 변경해야 합니다.
다음의 변화로 인해 코드 수정 또는 서버를 다시 빌드 해야합니다.
- Matchmaking 서버를 선택할 수 있도록 개선
StartMatchmaking() 함수에 target_server 파라미터가 추가되었습니다. kRandom(무작위), kLeastNumberOfPlayers(요청이 적은 서버 우선), kMostNumberOfPlayers(요청이 많은 서버 우선) 중 하나 또는 직접 PeerId 를 선택할 수 있습니다.
- Session::LastSentMessageType() 함수 오타 수정
세션의 API 가 변경되어 소스 코드 수정이 필요합니다.
- 서버 테스트 기능(funtest::Session) UDP 지원
funtest::Session 을 사용할 경우 서버를 다시 빌드해야합니다.
- Object Model 을 다루는 내부 코드 개선
- JsonSchema::Type kDouble 오타 수정

Service¶

Matchmaking 서버를 선택할 수 있도록 개선

GetMatchmakingServerInfo() 함수가 추가 되었습니다. 모든 MatchmakingServer 의 PeerId 와 Matchmaking 요청 수를 알 수 있습니다.

Nexon Platform 인증 관련 변경사항 반영
멀티캐스트 메시지를 검사할 수 있는 기능 추가
Kakao 인증 제거
AccountManager RedirectClient 호출 후 엔진에서 세션을 종료하도록 수정

Network¶

네트워크 I/O 처리를 위한 스레드 수 설정 이름 변경
Session::LastSentMessageType() 함수 오타 수정
TCP, UDP 에서 Session ID 를 첫 메시지일 때만 전송하고 그 이후에는 생략하여 네트워크 트래픽을 줄이는 기능 추가
Protobuf 의 Message Type 을 String 대신 Integer 를 쓸 수 있는 기능 추가
Protobuf Extension Identifier 를 Message Type 으로 쓸 때 빌드 오류 수정
close_transport_when_session_close 옵션이 작동하지 않는 문제 수정
use_session_relibility 와 send_session_id_only_once 기능을 함께 쓸 때 Encryption 관련 ASSERT 로 크래시할 수 있는 문제 수정
use_session_relibility 와 send_session_id_only_once 기능을 함께 쓸 때 Session Reliability 에 의한 재연결에 안될 수 있는 문제 수정
UDP 관련 불필요한 ASSERT 제거

C#¶

C# 지원(Ubuntu)

CentOS 는 향후 지원할 예정입니다.

C# 으로 개발하기 위해서는 다음과 같은 명령을 입력하여 프로젝트를 다시 만들어야 합니다.
$ funapi_initiator {ProjectName} --mono

서버 테스트 기능(funtest::Session) UDP 지원
서버 테스트 기능(funtest::Session) 의 HTTP 관련 버그 수정
Install/Start/Uninstall 함수의 Return Type 을 void -> bool 로 변경
오브젝트 ArrayRef, MapRef 에 Has, Clear, FindFirstEmptySlot 함수 추가
Monodevelop 5.x 버전에서 디버깅이 시작되지 않는 문제 수정
Session::SetTransport(…) 지원
Event::Abort() 지원
ORM Object 에 Bool 타입이 있을 때 빌드 오류 수정
Mariadb(MySQL) Connector 사용 시 크래시할 수 있는 문제 수정
ORM Database 와 연결된 Mariadb Connector 를 얻을 수 있는 API 추가
RedisClient 추가
ApiService Handler 에서 ORM 을 사용할 수 없는 문제 수정
Object Array, Map Fetch 함수 성능 개선
Object Create() 함수로 전달된 String Key 가 모델에 정의된 길이를 초과하면 NullReferenceException 이 발생하는 문제 수정
null 인 Object 를 좌변에 두고 ‘==’ 연산자로 비교할 때 NullReferenceException 이 발생하는 문제 수정
Object 를 JSON 으로 초기화 하는 기능 지원
Map 의 Key 에 String Type 이 있을 때 빌드가 안되는 문제 수정
C# 지원 업데이트

Object¶

ORM Object 의 Delete() 를 두 번 이상 호출할 때 걸리는 ASSERT 제거
Object Fetch 함수 성능 개선
Object Model 을 다루는 내부 코드 개선
ORM 분산처리 관련 잘못된 ASSERT 제거
DB, Zookeeper Write I/O 지연시 정상적인 Key 가 Dangling Key 로 처리되는 문제 수정
존재하지 않는 Key 의 Object 를 Create 또는 Fetch 할 때 일시적으로 CPU 를 과도하게 사용하는 문제 수정
프로시저를 사용하지 않을 때 간헐적으로 Array 데이터를 지우지 못하던 버그 수정.

System¶

Google Log 보관 기간 옵션 추가
이벤트 유입, 처리량 카운터가 실제 보다 낮고 부정확하게 측정되는 문제 수정
간헐적으로 서버 종료 처리에 지연이 생기는 문제 수정

Distribution¶

주키퍼 성능 카운터 주소를 zookeeper_stat 에서 distribution_profiling 으로 변경

Management¶

SystemInfo Counter 가 구동 후 일정 시간 동안 출력되지 않는 문제 수정

Database¶

RedisClient 명령 호출 후 메모리 반환에 지연이 생기는 버그 수정
RedisClient 추가
Mariadb Connector 가 재연결될 때 쿼리가 유실될 수 있는 문제 수정

misc.¶

서버 크래시 발생시 종료안될 수 있는 문제 수정
Json::HasAttribute({AttrName}, {AttrType}) 함수 추가
CLion 개발 환경 구성 문서 업데이트(2017.1.2 버전 기준)
JsonSchema::Type kDouble 오타 수정
Mongodb logger에 SSL/TLS 활성화하는 플래그 추가
Object Type 의 JSON 을 다룰 때 내부의 불필요한 함수 호출 제거
ResourceManager 문서중 기획데이터 사용하기 예제 잘못된 것 수정
리더보드에 추가된 mysql_local_account_column_length 옵션 설명 추가

v1.0.0-2164 (2017-06-27)¶

2017-06-27 14:46:25

Network¶

TransportProtocol 값에 대한 Assert 처리 강화
다음 함수들이 kDefaultProtocol 을 인자로 받을 수 있도록 수정
- Session::GetRemoteEndPoint()
- Session::IsTransportAttached()
- Session::CloseTransport()

Object¶

Object Lock/Lease 재시도 로그 표현 수정

v1.0.0-2130 (2017-05-31)¶

2017-05-31 14:00:37

Object¶

Object Model Error 로그에 더 많은 정보를 출력하도록 개선 및 FATAL 로그로 변경
누락된 Object Model 검사 추가

Framework¶

Google Protobuf 관련 오류 로그를 stderr 대신 로그 파일에 기록되도록 수정.

Distribution¶

Zookeeper 장애에 대한 예외처리 개선

misc.¶

Ubuntu 16.04 에서 패키지 생성시 systemd 서비스가 실행되지 못하는 문제 수정
Flavor 사용시 systemd 패키지 생성시 서비스 실행이 정상적으로 안되는 문제 해결

v1.0.0-2086 (2017-05-10)¶

2017-05-10 16:35:04

misc.¶

修复了因CentOS7 rapidjson更新而导致的服务器无法运行的问题。

v1.0.0-2066 (2017-04-20)¶

2017-04-20 11:03:36

Warning

Breaking changes

因以下变化，须要重新构建游戏服务器。
- 修复了广播时指定kDefaultProtocol的情况下，不运行的漏洞
Session(AccountManager)::BroadcastLocally/Globally()函数的Encryption、TransportProtocol的默认参数值已被删除。
- Json::From*(…) 中解析失败时，可以收到回调函数
添加参数，使Json::From*(…)函数可收到解析错误回调函数。
因以下变化，通过RPC连接的所有服务器均须要更新。
- Rpc::SetStatus() 被调用时，不会覆盖引擎内部Status

Network¶

Network: 添加了向所有会话发送消息的函数
AccountManager: 添加了向已登录的所有会话发送消息的函数
修复了广播时指定kDefaultProtocol的情况下，不运行的漏洞
修复了HTTP中收到未注册处理器的消息时，忽略后续消息的问题

+优化为Session Message Log中可同时保留Transport Protocol（TCP or UDP or HTTP）

修改为Network相关日志中可保留客户端地址等更多消息

修改为Session被关闭时，可保存日志

优化为funtest::Session关闭时，可自动关闭Transport
修复了服务器测试功能的内存泄漏漏洞

Framework¶

修复了因SIGSEGV崩溃时延时关闭的问题

Distribution¶

添加了名为rpc_use_public_address的flag
Rpc::SetStatus() 被调用时，不会覆盖引擎内部Status

Service¶

Multicast: 添加了传输消息时调用的hook函数
添加了LINE认证
修复了因已在AccountManager登录的会话而导致的用其他Account ID登录时出现ASSERT的问题

Object¶

修复了多个服务器同时安装Schema时，发生崩溃的漏洞
优化为通过JSON初始化Object时，可支持Foreign Attribute

Database¶

Mariadb(MySQL) 优化了Connector的超时处理

System¶

MANIFEST中添加了决定是否输出Activity Log Schema的旗标
修复了event_profiling计数器中回滚次数输出错误的漏洞

misc.¶

Json::From*(…) 中解析失败时，可以收到回调函数
Multicast:消息传输hooking文件化
Session的BroadcastLocally()、BroadcastGlobally()函数文件化
AccountManager的BroadcastLocally()、BroadcastGlobally()函数文件化
Json::FindAttribute() 函数已添加
修复为setup_build_environment在非symbolic link时，也能运行

v1.0.0-1945 (2017-02-06)¶

2017-02-06 14:12:37

Warning

Breaking changes

需要更新客户端插件的部分如下。
- 添加了可以通过字节发送Protobuf会话ID的功能
  
  必须将客户端插件更新到以下版本以上，并重新构建Protobuf DLL。
  - Unity3D: 190
  - Unreal4: 35
  - Cocos2d-x: 35
因以下变化，须要重新构建游戏服务器。
- 修复了因”Assert failed: ObjectCache::Delete(…)”而崩溃的问题
因以下变化，服务器运行时会执行DB DDL Query
- 修改为仅在对象DB procedure发生变更时才重新创建
  
  因本项修改而添加了数据表，且会执行相关DDL Query。当没有足够的DB权限时，服务器会崩溃。
- col__tag column长度固定在36
  
  因本项修改，将会执行把col__tag column长度变更为36的 DDL Query。当没有足够的DB权限时，服务器会崩溃。
- 添加了对象相关TRANSACTION ISOLATION LEVEL READ UNCOMMITTED设置选项
  
  当use_db_stored_procedure: true时，若修改该选项值，会执行重新创建 procedure的DDL。当没有足够的DB权限时，服务器会崩溃。

Object¶

Object: 修复了”Assert failed: IsValid()”造成崩溃的问题
Object: 添加了string column长度增加时也能自动修改的功能
Object: 添加了对象相关DB数据表模式的验证功能
Object: 添加了对象相关DB procedure模式的验证功能
修改为仅在对象DB procedure发生变更时才重新创建
col__tag column长度固定在36
修复了因”Assert failed: ObjectCache::Delete(…)”而崩溃的问题
添加了对象相关TRANSACTION ISOLATION LEVEL READ UNCOMMITTED设置选项
修复了安装Schema后，数据表验证失败的问题
修复了提取对象DB Schema时服务器无法正常关闭的问题
修复了``Assert failed: cache_for_lease_.Remove(object_id)``造成崩溃的问题
修复了event timeout时，部分资源无法被解除的问题
修复了在Centos中更新DB Schema时，发生崩溃的问题
添加object计数器，将部分计数器变更为object下级
- 原objects已变更为object计数器下级的”object_count”。
- 原outstanding_update_query已变更为object计数器下级。
- 原outstanding_fetch_query已变更为object计数器下级。

System¶

优化了event thread hang checker的性能
优化了event的处理性能
修复了event处理过程中assert造成崩溃的问题
在队列中为事件性能分析添加等待时间(queue_time_xxx)
将事件性能分析的名字wait_time_xxx变更为io_wait_time_xxx
变更事件队列的各个统计项目名称
- completion_xxx``已变更为``execution_time_xxx。
- wait_xxx``已变更为``io_wait_time_xxx。
将event_queue_stat变更为event_profiling_summary
添加event计数器，将部分计数器变更为event下级
- 原event_queue_length已变更为event计数器下级。
- 原event_injection_per_sec已变更为event计数器下级。
- 原event_complete_per_sec已变更为event计数器下级。

Distribution¶

优化了接收非正常RPC消息的异常处理

Framework¶

修复了安装组件的过程中关闭服务器时，无法正常关闭的问题

misc.¶

允许proto文件位于{project}-source/src以外的目录
添加了可以通过字节发送Protobuf会话ID的功能

请参考:ref:`send_session_id_as_string <network-configuration>`选项说明。

v1.0.0-1904 (2016-12-15)¶

2016-12-15 12:07:12

Object¶

修复了object_db_migrator.py工具错误处理部分DB数据的漏洞

v1.0.0-1894 (2016-12-13)¶

2016-12-13 18:29:15

Object¶

修复了object migration工具对没有设置参数值的字段进行错误处理的漏洞

v1.0.0-1890 (2016-12-09)¶

2016-12-09 10:19:05

Object¶

修复了会对object migration工具中提取的文件进行覆盖的问题

v1.0.0-1853 (2016-11-21)¶

2016-11-21 14:45:52

Warning

Breaking changes

需要更新Unity客户端插件的部分如下。
- Multicast: 修复了iOS中发送Protobuf组播消息时客户端崩溃的相关漏洞
  
  使用组播时，一定要使用186以上版本的插件，并且须重新构建Protobuf DLL。

Service¶

Multicast: 修复了iOS中发送Protobuf组播消息时客户端崩溃的相关漏洞

v1.0.0-1849 (2016-11-18)¶

2016-11-18 11:38:03

Distribution¶

修复了Centos中因build选项错误而导致分布式处理功能无法运行的问题

v1.0.0-1841 (2016-11-15)¶

2016-11-15 15:37:02

Warning

Breaking Changes:

因以下变化，须要重新构建服务器。

Session::GetLastReceiveTime(msgtype)添加SendMessage()时调用的hook

Network¶

Session::GetLastReceiveTime(msgtype)添加SendMessage()时调用的hook
HttpClient: 优化为在发生DNS查询问题时，可进行重试

System¶

修复了使用MulticastServer时，”Assert failed: IsValid()”造成崩溃的问题
修复了当在一个event type中注册2个以上event handler时，”Assert failed: IsValid()”造成崩溃的问题

Distribution¶

修复了输出”failed to unpublish”日志时所产生的问题

v1.0.0-1815 (2016-10-28)¶

2016-10-28 16:59:15

Object¶

修复了使用export_db_schema选项时，部分procedure发生drop的漏洞
修复了变更后的Schema无法体现到Insert、Update procedure中的漏洞

v1.0.0-1809 (2016-10-26)¶

2016-10-26 11:48:08

Warning

Breaking Changes:

需要变更代码的部分如下。
- Leaderboard: 删除ScoreSubmissionRequest::kUpdate
  
  须要变更为``ScoreSubmissionRequest::kHighScore``。
- Redis: 删除Command(Async)函数
  
  须要变更为``ExecuteCommand(Async)``函数。
因添加的检测代码而受到影响的部分如下。
- 修复了无法检测到Array、Map Attribute类型变更的漏洞
  
  在服务器运行时，如果变更Array、Map Attribute的类型，服务器会崩溃。
需要更新Unity客户端插件的部分如下。
- AccountManager: 添加了用于客户端跨服移动的消息
  
  当使用跨服移动功能时，必须将插件版本更新到180以上。

Object¶

将”failed to lease”日志的输出次数限制在一定次数以内
变更object的所有权时，通过延迟lease，避免不必要的重试
修复了无法检测到Array、Map Attribute类型变更的漏洞

Service¶

AccountManager: 添加了用于客户端跨服移动的消息
Leaderboard: 删除ScoreSubmissionRequest::kUpdate

Database¶

Redis: 删除Command(Async)函数

Distribution¶

优化了分布式处理相关功能
修复了分布式处理相关ASSERT会造成崩溃的问题
修复了服务器非正常关闭时，RPC无法连接的漏洞
Rpc::SetStatus() 无法体现到正在连接的peer中的问题已被修复

Time¶

为WallClock添加了Timestamp和Timestring转换功能

misc.¶

Document: 添加了客户端移动相关文件
修复了funapi_profile在有多个服务器进程时，无法运行的漏洞

v1.0.0-1797 (2016-10-12)¶

2016-10-12 10:01:11

Management¶

Counter: 添加了concurrent_user计数器

misc.¶

Document: 添加了引擎支持的计数器列表

v1.0.0-1795 (2016-10-11)¶

2016-10-11 09:28:56

Warning

使用ChaCha20、AES128加密时，必须将插件版本更新到176 以上。

Distribution¶

修复了部分zookeeper client在统计中被遗漏的漏洞

Network¶

为Transport encryption添加了ChaCha20 / AES128支持

misc.¶

Document: 更新了C# Runtime测试示例说明
Document: 添加了Zookeeper最大堆内存大小的Java选项设置说明
Document: 添加Zookeeper auto purge选项说明

v1.0.0-1790 (2016-10-05)¶

2016-10-05 16:08:02

Warning

Breaking Changes:

修复了无法检测到可变长度字符串长度变化的漏洞

服务器运行时，会试图更新DB Schema。当DB权限受限时， DB Schema更新会失败，同时服务器会崩溃。此时，可使用:ref:object-subsystem-db-permission`中介绍的``export_db_schema` 选项，通过管理员DB账号更新DB Schema。

Object¶

修复了分布式处理相关ASSERT会造成崩溃的问题
修复了无法检测到可变长度字符串长度变化的漏洞
修复了创建处理object的代码时，python代码中出现的漏洞

v1.0.0-1782 (2016-09-28)¶

2016-09-28 18:30:20

Object¶

修复了Object Fetch相关ASSERT会造成服务器崩溃的漏洞

Service¶

为ClientResourceServce MANIFEST添加遗漏的Curl依赖

misc.¶

Json::Copy() 性能优化

v1.0.0-1777 (2016-09-28)¶

2016-09-28 10:25:56

Distribution¶

修复了暂时无法调取object的漏洞
修复了服务器关闭时，偶尔发生崩溃的问题
修复了服务器开启时，偶尔发生的 Zookeeper连接失败的问题
修复了崩溃后结束的过程中处理不正常的问题
修复了遗漏引擎内部RPC finisher的问题
修复了RPC disconnect handler运行顺序相关漏洞

Object¶

修复了远程服务器关闭时，以较低概率出现的因ASSERT而崩溃的漏洞
修复了分布式处理相关ASSERT会造成崩溃的漏洞
优化了关闭处理

Framework¶

修复了MANIFEST中有注释时，”make check_features”不运行的漏洞
修复了MANIFEST中有注释时，部分IDE开发环境中服务器无法驱动的漏洞

misc.¶

添加了从文件和Stream中读取包含注释在内的JSON的 Json::FromFileWithComments()、Json::FromStreamWithComments()

v1.0.0-1763 (2016-09-22)¶

2016-09-22 18:05:19

Warning

使用ife1、ife2加密时，必须将插件版本更新到176以上。

Network¶

修复了ife1、ife2加密漏洞

v1.0.0-1739 (2016-09-08)¶

2016-09-08 12:27:23

Object¶

修复了object lock downgrade相关漏洞
删除了与Object处理有关的错误ASSERT
修复了特定情况下，事件过度回滚的问题
修复了特定情况下，将相同的object分成不同的lock type进行Fetch时的漏洞
修复了分布式处理相关ASSERT会造成服务器关闭的问题
修复了通过``kReadCopyNoLock``对null object id进行fetch时的漏洞

Distribution¶

修复了处理object时，可能会崩溃的漏洞
删除了与分布式处理有关的错误ASSERT
修复了关闭过程中会崩溃的漏洞

Framework¶

修复了服务器运行中崩溃时，延迟关闭的问题
优化了关闭处理

Management¶

Counter: 添加了计数器值超过threshold时，会输出日志的功能

System¶

Event: 添加了事件队列相关处理时间的统计功能

misc.¶

将固定package版本的方法文件化
Document: Leaderboard: 添加了对排行榜时间表是否已经重置进行查看的功能
Document: 修改了CLion Build设置说明
Document: 修改了积分榜文件中链接乱码问题
将使用外部库的方法文件化
Document: 添加了插件FunapiSession说明

v1.0.0-1694 (2016-08-18)¶

2016-08-18 17:25:42

Object¶

修复了进行Object返回相关处理的过程中出现ASSERT的问题
修复了event timeout处理相关的漏洞
添加了对破碎的Object进行Fetch时，对已遗漏的Zookeeper所有权进行解除的功能

Distribution¶

修复了分布式处理相关的漏洞

v1.0.0-1680 (2016-08-12)¶

2016-08-12 17:04:52

Warning

Breaking Changes:

当升级为已添加了延时更新功能的版本后，须要重新构建服务器。

使用RPC功能时，须要重新构建游戏服务器。（``Rpc::Call()``函数相关）

已变更为使用``String(n)``功能，须重新构建项目。

Object¶

修复了Object ReadLock相关潜在漏洞，并优化了日志的可读性
添加了对Object ID进行SELECT的功能
修复了部分情况下，省略Object Lock检验的问题
优化了Object Lock Table性能
优化了Object Lock Table性能
优化了Object:Array PushBack性能
添加了Database延时更新功能
Distribution: 优化为在``enable_database``未被开启的情况下，也能进行分布式处理
Matchmaking: 优化为在``enable_database``未被开启的情况下，也能进行使用
Multicast: 优化为在``enable_database``未被开启的情况下，也能进行使用
Document: 删除分布式处理、匹配、组播文件中的``enable_database``说明
优化了关闭处理
Object: 修复了无法应用``db_key_string_length``、``db_string_length``变更值的漏洞
Document: 添加或完善了以下项目的说明
- copy_cache_expiration_in_ms
- use_db_stored_procedure
- db_string_length, db_key_string_length
Document: Object: 添加了对新注册的回滚函数进行检测的函数说明
System: Event: 为EventProfiler添加事件等待时间
优化为服务器崩溃时，尽量执行仍未执行的队列后再关闭
Document: 优化了EventProfiler的统计
为event profiler添加了event timeout和object的相关使用数据统计
优化了``kReadCopyNoLock``性能
Object: 添加了各数据库Query处理时间的统计
Object: 修复了不存在数据表DDL的情况下，export_db_schema时崩溃的漏洞
Object: 使对象数据库统计按照write、read进行区分
Document: 为对象数据库统计添加了write、read分类说明
修改为可以按照ORM attribute单独减少String长度
优化了Object的处理性能

Distribution¶

删除不必要的Zookeeper请求
将跨服RPC连接数减少到1个
``Rpc::Call()``函数的返回值由Xid变为void。（解决了以Reply Handler和返回值进行分布式例外处理的问题）
添加跨服自动共享的Status功能
优化了RPC的性能
修复了部分zookeeper operation失败时没有进行重试，而是通过FATAL LOG进行处理的问题
优化为Zookeeper session timeout可以通过MANIFEST进行设置
优化为服务器崩溃时，可更快速地解除对象所有权
Distribution: 添加了Zookeeper相关处理的统计
Document: 添加了Zookeeper性能分析文件
Distribution: 修改为可使用多个ZookeeperClient
Distribution: 添加了各ZookeeperClient的统计
Document: Distribution: 添加了各ZookeeperClient的统计

Database¶

修复了Redis的key或value中有空格时，会失败的漏洞
Redis::Command()、``Redis::CommandAsync()``函数已进行*deprecated*处理。
计划在2016年8月删除，须要替换成新添加的``Redis::ExecuteCommand()``, ``Redis::ExecuteCommandAsync()``函数。
Redis: 修改为连接断线时无需等待，可直接做断线处理
Redis: 修复了在服务器Install阶段使用命令时，Redis被断线处理的问题

Network¶

添加了Session关闭后可以设置成自动关闭所有Transport的功能
将session timeout的默认值由1小时变更为5分钟
添加了可以确认会话是否已经打开的``IsOpened()``函数及文件
修复了``CloseTransport()``之前通过``SendMessage()``发送的消息会无法被传输的漏洞

Service¶

Document: 添加了CrossServerStorage组件
修改为Matchmaking的Progress CB和Match CB可并行执行

Framework¶

修改为允许对MANIFEST.json添加javascript格式的注释
修复了特定情况下崩溃后无法关闭的漏洞

Time¶

修改为Mariadb Connector可支持DateTime、Time、Date类型
Timer: 修复了Timer id可能出现kInvalidTimerId的漏洞

System¶

修改为ResourceManager可支持DateTime、Time、Date类型

misc.¶

Document: Object: 添加了``export_db_schema``选项相关说明
Document: 修改了``Leaderboard:DeleteScoreSync()``函数示例错别字
添加了Mariadb Connector说明
Document: 为billing代理中新添加的选项添加了说明
Document: 修改了MO游戏制作向导错别字
Document: 修复了MO向导示例漏洞
Document: 修改了匹配向导文档
修改为可以对object_model JSON 文件添加注释
Document: 修改了管理游戏服务器->处理企划数据文档中的错误
将更新频道（储存库）的选择方法文件化
在参考手册中添加了``String(n)``类型相关说明
Document: Redis: 添加了``ExecuteCommand()``函数
Document: Redis: 添加了``ZCount``、ZRem
Document: Redis: 添加了``Discard``、Exec、Multi

v1.0.0-1651 (2016-08-02)¶

2016-08-02 15:52:55

Service¶

修改为Matchmaking的Progress CB和Match CB可并行执行

misc.¶

Document: Object: 添加了``export_db_schema``选项相关说明
Document: Leaderboard: 修改了``DeleteScoreSync()``函数示例错别字

v1.0.0-1582 (2016-06-02)¶

2016-06-02 21:56:55

Warning

Breaking Changes:

若想使用Multicast相关更新功能，需要最新版本的插件。

已添加了新的错误代码(ErrorCode) EC_CLOSED，并且须要添加当收到该错误代码时，重新进入频道的处理步骤。为此，须要使用新版本的插件。

Service¶

Multicast: 修改为rpc_enabled: false时，会运行失败
Multicast: 修改了MANIFEST.json说明中的强调位置错误
Multicast: 修复了跨服连接断线时崩溃的漏洞
Authentication: 添加了Nexon Toy
Authenticator: 体现了NexonToy变更的协议
MulticastServer可以返回channel个数和用户数
Service:Multicast: 优化了频道入场和退场时的相关处理
ErrorCode``中已添加了``EC_CLOSED。收到相应error code后，需要重新进入频道。为进行该处理，须要更新到最新的插件版本。
添加了从CDN中获取客户端资源目录的功能
Leaderboard: 修改为排行榜重置日期超期后，可显示下一日期排行榜重置日期超时后，作为L``eaderboardResetSchedule`` Structure member的 upcoming_date_time、next_date_time、``latest_date_time``的值已修改为显示下一重置日期。

Network¶

添加了在multi-thread中访问session context时获取用于同步的mutex功能
删除了TCP连接断线并创建新的连接时所产生的不必要的Assert
修改为``TcpTransportDetachedHandler``运行时，可将session id作为event tag
修复了服务器驱动时以极低概率出现的崩溃漏洞
添加了在不使用session reliability的情况下，直接对TCP、HTTP消息的 sequence number进行检验，从而防止消息重复的sequence number validation功能
添加了让指定时间内未作出ping响应的连接自动断线的功能
添加了为进行服务器测试而连接其他服务器client的功能
优化为可以在各session runtime时，对ping sampling interval、timeout进行变更
修复了创建大量HttpClient时，部分请求失败的漏洞
添加了传输紧急消息的功能
修改为可在引擎中为创建的thread分配名字
优化了通过HTTP收到无效JSON message时的处理
收到无效message时，将通过日志输出message type
添加了HTTP request uri的unescape处理功能

Management¶

添加了对处理ApiService的event tag数进行设置的功能
添加了AppInfo:Compatible client version Set/Get函数
添加了RuntimeConfiguration:AppInfo的compatible client version 当按照如下所示，通过Http GET进行请求后，即可收到compatible client versions。
可通过HTTP POST请求来修改compatible client versions。 HTTP body中通过JSON array type输入版本。（也可以输入空的JSON array。）
添加了RuntimeConfiguration:AppInfo的client_current_version
添加了可以设置ApiService log level的功能
ApiService: 支持非同步处理器的处理

Object¶

将array type getter method变更为const
修复了在已timeout的event中fetch的object在cache过度保持的问题
删除了通过多个key来fetch object时，如有重复的Key就会发生的不必要的assert
优化为DB character set 可以通过MANIFEST进行设置
优化为可以与Object Shard区分开来，从而对Key Shard的连接数进行设置

Framework¶

添加了Manifest加密功能
添加了可以输出许可证信息的功能服务器运行时，若指定``–license``旗标，将通过如下形式输出许可证信息。 License info: {"production":true,"expires":"2017-Dec-31 23:59:59"}

Account¶

Leaderboard:添加了可查看排行榜是否已经重置的功能
若想使用API，必须对Leaderboard代理进行更新。

Time¶

添加了WallClock::FromSec、MonotonicClock::FromSec
修复了服务器关闭处理时在Timer中会发生assert的问题

Distribution¶

添加了5秒内若未发送RPC reply，则显示警告的功能
修改为服务器运行中与Zookeeper服务器连接失败时，会关闭服务器

Database¶

Redis: 修复了以较低概率出现的延时处理漏洞

System¶

修改为使通用event tag(timer, api service handler)不自动继承

Leaderboard¶

Leaderboard: 修复了对是否已经重置进行查看的API相关漏洞

misc.¶

修改了部分韩文参考文档
Document: 修复了让Biller开始服务时的命令语说明错误
修改为创建项目时，可开启所有compile time warning
在component model说明中体现了最新的更新内容
Document: 优化了参考文件中的事件相关说明
Document: 添加了数据包重放攻击屏蔽功能说明
添加了将小型转储更改为核心转储后运行GDB的脚本
修复了通过service执行flavor时，log路径指定错误的漏洞
Document: 更新了插件文件
Document: 更新了服务器测试文件
Document: 添加了插件日志说明
修改为通过local launcher运行时，可支持MANIFEST override
Document: 添加了RuntimeConfiguration文件
Document: 添加了插件调试日志说明
修复了funapi_core_analyze bash script发布被遗漏的问题
添加了事件超时处理器说明
添加了DB权限设置说明
Document: 更新了插件Ping的说明